Source code: https://github.com/juju/python-libjuju
Bug reports: https://github.com/juju/python-libjuju/issues
Documentation: https://pythonlibjuju.readthedocs.io/en/latest/
Supported Python versions: 3.8 through 3.13 Supported Juju versions: 3.1 through 3.6
Design Notes
Asynchronous - Uses asyncio and async/await features of Python
Websocket-level bindings are programmatically generated (indirectly) from the Juju golang code, ensuring full api coverage
Provides an OO layer which encapsulates much of the websocket api and provides familiar nouns and verbs (e.g. Model.deploy(), Application.add_unit(), etc.)
Installation
pip3 install jujuQuickstart
Here’s a simple example that shows basic usage of the library. The example connects to the currently active Juju model, deploys a single unit of the ubuntu charm, then exits:
Note : Pylibjuju requires an already bootstrapped Juju controller to connect to.
#!/usr/bin/python3
import asyncio
import logging
import sys
from juju.model import Model
async def deploy():
# Create a Model instance. We need to connect our Model to a Juju api
# server before we can use it.
model = Model()
# Connect to the currently active Juju model
await model.connect()
try:
# Deploy a single unit of the ubuntu charm, using the latest revision
# from the stable channel of the Charm Store.
ubuntu_app = await model.deploy(
'ubuntu',
application_name='my-ubuntu',
)
if '--wait' in sys.argv:
# optionally block until the application is ready
await model.wait_for_idle(status='active')
finally:
# Disconnect from the api server and cleanup.
await model.disconnect()
def main():
logging.basicConfig(level=logging.INFO)
# If you want to see everything sent over the wire, set this to DEBUG.
ws_logger = logging.getLogger('websockets.protocol')
ws_logger.setLevel(logging.INFO)
# Run the deploy coroutine in an asyncio event loop, using a helper
# that abstracts loop creation and teardown.
asyncio.run(deploy())
if __name__ == '__main__':
main()More examples can be found in the docs, as well as in the examples/ directory of the source tree which can be run using tox. For example, to run examples/connect_current_model.py, use:
tox -e example -- examples/connect_current_model.pyREPL
To experiment with the library in a REPL, launch python in asyncio mode
$ python3 -m asyncioand then, to connect to the current model and fetch status:
>>> from juju.model import Model
>>> model = Model()
>>> await model.connect_current()
>>> status = await model.get_status()Versioning
The current Pylibjuju release policy tracks the Juju release cadence. In particular, whenever Juju makes a latest/stable release, pylibjuju pushes out a release with the same version in the following week. Newly generated schemas will be updated per Juju releases.
9 maintainers
Metadata
9 maintainers
Release files for juju 3.6.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| juju-3.6.1.3.tar.gz | 305.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| juju-3.6.1.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 592.1 kB
Release files / juju-3.6.1.3.tar.gz
| Download URL | juju-3.6.1.3.tar.gz |
|---|---|
| Size | 305.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2fcf510fa35b387abb382da3a8b2227f38852ae7e9dc1058afb228588e1aec51
|
|
BLAKE2b-256 checksum How to use checksums |
91ac42ed7565d1b031856fb7e8884089acb3eab5aa6a2dabfee3fcf09660f885
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.5
|
Release files / juju-3.6.1.3-py3-none-any.whl
| Download URL | juju-3.6.1.3-py3-none-any.whl |
|---|---|
| Size | 287.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
87469500a0a4e6a3976ddf0595e316379868d5cea96e15af2d2d4b94188f76e5
|
|
BLAKE2b-256 checksum How to use checksums |
8613e31f9b9c24e723a161bc3b75729acb109d80bf3f75f937e4c3d408f19e5a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.5
|
