nfreear/composer-suggest

Composer plugin to install a custom group of suggested packages, based on keyword patterns. ' vi .env && composer install '

![Latest Stable Version][packagist-icon] , _(*1)

composer-suggest

A Composer plugin to install a custom group of suggested packages, based on keyword patterns. (_Caution_), _(*2)

Example composer.json:, _(*3)

{
    "suggest": {
      "a/b": "1.0; This package is for [LACE] only",
      "c/d": "2.1, This package is for JuxtaLearn and LACE.",
      "e/f": "3.2, This is just for [JXL].",
      "g/h": "1.0-beta; Experiment-A"
    }
}

Usage

1. Set an environment variable containing a pattern/keywords in a .env file,, _(*4)

   echo 'NF_COMPOSER_SUGGEST="(EXP|LACE)"' > .env
   

2. Require the plugin,, _(*5)

   composer require nfreear/composer-suggest
   

3. Install as you would normally (verbose),, _(*6)

   composer -vvv install
   

Legacy

In Composer script mode, an example composer.json might contain:, _(*7)

{
    "suggest": {
      "a/b": "1.0; This package is for [LACE] only",
      "c/d": "2.1, This package is for JuxtaLearn and LACE.",
      "e/f": "3.2, This is just for [JXL].",
      "g/h": "1.0-beta; Experiment-A"
    },

    "scripts": {
      "dry-run-suggest": "\\Nfreear\\Composer\\Suggest::dryRun",
      "install-suggest": "\\Nfreear\\Composer\\Suggest::install",
      "install-lace": "./vendor/bin/suggest --dry LACE"
    }
}

Legacy usage:, _(*8)

>  composer -v install-lace

Legacy advanced usage:, _(*9)

>  composer -v dry-run-suggest "Ju?X(ta)?L"    # Packages suggested for 'Juxtalearn' & 'JXL'.
>  composer -v dry-run-suggest "Experiment-A"

Test

composer test

Caution

Use of the composer-suggest plugin implies that you probably won't commit composer.lock to version control. Various people say this is bad, and as a general rule they are probably correct., _(*10)

Composer-suggest works well when all/most of the dependencies in require and suggest have precise version constraints (1.2.3) as opposed to loose ones (1.*, >= 1.5..). It is also useful during rapid development phases of a project. See it in use in the LACE/ OER Research Hub code, and Open Media Player code-base., _(*11)

Caveat utilitor!, _(*12)

Developed for the LACE Evidence Hub, part of the Learning Analytics Community Exchange project., _(*13)

Inspired by and based in part on the composer-merge-plugin – thank you!, _(*14)

License: MIT, _(*15)

© 2016 The Open University. (Institute of Educational Technology), _(*16)