README

moxio/captainhook-yarn-deduplicate

This project is a plugin for CaptainHook to check your yarn.lock file for duplicate packages using yarn-deduplicate. The commit is blocked when one or more duplicate packages are found. You can then fix these manually by running yarn-deduplicate.

Installation

Install as a development dependency using composer:

$ composer require --dev moxio/captainhook-yarn-deduplicate

Usage

Add yarn-deduplicate validation as a pre-commit to your captainhook.json configuration file:

{
    "pre-commit": {
        "enabled": true,
        "actions": [
            {
                "action": "\\Moxio\\CaptainHook\\YarnDeduplicate\\YarnDuplicationCheckAction"
            }
        ]
    }
}

The check is only run when committing changes to yarn.lock. It will thus not detect pre-existing duplications as long as there are no changes to the Yarn lockfile.

The action expects yarn-deduplicate to be installed as a local NPM package (i.e. available at node_modules/.bin/yarn-deduplicate).

Conditional usage

If you want to perform duplication checks only when yarn-deduplicate is installed (i.e. available at node_modules/.bin/yarn-deduplicate), you can add a corresponding condition to the action:

{
    "pre-commit": {
        "enabled": true,
        "actions": [
            {
                "action": "\\Moxio\\CaptainHook\\YarnDeduplicate\\YarnDuplicationCheckAction",
                "conditions": [
                    {
                        "exec": "\\Moxio\\CaptainHook\\YarnDeduplicate\\Condition\\YarnDeduplicateInstalled"
                    }
                ]
            }
        ]
    }
}

This may be useful in scenarios where you have a shared CaptainHook configuration file that is included both in projects that use yarn-deduplicate and projects that don't. If yarn-deduplicate is installed, the action is run. In projects without yarn-deduplicate, the validation is skipped.

Versioning

This project adheres to Semantic Versioning.

Contributing

Contributions to this project are welcome. Please make sure that your code follows the PSR-12 extended coding style.

License

This project is released under the MIT license.