Charmlibs

charmlibs is the home of Canonical’s charm libraries.

If you’re searching for a library to use in a charm, check out the library listings to learn which libraries are recommended and where to get them:

• General charm libraries

• Charm interface libraries

This site also hosts documentation for Python packages in the charmlibs monorepo:

• charmlibs - General libraries, imported from charmlibs in charm code.

• charmlibs.interfaces - Interface libraries, imported from charmlibs.interfaces in charm code.

If you’re new to charms, see Juju | Charm.

In this documentation

Tutorial

Start here: Write your first charm library and contribute it to the monorepo.

How-to guides

Step-by-step guides

• Manage charm libraries

• Distribute charm libraries

• Migrate your library to the monorepo

• Customize functional tests

• Customize integration tests

Reference

Technical information

• General libraries and interface libraries

• charmlibs package docs

• charmlibs.interfaces package docs

• Interface specifications

Explanation

Discussion and clarification of key topics

• Charm libraries

• Testing packages in the monorepo

• Publishing packages from the monorepo