/colcon-mixin-repository

Primary LanguagePythonCreative Commons Zero v1.0 UniversalCC0-1.0

Repository of CLI mixins

Various command line options are tedious to write and/or difficult to remember. To make common command line options easier to invoke this repository makes these "shortcuts" available, e.g. for the command line tool colcon.

How to fetch the information

To register this repository with colcon (using the identifier "default") invoke the following command:

colcon mixin add default https://raw.githubusercontent.com/colcon/colcon-mixin-repository/master/index.yaml

Afterwards as well as on a regular base fetch the latest content from the repository:

colcon mixin update default

Use a local mixin repository

The index as well as the mixins can also be local files. That is e.g. useful when iterating on the mixin files before publishing them:

git clone https://github.com/colcon/colcon-mixin-repository.git
colcon mixin add default file://`pwd`/colcon-mixin-repository/index.yaml

After editing either the index.yaml file or any of the .mixin files mixin update default needs to be run again.

How to use the information

To show the mixins available and their mapping invoke the following command:

colcon mixin show

To apply CLI mixins pass the option --mixin to the colcon verb followed by the names of the mixins.

How to contribute additional information

Initially fork this repository. For each contribution perform the following steps:

  • Create or modify one or multiple files ending with .mixin.
  • Add any new files in alphabetical order to the index.yaml file.
  • Run the lint.py script to ensure that the changes follow the recommended yaml style.
  • Create a pull request with the changes.