Download the PHP package exoticca/yaml-sort-checker without Composer
On this page you can find all versions of the php package exoticca/yaml-sort-checker. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download exoticca/yaml-sort-checker
More information about exoticca/yaml-sort-checker
Files in exoticca/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/exoticcaengineering/yaml-sort-checker
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 exoticca/yaml-sort-checker - Create a configuration file
yaml-sort-checker.ymlin 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 8.3 or higher and Symfony 3.4 or higher.
Optional Configuration
case-sensitive
true - sort checker will expect upercase to be placed before lowercase
false - sort checker will ignore casing (default value)
Development
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|~6.0
symfony/yaml Version ~3.4|~4.3|~5.0|~6.0

