Python library for Juju
Source code: https://github.com/juju/python-libjuju
Bug reports: https://github.com/juju/python-libjuju/issues
- Python 3.5+
- Juju 2.0+
- Asynchronous - uses asyncio and async/await features of python 3.5
- 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.)
pip install juju
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.
More examples can be found in the examples/ directory of the source tree, and in the documentation.
#!/usr/bin/python3.5 import asyncio import logging from juju.model import Model async def run(): # 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_current() # Deploy a single unit of the ubuntu charm, using revision 0 from the # stable channel of the Charm Store. ubuntu_app = await model.deploy( 'ubuntu-0', application_name='ubuntu', series='xenial', channel='stable', ) # Disconnect from the api server and cleanup. model.disconnect() # Stop the asyncio event loop. model.loop.stop() def main(): # Set logging level to debug so we can see verbose output from the # juju library. logging.basicConfig(level=logging.DEBUG) # Quiet logging from the websocket library. 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) # Create the asyncio event loop loop = asyncio.get_event_loop() # Queue up our `run()` coroutine for execution loop.create_task(run()) # Start the event loop loop.run_forever() if __name__ == '__main__': main()