xylemical/composer-discovery

Provides a composer plugin for discovery of items within packages.

Maintainers

Details

github.com/xylemical/composer-discovery

Homepage

Source

Issues

Installs: 5

Dependents: 1

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

Type:composer-plugin

dev-master 2022-06-30 05:52 UTC

Requires

  • php: >=8.0
  • composer-plugin-api: ^2.0

Requires (Dev)

MIT 9797a49e67f42e72ee6edbb25390ed147d12bbd0

composer-plugindiscovery

This package is auto-updated.

Last update: 2025-03-29 01:14:23 UTC

README

Provides composer with a way to perform discovery processes.

Install

The recommended way to install this library is through composer.

composer require xylemical/composer-discovery

Usage

Once a discovery process has been defined in a package, any package or project that requires the package will have the discovery applied.

Adding a discovery is as simple as defining the discovery class in the extra key of the composer.json file:

{
  "extra": {
    "discovery": [
      "My\\Discovery"
    ]
  }
}

An example discovery that prints out all the package readme files is as follows:

namespace My;

use Xylemical\Composer\Discovery\ComposerDiscoveryBase;

/**
 * Performs output of README.md for any package that defines it.
 */
class Discovery extends ComposerDiscoveryBase {

  /**
   * {@inheritdoc}
   */
  public function getName(): string {
    return 'My Discovery';
  }

  /**
   * {@inheritdoc}
   */
  public function discover(Package $package): void {
    $path = $package->getPath() . '/README.md';
    if (file_exists($path)) {
      $this->io->write(file_get_contents($path));
    }
  }

}

License

MIT, see LICENSE.