Merge pull request #94 from triplepoint/feature/ci_modernization

Feature/ci modernization

Author: triplepoint

.github/workflows/php.yml

@@ -0,0 +1,50 @@
+name: PHP Composer
+
+on:
+  push:
+  pull_request:
+    branches: [ "master" ]
+
+permissions:
+  contents: read
+
+jobs:
+  run:
+    runs-on: ${{ matrix.operating-system }}
+    strategy:
+      fail-fast: false
+      matrix:
+        operating-system: [ubuntu-latest]
+        php-versions:
+          - '7.4'
+          # - '8.0'
+          # - '8.1'
+          # - '8.2'
+          # - '8.3'
+          # - '8.4'
+
+    name: PHP ${{ matrix.php-versions }} Test on ${{ matrix.operating-system }}
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v4
+
+    - name: Install PHP
+      uses: shivammathur/setup-php@v2
+      with:
+        php-version: ${{ matrix.php-versions }}
+
+    - name: Check PHP Version
+      run: php -v
+
+    - name: Validate composer.json and composer.lock
+      run: composer validate --strict
+
+    - name: Install dependencies
+      run: composer install --prefer-dist --no-progress
+
+    - name: Run lint check
+      run: composer run-script lint
+
+    - name: Run test suite
+      run: composer run-script test

.gitignore

@@ -22,6 +22,3 @@ Desktop.ini
 ## From https://github.com/github/gitignore
 ### SASS Ignores - "Sassy CSS" http://sass-lang.com/
 *.sass-cache
-
-# Vagrant files
-/.vagrant/

.travis.yml

@@ -0,0 +1,13 @@
+FROM php:7.4-cli
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    curl \
+    unzip \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin && ln -s /usr/local/bin/composer.phar /usr/local/bin/composer
+
+RUN git config --global --add safe.directory /project
+
+WORKDIR /project

Dockerfile

@@ -286,37 +286,14 @@ The workflow for this repository goes as follows:
 End users of this repository should only use tagged commits in production.  Users interested in the current 'soon-to-be-released' code may use `master`, with the understanding that it may change unexpectedly.  All other existing branches (if any) should be considered 'feature' branches in development, and not yet ready for use.
 
 ### Local Testing Environment
-There's a Vagrant virtual machine configuration included which is suitable for running the necessary unit tests.  To bring up the machine, make sure you have Vagrant and Virtualbox installed, and from the project root directory:
+There's a `Dockerfile` and a set of helper scripts in `scripts/` suitable for running the necessary unit tests.  With Docker installed, do:
 
+``` shell
+# Execute the lint checks
+./script/lint
 
-``` bash
-vagrant up
-vagrant ssh
-cd /project
+# Execute the unit tests
+./script/test
 ```
 
-### Setting Up for Testing
-The virtual machine development environment already has Composer installed.  Once you're ssh'ed into the virtual machine, install this project's dev dependencies:
-
-``` bash
-rm -rf vendor
-composer.phar update --verbose --prefer-dist
-```
-
-### Unit Tests
-All the tests associated with this project can be manually run with:
-
-``` bash
-vendor/bin/phpunit -c ./tests/phpunit.xml.dist ./tests
-```
-
-### CodeSniffer
-Codesniffer verifies that coding standards are being met.  Once the project is built with development dependencies, you can run the checks with:
-
-``` bash
-vendor/bin/phpcs --encoding=utf-8 --extensions=php --standard=./tests/phpcs.xml -nsp ./
-```
-
-### Continuous Integration
-The above tests are automatically run against Github commits with Travis-CI.
-- https://travis-ci.org/PhpUnitsOfMeasure/php-units-of-measure
+In addition, `./script/shell` will get you a bash shell in a temporary container.  Note that the hosts directory is mounted into the container, and changes to files inside the container will persist.

README.md

@@ -1,52 +1,45 @@
 {
-    "name":        "php-units-of-measure/php-units-of-measure",
-
+    "name": "php-units-of-measure/php-units-of-measure",
     "description": "A PHP library for converting between standard units of measure.",
-
     "keywords": [
-         "measurements", "data", "conversion"
-     ],
-
-    "homepage":    "https://github.com/PhpUnitsOfMeasure/php-units-of-measure",
-
+        "measurements",
+        "data",
+        "conversion"
+    ],
+    "homepage": "https://github.com/PhpUnitsOfMeasure/php-units-of-measure",
     "license": "MIT",
-
     "authors": [
         {
-            "name":     "Jonathan Hanson",
-            "email":    "[email protected]",
-            "homepage": "http://www.jonathan-hanson.org/",
-            "role":     "Developer"
+            "name": "Jonathan Hanson",
+            "role": "Developer"
         }
     ],
-
     "support": {
-        "email":  "[email protected]",
         "issues": "https://github.com/PhpUnitsOfMeasure/php-units-of-measure/issues",
         "source": "https://github.com/PhpUnitsOfMeasure/php-units-of-measure"
     },
-
     "require": {
-        "php": ">=5.5.0"
+        "php": ">=7.4.0"
     },
-
     "require-dev": {
-        "phpunit/phpunit":           "4.8.*",
-        "squizlabs/php_codesniffer": "2.8.1"
+        "phpunit/phpunit": "5.*",
+        "squizlabs/php_codesniffer": "3.7.2"
     },
-
     "replace": {
         "triplepoint/php-units-of-measure": "*"
     },
-    
     "autoload": {
         "psr-4": {
             "PhpUnitsOfMeasure\\": "source/"
         }
     },
     "autoload-dev": {
         "psr-4": {
-             "PhpUnitsOfMeasureTest\\": "tests/"
+            "PhpUnitsOfMeasureTest\\": "tests/"
         }
+    },
+    "scripts": {
+        "test": "phpunit -c ./tests/phpunit.xml.dist ./tests",
+        "lint": "phpcs --encoding=utf-8 --extensions=php --standard=./tests/phpcs.xml -nsp ./"
     }
 }

Vagrantfile

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -e
+
+docker build -t "php-units-of-measure:dev" .
+docker run -it --rm -v `pwd`:/project "php-units-of-measure:dev" composer run-script lint

composer.json

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -e
+
+docker build -t "php-units-of-measure:dev" .
+docker run -it --rm -v `pwd`:/project "php-units-of-measure:dev" bash

scripts/lint

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -e
+
+docker build -t "php-units-of-measure:dev" .
+docker run -it --rm -v `pwd`:/project "php-units-of-measure:dev" composer run-script test