PackageVersions

This release increases the minimum supported version of composer to v2 (currently in alpha,
but you should REALLY try it out).

By doing so, the code has been massively reduced, and a few relevant bugs around the detected
installed package versions have been squished in the process.

In order to upgrade, you must first have composer v2 installed, which you can get by runnning
its self-update tooling: composer self-update --2.

You can look at the in-depth thought-process behind this patch at https://www.twitch.tv/videos/640893205

Total issues resolved: 5

• 90: Test psalm annotations against a happy path/unhappy path static analysis test suite thanks to @Ocramius
• 116: FallbackVersions uses this package lock which breaks version checks thanks to @scaytrase
• 117: Expose and fix fallback versions thanks to @scaytrase
• 135: Drop support for Composer 1.x once stable thanks to @Ocramius
• 146: Rewrote package to use composer-runtime-api:^2.0 and no longer keep an internal generated map thanks to @Ocramius

This release allows ocramius/package-version to skip writing the Version class when the
vendor directory is locked/not writable.

Total issues resolved: 2

• 136: PHPUnit update - use better assertion names, remove deprecations thanks to @michalbundyra
• 144: Skip generation of version classes in case when install path is not writable thanks to @0x450x6c

This release adds forward-compatibility for composer/composer:2.0.0.

Total issues resolved: 1

• 133: Add support for Composer 2.x thanks to @Seldaek

This release adds @psalm-pure to the generated version of
PackageVersions\Versions. Please note that if you run your
composer installation with --no-scripts and --no-plugins, then the fallback
version of PackageVersions\Versions will be in use, and
therefore purity is not guaranteed.

Total issues resolved: 1

• 120: Ensure that, when generated, PackageVersions\Versions::getVersion() is @psalm-pure thanks to @Ocramius

This release upgrades dependencies, improves testing/static analysis checks, and moves
the package to PHP 7.4 as a minimum required engine version.

Total issues resolved: 4

• 111: Update .gitattributes thanks to @reedy
• 114: Travis CI config - PHP 7.4 stable builds thanks to @michalbundyra
• 115: Allow using internal/deprecated symbols, but only in the test suite thanks to @Ocramius
• 118: Upgrade dependencies, minimum PHP version upgraded to 7.4 thanks to @Ocramius

Total issues resolved: 1

• 113: Fix incorrect lookup path for installed.json thanks to @ArondeParon

This release ports the ability to rely on installed.json when composer.json is not available
to the stable 1.4.x branch.

Total issues resolved: 1

• 112: Backport #82 to 1.4 thanks to @Jean85

This release fixes an issue leading FallbackVersions (used when installing with
--no-scripts) to fail to detect composer.lock or installed.json locations
due to getcwd() misbehavior during composer installation.

Total issues resolved: 2

• 101: Cannot locate composer.lock nor installed.json when using package with --no-scripts thanks to @PhilETaylor
• 102: #101 corrected scanned locations for installed.json and composer.json thanks to @Ocramius

This release improves discovery of versions when composer.lock cannot be
located, falling back to installed.json (which is at a fixed relative filesystem
location).

We removed duplicate plugin runs during install/update, and runs
the plugin only during the POST_AUTOLOAD_DUMP event.

The minimum supported PHP version is now PHP 7.3.0.

PHP 7.4 compatibility issues with ReflectionType#__toString() have been fixed.

Static analysis additions will also now start highlighting issues in downstream
projects using vimeo/psalm (at build-time) when non-existing dependency
lookups are performed against PackageVersions\Versions::getVersion(), preventing
useless runtime exceptions.

Total issues resolved: 12

• 81: added docs to Versions::VERSION thanks to @staabm
• 82: Use vendor/composer/installed.json and fallback to using composer.lock thanks to @9ae8sdf76
• 83: Update to doctrine/coding-standard v6.0.0 thanks to @carusogabriel
• 87: Added experimental github sponsorship/funding links through tidelift thanks to @Ocramius
• 88: Simplify autoloader notes thanks to @weshooper
• 89: Provide @psalm-param key-of<self::VERSIONS> type-check for downstream thanks to @Ocramius
• 91: dump the version class on composer dump-autoload thanks to @staabm
• 92: Failures on PHP 7.4 build due to ReflectionType#__toString() deprecations thanks to @Ocramius
• 93: updated dependencies thanks to @staabm
• 95: the POST_AUTOLOAD_DUMP event also happens on composer install/update thanks to @staabm
• 96: #90 add psalm static analysis tests thanks to @Ocramius
• 99: Bumped dependencies, dropped PHP 7.2.0 support, simplified build matrix thanks to @Ocramius

This release makes writes to the Version class file atomic,
and makes sure that access rights/flags are also correctly set when
the versions are being generated.

Total issues resolved: 6

