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.1.tar.gz (12.9 kB view details)

Uploaded Source

Built Distribution

colcon_alias-0.1.1-py3-none-any.whl (11.8 kB view details)

Uploaded Python 3

File details

Details for the file colcon-alias-0.1.1.tar.gz.

File metadata

  • Download URL: colcon-alias-0.1.1.tar.gz
  • Upload date:
  • Size: 12.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 colorama/0.4.4 importlib-metadata/4.6.4 keyring/23.5.0 pkginfo/1.8.2 readme-renderer/34.0 requests-toolbelt/0.9.1 requests/2.25.1 rfc3986/1.5.0 tqdm/4.57.0 urllib3/1.26.5 CPython/3.10.12

File hashes

Hashes for colcon-alias-0.1.1.tar.gz
Algorithm Hash digest
SHA256 0e552843806078eed85f6b29023fb548e2707837d8a48c90fbd69a97e77d4d03
MD5 2489740146bedb114efff2b26d1bff1d
BLAKE2b-256 aeb1db59479e8aeb3358c6fee436c3dfdaf3ffc412ab7d58ab6be0a647d81647

See more details on using hashes here.

File details

Details for the file colcon_alias-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: colcon_alias-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 11.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 colorama/0.4.4 importlib-metadata/4.6.4 keyring/23.5.0 pkginfo/1.8.2 readme-renderer/34.0 requests-toolbelt/0.9.1 requests/2.25.1 rfc3986/1.5.0 tqdm/4.57.0 urllib3/1.26.5 CPython/3.10.12

File hashes

Hashes for colcon_alias-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5b63fc7ff8f95e4caf47098811e2964faf65c42435a103845723dde0fc6d3ae9
MD5 89bcb0363f5f00fa4e45fa2e3d3f4049
BLAKE2b-256 cc40da1c2f983dac5889f6887679cab4ad93cc787b35cf839b0107812aa1bb24

See more details on using hashes here.

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