metadata - Manage metadata

The metadata verb offers multiple subverbs to manage the registration, introspection and update of metadata repositories.

metadata add

Add the URL of a metadata repository. Afterwards, the metadata information needs to be fetched at least once by invoking colcon metadata update <name>.

name
The name to identify the to-be-added repository.
url
The URL pointing to a yaml file containing an index enumerating .meta files.

metadata list

Enumerate the name and URL of the registered metadata repositories as well as their metadata files.

[name]
An optional name to only enumerate the metadata files of a specific repository.

metadata remove

Remove the URL of a metadata repository and all its metadata files.

name
The name to identify the to-be-removed repository.

metadata update

Fetch the metadata files from a specific repository. The output indicates which metadata files have been added, updated, are unchanged or are obsolete. Obsolete metadata files are not deleted but renamed (changing the .meta extension to .obsolete).

[name]
An optional name to only update the metadata files of a specific repository.