Python library for using the juju charm store API.
Project description
Python library for using the juju charmstore API.
Installation
The easiest way to install theblues is via pip:
$ pip install theblues
Note that theblues requires python-macaroons (which has its own dependencies), which must be installed from a ppa:
$ sudo add-apt-repository ppa:yellow/ppa -y $ apt-get install libmacaroons0 python-macaroons libsodium13
Without these, theblues cannot communicate with the charmstore.
Usage
Interacting with the charmstore is pretty simple. To look up an entity on the charmstore (e.g. a charm or bundle):
>>> from theblues.charmstore import CharmStore
>>> cs = CharmStore('https://api.jujucharms.com/v4')
>>> entity = cs.entity('wordpress')
>>> entity['Id']
u'cs:trusty/wordpress-2'
Data for an entity is contained in the Meta item of the response, matching the json returned from the charmstores:
>>> entity['Meta']['charm-metadata']['Name'] u'wordpress'
You can also get files for the entity:
>>> cs.files('wordpress')['hooks/install']
u'https://api.jujucharms.com/v4/wordpress/archive/hooks/install
>>> hook = cs.files('wordpress', filename='hooks/install', read_file=True)
>>> print hook
#!/bin/bash
set -xe
...
<snipped for length>
...
juju-log "So, environment is setup. We'll wait for some hooks to fire off before we get all crazy"
To see all methods available, refer to the full docs.
History
0.0.5 (2015-11-20)
Expose common-info.
Fix import.
0.0.4 (2015-06-10)
Support setting a timeout on charmstore requests.
0.0.3 (2015-05-04)
Add type filter to charmstore search.
0.0.2 (2015-04-08)
Add series filter to charmstore search.
Handle 407 http error from charmstore as EntityNotFound.
Add simple usage example to README.
Minor changes to HACKING.
Minor fixes.
0.0.1 (2015-03-19)
Initial release.
