.. _ref_commands_publish-lib:

publish-lib
===========

Publish charm libraries.

Upload and release in Charmhub the new api/patch version of the
indicated library, or all the charm libraries if <library> is not
provided.

It will automatically take you through the login process if
your credentials are missing or too old.

Note that in order to be able to publish a charm library, you need
to be signed into Charmcraft as a user that has permissions to
publish libraries to this charm. In particular you need to be the
owner of this charm or registered as a contributor to the
charm (a status that can be requested via Discourse).


Usage
-----

:command:`charmcraft publish-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.