• 65: Use Doctrine Coding Standard thanks to @Majkl578
• 69: write VersionClass atomic thanks to @SimonHeimberg
• 70: Replaced packagist pre-release with tidelift badge thanks to @Ocramius
• 75: Added professional support notes thanks to @Ocramius
• 78: Test against PHP 7.3 and 7.4snapshot, drop nightly thanks to @Majkl578
• 79: Fixed writeVersionClassToFile if file already exists and not writable thanks to @SLaVeZ

In this release:

• Support for self.version and replace composer settings and constraints,
  which are now correctly considered and substituted with their actual versions.
• A new PackageVersions\Versions::ROOT_PACKAGE_NAME constant, which is
  populated with the name of the root package, if available.
• Dropped support for PHP 7.0: please upgrade to PHP 7.1
• Improved mutation testing

Total issues resolved: 5

• 55: Consider adding Versions::getRootPackageVersion() thanks to @rybakit
• 56: Expose root package name thanks to @rybakit
• 57: Support Composers "replaces" config, important for CI in mono repos thanks to @ostrolucky
• 58: Bump dependencies, improve mutation testing thanks to @Ocramius
• 59: Parse self.version in replaced packages thanks to @Jean85

This release was tested against PHP 7.2, improves the CI and testing setup
and improves the displayed version for the root package by using the package
pretty version rather than an unresolved one.

Total issues resolved: 5

• 49: Update to PHPUnit 6 thanks to @carusogabriel
• 50: Add PHP 7.2 to Travis matrix thanks to @Jean85
• 51: Uniform version style for root package thanks to @Jean85
• 52: Root package version show normalized in a version-branch thanks to @Jean85

This release fixes a bug that caused PackageVersions to prevent
the composer remove and composer update commands to fail when
this package is removed.

In addition to that, mutation testing has been added to the suite,
ensuring that the package is accurately and extensively tested.

Total issues resolved: 3

• 40: Mutation testing, PHP 7.1 testing thanks to @Ocramius
• 41: Removing this package on install results in file access error thanks to @Xerkus
• 46: #41 Avoid issues when the package is scheduled for removal thanks to @Jean85

This release fixes a bug that caused PackageVersions to be enabled
even when it was part of a globally installed package.

Total issues resolved: 3

• 35: remove all temp directories
• 38: Interferes with other projects when installed globally
• 39: Ignore the global plugin when updating local projects

This release removes the "files" directive from
composer.json,
as it is no longer needed for composer install --classmap-authoritative.
Also, that directive was causing issues with HHVM installations, since
PackageVersions is not compatible with it.

Total issues resolved: 1

• 34: Fatal error during travis build after update to 1.1.0

This release introduces support for running composer install --classmap-authoritative
and composer install --no-scripts. Please note that performance
while using these modes may be degraded, but the package will
still work.

Additionally, the package was tuned to prevent the plugin from
running twice at installation.

Total issues resolved: 10

• 18: Fails when using composer install --no-scripts
• 20: CS (spacing)
• 22: Document the way the require-dev section is treated
• 23: Underline that composer.lock is used as source of information
• 27: Fix incompatibility with --classmap-authoritative
• 29: mention optimize-autoloader composer.json config option in README
• 30: The version class is generated twice during composer update
• 31: Remove double registration of the event listeners
• 32: Update the usage of mock APIs to use the new API
• 33: Fix for #18 - support running with --no-scripts flag

This release includes a fix/workaround for composer/composer#5237, which causes ocramius/package-versions to sometimes generate a Versions class with malformed name (something like Versions_composer_tmp0) when running composer require <package-name>.

Total issues resolved: 2

• 16: Workaround for composer/composer#5237 - class parsing
• 17: Weird Class name being generated

This release fixes an issue related to concurrent autoloader re-generation caused by multiple composer plugins being installed. The issue was solved by removing autoloader re-generation from this package, but it may still affect other packages.

It is now recommended that you run composer dump-autoload --optimize after installation when using this particular package.
Please note that composer (install|update) -o is not sufficient to avoid autoload overhead when using this particular package.

Total issues resolved: 1

• 15: Remove autoload re-dump optimization

This release fixes issues related to installing the component without
any dev dependencies or with packages that don't have a source or dist
reference, which is usual with packages defined directly in the
composer.json.

Total issues resolved: 3

• 11: fix composer install --no-dev PHP7
• 12: Packages don't always have a source/reference
• 13: Fix #12 - support dist and missing package version references

This release fixes an issue related with composer updates to already installed versions. Using composer require within a package that already used ocramius/package-versions caused the installation to be unable to write the PackageVersions\Versions class to a file.

Total issues resolved: 6

• 2: remove unused use statement
• 3: Remove useless files from dist package
• 5: failed to open stream: phar error: write operations disabled by the php.ini setting phar.readonly
• 6: Fix/#5 use composer vendor dir
• 7: Hotfix - #5 generate package versions also when in phar context
• 8: Versions class should be ignored by VCS, as it is an install-time artifact