Merge pull request #91 from Chris53897/feature/modernise

feat: modernise, drop support for php < 7.4, migrate tests and config…

Author: triplepoint

.github/workflows/ci.yaml

@@ -1,50 +1,57 @@
-name: PHP Composer
+# .github/workflows/code_checks.yaml
+name: Code_Checks
 
-on:
-  push:
-  pull_request:
-    branches: [ "master" ]
-
-permissions:
-  contents: read
+on: ["push", "pull_request"]
 
 jobs:
-  run:
-    runs-on: ${{ matrix.operating-system }}
+  tests:
+    runs-on: ubuntu-latest
     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 }}
-
+        php: ['7.4']
+        stability: [ prefer-stable ]
+        experimental: [false]
+        include:
+          - php: '7.4'
+            stability: prefer-lowest
+          - php: '8.0'
+          - php: '8.1'
+          - php: '8.2'
+          - php: '8.3'
+
+    name: PHP ${{ matrix.php }} - ${{ matrix.stability }} tests
     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
+      # basically git clone
+      - uses: actions/checkout@v4
+
+      - name: Cache dependencies
+        uses: actions/cache@v3
+        with:
+          path: ~/.composer/cache/files
+          key: dependencies-php-${{ matrix.php }}-composer-${{ hashFiles('composer.json') }}
+
+      # use PHP of specific version
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          extensions: pcov
+          coverage: pcov
+
+      - name: Install dependencies
+        run: |
+          composer install --verbose --prefer-dist --no-interaction -o
+
+      - name: Execute tests
+        run: composer run-script test
+
+  cs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.2
+          coverage: none # disable xdebug, pcov
+      - run: composer install --no-progress
+      - run: composer run-script lint

.gitignore

@@ -22,3 +22,6 @@ Desktop.ini
 ## From https://github.com/github/gitignore
 ### SASS Ignores - "Sassy CSS" http://sass-lang.com/
 *.sass-cache
+
+.phpunit.result.cache
+tests/clover.xml

CHANGELOG.md

@@ -1,3 +1,7 @@
+## v2.2.0 (xxx)
+
+- Drop support of php < 7.4
+
 ## v2.1.0 (July 24th, 2016)
 - Added getUnitDefinitions() method to PhysicalQuantity classes, to get a raw list of UnitofMeasure objects defined on that quantity
 - Added UPPERCASE templating support for autogenerated metric units to support names like MEGA_METERS, for example.

README.md

@@ -43,17 +43,17 @@ isTooTallToRideThisTrain( new Length(2, 'm') );
 ```
 
 ## Installation
-This library is best included in your projects via Composer.  See the [Composer website](http://getcomposer.org/) for more details, and see the [Packagist.org site for this library](https://packagist.org/packages/php-units-of-measure/php-units-of-measure).
+This library is best included in your projects via Composer.  See the [Composer website](https://getcomposer.org/) for more details, and see the [Packagist.org site for this library](https://packagist.org/packages/php-units-of-measure/php-units-of-measure).
 
-If you'd prefer to manually include this library as a dependency in your project, then it is recommended that you use a [PSR-4](http://www.php-fig.org/psr/psr-4/) compliant PHP autoloader.  The mapping between this project's root namespace and its base directory is:
+If you'd prefer to manually include this library as a dependency in your project, then it is recommended that you use a [PSR-4](https://www.php-fig.org/psr/psr-4/) compliant PHP autoloader.  The mapping between this project's root namespace and its base directory is:
 - vendor namespace 'PhpUnitsOfMeasure\' maps to the library's base directory 'source/'
 
 See the documentation of your autoloader for further instructions.
 
 ### Project Tags and Versions
-This project follows the guidelines set out in [Semantic Versioning 2.0.0](http://semver.org/spec/v2.0.0.html).  In general, versions are of the form 'X.Y.Z', and increments to X denote backward-incompatible major changes.
+This project follows the guidelines set out in [Semantic Versioning 2.0.0](https://semver.org/spec/v2.0.0.html).  In general, versions are of the form 'X.Y.Z', and increments to X denote backward-incompatible major changes.
 
-It is recommended that if your project includes this project as a dependency and you are using an automated dependency management tool such as [Composer](http://getcomposer.org/), then you should 'pin' the major version (X) and allow only variations in 'Y' (minor changes) and 'Z' (bugfixes).  See the documentation of your dependency manager for more details.
+It is recommended that if your project includes this project as a dependency and you are using an automated dependency management tool such as [Composer](https://getcomposer.org/), then you should 'pin' the major version (X) and allow only variations in 'Y' (minor changes) and 'Z' (bugfixes).  See the documentation of your dependency manager for more details.
 
 
 ## Use
@@ -239,7 +239,7 @@ class Length extends AbstractPhysicalQuantity
 Now any program which uses `Length` will start with the cubits unit already built in.  Note that here we used the more concise linear unit factory method, but the result is equivalent to the expanded form calling the `UnitOfMeasure` constructor, as used above.  Also, notice that the `static` keyword was used instead of the class name, though either would be acceptable in this case.
 
 ### Adding New Physical Quantities
-[Physical quantities](http://en.wikipedia.org/wiki/Physical_quantity) are categories of measurable values, like mass, length, force, etc.
+[Physical quantities](https://en.wikipedia.org/wiki/Physical_quantity) are categories of measurable values, like mass, length, force, etc.
 
 For physical quantities that are not already present in this library, it will be necessary to write a class to support a new one.  All physical quantities implement the `\PhpUnitsOfMeasure\PhysicalQuantityInterface` interface, typically extend the `\PhpUnitsOfMeasure\AbstractPhysicalQuantity` class, and typically have only an `initialize()` method which creates the quantity's units of measure.  See above for typical examples of physical quantity classes and of how to add new units to a quantity class.
 

composer.json

@@ -19,11 +19,11 @@
         "source": "https://github.com/PhpUnitsOfMeasure/php-units-of-measure"
     },
     "require": {
-        "php": ">=7.4.0"
+        "php": ">=7.4"
     },
     "require-dev": {
-        "phpunit/phpunit": "5.*",
-        "squizlabs/php_codesniffer": "3.7.2"
+        "phpunit/phpunit":           "^9.5",
+        "squizlabs/php_codesniffer": "^3.7"
     },
     "replace": {
         "triplepoint/php-units-of-measure": "*"