Metadata-Version: 1.1
Name: rackspace-backup-client
Version: 0.18.0
Summary: A Python client for the Rackspace Cloud Backup API.
Home-page: https://github.com/rackerlabs/python-cloudbackup-sdk
Author: Alejandro Cabrera
Author-email: alejandro.cabrera@rackspace.com
License: Apache License (2.0)
Description: ***************************
        Cloud Backup API Python SDK
        ***************************
        
        :version: 0.18.0
        :Presentations: `Introduction`_
        
        Welcome to the Python bindings to the Rackspace Cloud Backup
        API. These bindings will help you make the most of the Cloud Backup
        system and integrate it into your workflows.
        
        **Table of Contents**
        
        .. contents::
            :local:
            :depth: 2
            :backlinks: none
        
        ========
        Features
        ========
        
        * Python 2.7 and 3.3+ supported
        * Easy to install (pip)
        * Easy to test (nose + tox)
        * Designed to be easy to use with `ipython`_
            - Tab-completion and smart introspection
            - verbs map to object functions: backup.start()
            - nouns map to object properties: backup.report
        
        I'll let the code speak for ease of use:
        
        .. code-block:: python
        
            from rcbu.client.client import Client
            from rcbu.client.connection import Connection
            import rcbu.client.backup_configuration as backup_config
        
            conn = Connection('username', apikey='981263y1hq82yh8y9q38q2')
            client = Client(conn)
            myconf = backup_config.from_file('backup_config.json', conn)
        
            # Upload a new backup configuration to the Backup API
            myconf.create()
        
            backup = client.create_backup(myconf)
            status = backup.start()
        
            # block here until the backup completes
            # polls once a minute by default
            backup.wait_for_completion(poll_interval=.5)
        
            # easy reporting and checking for success
            report = backup.report
            report.raise_if_not_ok()
        
        
        Check out the `backup_config.json`_
        
        =======
        Install
        =======
        
        Make sure you have libgmp, libssl, and the Python development headers installed::
        
            sudo apt-get install libgmp-dev libssl-dev python-dev
            sudo apt-get install libgmp-dev libssl-dev python3-dev  # for Py3
        
        On Windows, make sure that the proper Visual Studio path is configured::
        
            SET VS90COMNTOOLS=%VS100COMNTOOLS%  # MSVS 2010
            SET VS90COMNTOOLS=%VS110COMNTOOLS%  # MSVS 2012
        
        .. code-block:: bash
        
            pip install git+https://github.com/rackerlabs/python-cloudbackup-sdk
        
        ============
        Contributing
        ============
        
        Some simple guidelines:
        
        * Unit tests for new features
        * Keep the code clean - flake8
        * Be wary of warnings and errors - pylint
        * >95% code coverage - keep it strong
        * Be `Pythonic`_
        
        For more details, checkout the `Contributing`_ guide.
        
        If you have any questions, please check in with Alejandro Cabrera
        <alejandro.cabrera@rackspace.com>.
        
        .. _Pythonic: http://www.python.org/dev/peps/pep-0020/
        .. _backup_config.json: https://github.com/rackerlabs/python-cloudbackup-sdk/blob/master/examples/create_a_backup/backup_config.json
        .. _ipython: http://ipython.org/
        .. _Introduction: https://one.rackspace.com/download/attachments/21615636/python-sdk.pdf
        .. _Contributing: https://github.com/rackerlabs/python-cloudbackup-sdk/blob/master/CONTRIBUTING.rst
        
Keywords: rackspace,Cloud Backup,client
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: Implementation :: CPython
