bedrockstreaming/libyear

There is no license information available for the latest version (2.1.0) of this package.

Forked from https://github.com/ecoAPM/php-libyear

2.1.0 2022-09-12 07:18 UTC

Requires

• php: >=7.4
• ext-json: >=7.4
• composer/semver: ^3.3
• guzzlehttp/guzzle: ^7.3
• wp-cli/php-cli-tools: ^0.11

Requires (Dev)

• mockery/mockery: ^1.4.4
• phpunit/phpunit: 9.5.19

Unknown License

README

A simple measure of dependency freshness

Calculates the total number of years behind their respective newest versions for all dependencies listed in composer.json.

Requirements

• PHP v7.4 or later
• Composer v2

Installation

Recommended: Composer

Run composer global require ecoapm/libyear and make sure your global composer directory is in your $PATH.

Alternatively, composer require --dev ecoapm/libyear will add libyear as a local dev dependency for your current directory's app.

Alternative: PHP Archive (PHAR) File

Download libyear.phar from the latest release, and put it in the current directory, or somewhere in your $PATH to be able to reference it from anywhere.

Windows Users

Note that PHP for Windows does not include CA certificates, so you'll need to install them if you haven't done so already:

1. Download http://curl.haxx.se/ca/cacert.pem to somewhere permanent (PHP's extras directory is a great place)
2. Add curl.cainfo = "[full path to]\cacert.pem" to your php.ini file

Usage

vendor/bin/libyear { path to project } [-q]

(or php path/to/libyear.phar { path to project } [-q] for the PHAR version)

Arguments:

• path to project: required, directory containing composer.json and composer.lock files
• -q: optional, quiet mode will only output libraries which are not up-to-date (that is, where "Libyears Behind" > 0)

Limitations

• Currently only packages listed on Packagist are supported (feel free to submit a PR for issue #1)

Contributing

Please be sure to read and follow ecoAPM's Contribution Guidelines when submitting issues or pull requests.

When testing new features and bug fixes, you can run the script via ./libyear { path } [-q] before building the phar file.

To build the phar file for final manual testing, run php -dphar.readonly=0 build.php. You may wish to run composer install --no-dev first to speed up the build process by removing dev dependencies, but will need to reinstall them via composer install (specifically, phpunit and mockery for unit testing).