Tool to detect extended core modules and to update composer.json constraints from using ^ (caret) to using ~ (tilde) for those extended modules.
- Extended API and non-API classes.
- Extended ModuleDependencyProvider.
- Extended ModuleConfig.
composer require --dev spryker-sdk/composer-constrainer
This is a development only "require-dev" module. Please make sure you include it as such.
Add the console command SprykerSdk\Zed\ComposerConstrainer\Communication\Console\ComposerConstraintConsole to your Pyz\Zed\Console\ConsoleDependencyProvider::getConsoleCommands() stack.
Spryker OS is modular and follows SemVer. Every BC-breaking change of module API (https://documentation.spryker.com/api/definition-api.htm) is considered as a major release. But what happens to non-API? Spryker leverages the ability to change non-API functionality in minor and patch releases. This way Spryker provides new features for different business verticals.
What does it mean for my customized modules?
When you customized Spryker modules (changed module behavior on project level) even minor changes could potentially cause migration efforts.
To avoid such cases and keep project updates safe and predictable a project should use ~ (tilde) composer constraint instead of ^ for modules with changed behavior.
And to simplify the process Spryker provides a development command vendor/bin/console code:constraint:modules, which will suggest required changes in composer.json.
It can also auto-adjust your composer.json.
vendor/bin/console code:constraint:modules -d
With this command no changes will be made to the composer.json.
Use -v to see version details.
The return code of this command is either 0 (success) or 1 (error, some constraints need to be changed).
This is the recommended hook for your CI system.
vendor/bin/console code:constraint:modules
This command will change the project's composer.json.
Please dry-run the command before you apply any changes.