The list verb enumerates a set of packages.
It is provided by the colcon-package-information package.
For each package a line is shown containing the name, path and type (in parentheses) separated by tabs. By default the list is ordered alphabetically by the package name. Optionally, it can order the packages topologically based on their dependencies.
These common arguments can be used:
- :doc:`discovery <../discovery-arguments>` arguments
- :doc:`package selection <../package-selection-arguments>` arguments
- :doc:`mixin <../mixin-arguments>` arguments
Additionally, the following specific command line arguments can be used:
- --topological-order, -t
- Order output based on topological ordering (breadth-first). For more detailed visualizations of dependencies see the :doc:`graph <graph>` verb.
- --names-only, -n
- Output only the name of each package but not the path and type
- --paths-only, -p
- Output only the path of each package but not the name and type