.. _ref_commands_list-lib:

list-lib
========

List all libraries from a charm.

For each library, it will show the name and the api and patch versions
for its tip.

For example:

    $ charmcraft list-lib my-charm
    Library name    API    Patch
    my_great_lib    0      3
    my_great_lib    1      0
    other_lib       0      5

To fetch one of the shown libraries you can use the `fetch-lib` command.


Usage
-----

:command:`charmcraft list-lib [options]`


Options
-------

``--format``
   Produce the result in the specified format (currently only 'json').

Global options
--------------

``-h`` or ``--help``
   Show this help message and exit.
``-q`` or ``--quiet``
   Only show warnings and errors, not progress.
``-v`` or ``--verbose``
   Show debug information and be more verbose.
``--verbosity``
   Set the verbosity level to 'quiet', 'brief', 'verbose', 'debug' or 'trace'.
``-V`` or ``--version``
   Show the application version and exit.