Skip to main content

Extension for colcon to create and modify command aliases.

Project description

An extension for colcon-core to create and modify command aliases.

Aliases condense any number of colcon command invocations made up of a verb followed by all associated arguments down to another ‘alias’ verb. When invoking the alias verb, additional arguments can be appended to the original invocations.

An example alias called ‘bat’, short for ‘build and test’:

$ colcon alias bat --command build --command test
Registered command list for alias 'bat':
  build
  test
$ colcon bat --packages-select colcon-alias
Running command alias: colcon build --packages-select colcon-alias
...
Running command alias: colcon test --packages-select colcon-alias
...

Another example, an alias for building specific packages:

$ colcon alias buildpkg --command build --event-handler console_direct+ --packages-select
Registered command list for alias 'buildpkg':
  build --event-handler console_direct+ --packages-select
$ colcon buildpkg colcon-alias
Running command alias: colcon build --event-handler console_direct+ --packages-select colcon-alias
...

A list of currently registered aliases can be found in the colcon help text:

$ colcon --help
...

colcon aliases:
  bat                   build
                        test
  buildpkg              build --event-handler console_direct+ --packages-select

...

Note: When using colcon-alias with the colcon-mixin extension, the --mixin command line argument is applied as an argument to --command and not used as an actual mixin to the alias verb.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

colcon-alias-0.1.0.tar.gz (11.8 kB view hashes)

Uploaded Source

Built Distribution

colcon_alias-0.1.0-py3-none-any.whl (11.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page