1 A Python library for Juju
2 =========================
4 Source code: https://github.com/juju/python-libjuju
6 Bug reports: https://github.com/juju/python-libjuju/issues
8 Documentation: https://pythonhosted.org/juju/
21 * Asynchronous - uses asyncio and async/await features of python 3.5
22 * Websocket-level bindings are programmatically generated (indirectly) from the
23 Juju golang code, ensuring full api coverage
24 * Provides an OO layer which encapsulates much of the websocket api and
25 provides familiar nouns and verbs (e.g. Model.deploy(), Application.add_unit(),
39 Here's a simple example that shows basic usage of the library. The example
40 connects to the currently active Juju model, deploys a single unit of the
41 ubuntu charm, then exits.
43 More examples can be found in the `examples/` directory of the source tree,
44 and in the documentation.
55 from juju.model import Model
59 # Create a Model instance. We need to connect our Model to a Juju api
60 # server before we can use it.
63 # Connect to the currently active Juju model
64 await model.connect_current()
66 # Deploy a single unit of the ubuntu charm, using revision 0 from the
67 # stable channel of the Charm Store.
68 ubuntu_app = await model.deploy(
70 application_name='ubuntu',
75 # Disconnect from the api server and cleanup.
80 # Set logging level to debug so we can see verbose output from the
82 logging.basicConfig(level=logging.DEBUG)
84 # Quiet logging from the websocket library. If you want to see
85 # everything sent over the wire, set this to DEBUG.
86 ws_logger = logging.getLogger('websockets.protocol')
87 ws_logger.setLevel(logging.INFO)
89 # Run the deploy coroutine in an asyncio event loop, using a helper
90 # that abstracts loop creation and teardown.
94 if __name__ == '__main__':