Download the PHP package mhujer/yaml-sort-checker without Composer
On this page you can find all versions of the php package mhujer/yaml-sort-checker. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download mhujer/yaml-sort-checker
More information about mhujer/yaml-sort-checker
Files in mhujer/yaml-sort-checker
Package yaml-sort-checker
Short Description YAML sort checker checks if your YML files are properly sorted to prevent merge conflicts
License MIT
Homepage https://github.com/mhujer/yaml-sort-checked
Informations about the package yaml-sort-checker
YAML file sort checker
This library helps you to keep YAML file sorted to prevent unnecessary merge conflicts.
Check out the article I've written about the tool: Keep your YAML files sorted with YAML sort checker
Typical example is when two developers register a new service in services.yml
. If they both add it to the end, it unevitably will lead to a merge conflict. However, when the services are alphabetically sorted, the probability of merge conflict is much lower (because the added services probably won't clash).
Usage
- Install the latest version with
composer require --dev mhujer/yaml-sort-checker
- Create a configuration file
yaml-sort-checker.yml
in project root with list of the files for checking, see the example configuration for Symfony app. - Run
vendor/bin/yaml-sort-checker
(depends on where you have your Composer bin directory) - Exclude the yaml keys (or even whole sections) you don't want to sort - e.g. it makes more sense to have them unsorted (see the example configuration)
PHPStorm Integration
Until WI-35271 is resolved, YAML sort checker can be integrated into PHPStorm by using File Watcher feature.
- Open Settings -> Tools -> File Watchers
- Add new
- File type:
YAML
- Program:
PATH_TO_YOUR_PROJECT\vendor\bin\yaml-sort-checker.bat
- Open Other Options and enter:
$ProjectFileDir$
to Working directory - Now, when you are editing YAML files, it will run the checker on every file save and will open the console if there are errors
Requirements
Works with PHP 7.2 or higher and Symfony 3.4 or higher.
Submitting bugs and feature requests
Bugs and feature request are tracked on GitHub
Author
Changelog
See CHANGELOG.md for latest changes.
All versions of yaml-sort-checker with dependencies
symfony/console Version ~3.4|~4.3|~5.0
symfony/yaml Version ~3.4|~4.3|~5.0