jubilant

What it is and what it does

Jubilant is a Python wrapper around the Juju CLI designed to simplify charm integration testing. It maps Juju CLI commands to type-annotated Python methods, eliminating the need for async/await patterns and avoiding websocket failures that plague lower-level alternatives. The library is built for developers writing pytest-based charm tests who want a straightforward, Pythonic interface to deploy charms, wait for readiness, and verify behavior.

The package depends only on PyYAML and requires the Juju CLI to be installed separately on the system. It supports current Python versions (3.10+) and is actively maintained by Canonical. The project committed to API stability after version 1.0.0, making it a stable choice for long-lived test suites.

Use it for:

• Write pytest fixtures that deploy charms to temporary Juju models and clean them up automatically after tests.
• Wait for charm deployments to reach active state with built-in predicates like all_active before running assertions.
• Automate charm integration testing without managing websocket connections or async/await boilerplate.
• Replace pytest-operator in existing test suites with a simpler, more maintainable API.
• Deploy and verify multiple charms in a single test, checking their interactions and HTTP endpoints.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Jubilant wraps the Juju CLI with a type-annotated Python interface, primarily for writing charm integration tests without websocket failures or async complexity.

Yes. Jubilant is actively maintained, has low install friction, carries no security vulnerabilities, and offers a stable API (committed post-1.0.0). It directly solves the pain point of charm integration testing with a cleaner alternative to both pytest-operator and python-libjuju. Install it if you write Juju charm tests or automate Juju deployments in Python.

Install

jubilant on PyPI

pip install jubilant

uv add jubilant

poetry add jubilant

Installing jubilant

Before you install

Low install friction with a single runtime dependency (PyYAML). Active maintenance: last commit 2026-08-12, version 1.12.0 released 2026-07-30, and the project explicitly committed to API stability after 1.0.0 in April 2025.

License in practice

Licensed under Apache Software License (permissive), which allows commercial use, modification, and distribution with minimal restrictions—suitable for both open-source and proprietary projects.

Quickstart

pip install jubilant

import jubilant

juju = jubilant.Juju()
juju.deploy('snappass-test')
juju.wait(jubilant.all_active)

Requires Juju CLI to be installed separately on the system; Python 3.10 or later.

Verify before relying

• Whether Jubilant's API coverage matches all common Juju CLI commands used in production charm tests.
• Performance characteristics when managing large deployments or many concurrent charm operations.
• Compatibility with Juju versions beyond the current stable release.

Package facts

Evidence: jubilant-1.12.0-py3-none-any.whl

Tags

More Testing packages