1 .. libjuju documentation master file, created by
2 sphinx-quickstart on Thu May 19 11:21:38 2016.
3 You can adapt this file completely to your liking, but it should at least
4 contain the root `toctree` directive.
6 A Python library for Juju
7 =========================
12 NOTE: There is no implementation here yet. It is simply a mocked out
13 design of what this library might look like. The design itself is not
14 complete. Comments on the design, good or bad, are welcomed. Use cases
15 are also appreciated as they will shape the design.
17 The goal is to end up with a feature-full and officially supported
18 python library for Juju.
20 The focus right now is on Juju 2+ only.
25 * Present an object-oriented interface to all the features of the Juju
27 * Do as much as possible through the API so that the library can be used
28 without actually installing Juju
35 Simple bootstrap/deploy
36 +++++++++++++++++++++++
43 lxd = juju.get_cloud('lxd')
44 controller = lxd.bootstrap('lxd-test')
45 model = controller.get_model('default')
47 # We might want an async and blocking version of deploy()?
48 model.deploy('mediawiki-single')
50 mediawiki = model.get_service('mediawiki')