liborm85/composer-vendor-cleaner

Composer Vendor Cleaner removes unnecessary development files and directories from vendor directory.

1.7.1 2023-06-02 14:36 UTC

Requires

• php: >=5.6.0
• composer-plugin-api: ^1.1 || ^2.0
• ext-json: *

Requires (Dev)

• composer/composer: ^1.10.23 || ^2.1.9
• phpunit/phpunit: ^5.7 || ^6.5 || ^7.5 || ^8.4 || ^9.1

MIT

• Libor M.

• php
• composer
• delete
• cleanup
• remove
• composer-plugin
• cleaner
• ignore
• .gitattributes

README

This composer plugin removes unnecessary development files and directories from vendor directory.

Installation

Local installation to project:

composer require liborm85/composer-vendor-cleaner

Global installation:

composer global require liborm85/composer-vendor-cleaner

Requirements

• PHP 5.6.0+

Configuration

Development files and directories to remove can be defined in composer.json file in extra data attribute per new key dev-files. Glob pattern syntax is fully supported.

Example:

"extra": {
    "dev-files": {
        "/": [                  // means: find in all library packages directories and bin directory
            "tests/",           // means: tests directory whatever
            "docs/",
            ".travis.yml"       // means: .travis.yml file whatever
        ],
        "*/*": [                // means: find in all library packages directories, but NOT in bin directory
            "*.sh"
        ],
        "bin": [                // means: find in composer bin directory
            "*.bat"
        ],
        "twig/twig": [          // means: find only in twig/twig package directory
            "doc/",
            "/drupal_test.sh"   // means: only file in root directory of twig/twig package
        ],
        "symfony/*": [          // means: find in all symfony packages
            "Tests/"
        ],
        "other/package": [
            "/src/**/*.md"      // means: find whatever all md files in src directory, eg.: /src/dir1/test.md, /src/dir1/dir2/readme.md
        ],
        "example/package": [    // means: remove all files and directories in language directory without cs.php file
            "languages/*",
            "!languages/cs.php" // means: exclude cs.php file from remove
        ]
    }
}

Development files and directories can also be defined in an external json file, by specifying the relative path to this file in the dev-files key in the root composer.json. The format is the same as above.

"extra": {
    "dev-files": "composer.dev-files.json"
}

Example of composer.dev-files.json file:

{
  "/": [
    ".github/"
  ],
  "twig/twig": [
    "doc/"
  ]
}

For additional configuration can be used config attribute.

• match-case (default: true) - Match case of name files and directories.
• remove-empty-dirs (default: true) - Removes empty directories.
• no-dev-only (default: false) - If is set true start the cleanup only if the composer command is run with --no-dev.

Example:

"config": {
    "dev-files": {
        "match-case": false,
        "remove-empty-dirs": false
    }
}

Why a new plugin?

Some composer packages contain files and directories that do not belong to production servers, but composer does not solve this.

Exists a lot of plugins for composer trying to solve this issue, they don't have advanced patterns to filtering or they are not user definable. Or some have no configuration and it works automatically and delete almost everything and then the package does not work.

That's why I created a new one that allows advanced filtering by glob patterns.

If you miss a feature or find bug, please, create an issue.

License

MIT