Metadata-Version: 1.1
Name: theblues
Version: 0.2.0
Summary: Python library for using the juju charm store API.
Home-page: https://github.com/juju/theblues
Author: JC Sackett
Author-email: jcsackett@canonical.com
License: UNKNOWN
Description: =============================
        theblues
        =============================
        
        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.2.0 (2016-03-24)
        ++++++++++++++++++
        
        * Add LGPL3 license.
        * Add optional channel arguments.
        * Make deps less strict to work across trusty -> xenial.
        
        0.1.1 (2016-01-25)
        ++++++++++++++++++
        
        * Use Reference from jujubundlelib as a parameter.
        * Add list endpoint.
          
        
        0.1.0 (2015-12-04)
        ++++++++++++++++++
        
        * Fix for empty macaroon cookie.
        
        
        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.
        
Keywords: theblues
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
