Metadata-Version: 2.1
Name: pyrax
Version: 1.9.8
Summary: Python language bindings for OpenStack Clouds.
Home-page: https://github.com/rackspace/pyrax
Author: Rackspace
License: Apache License, Version 2.0
Keywords: pyrax rackspace cloud openstack
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 2
Classifier: Operating System :: OS Independent
License-File: LICENSE
Requires-Dist: python-novaclient==2.27.0
Requires-Dist: rackspace-novaclient
Requires-Dist: keyring
Requires-Dist: requests<3,>=2.2.1
Requires-Dist: six<2,>=1.9.0
Requires-Dist: mock

pyrax
=====

Python SDK for OpenStack/Rackspace APIs

**Note: Please submit an issue before submitting a pull
request so we can determine whether or not the change may be accepted.
Pyrax is in the process of being deprecated in favor of the OpenStack
SDK. We will announce the process and timelines for this deprecation
as soon as we can.**

See the LICENSE file for license and copyright information.

**pyrax** should work with most OpenStack-based cloud deployments,
though it specifically targets the Rackspace public cloud. For example,
the code for cloudfiles contains the ability to publish your content on
Rackspace's CDN network, even though CDN support is not part of
OpenStack Swift. But if you don't use any of the CDN-related code, your
app will work fine on any standard Swift deployment.

See the `Release
Notes <https://github.com/rackspace/pyrax/tree/master/RELEASENOTES.md>`_
for what has changed in the latest release

.. image:: https://travis-ci.org/rackspace/pyrax.svg?branch=master
       :target: https://travis-ci.org/rackspace/pyrax

Getting Started with OpenStack/Rackspace
----------------------------------------

To sign up for a Rackspace Cloud account, go to

`http://www.rackspace.com/cloud <http://www.rackspace.com/cloud>`_

and follow the prompts.

If you are working with an OpenStack deployment, you can find more
information at `http://www.openstack.org <http://www.openstack.org>`_.

Requirements
------------

-  A Rackspace Cloud account

   -  username
   -  API key

-  Python 2.7

   -  pyrax is not yet tested yet with other Python versions. Please
      post feedback about what works or does not work with other
      versions. See the **Support and Feedback** section below for where
      to post.

Installation
------------

The best way to install **pyrax** is by using
`pip <http://www.pip-installer.org/en/latest/>`_ to get the latest
official release:

::

    pip install pyrax

If you would like to work with the current development state of pyrax,
you can install directly from trunk on GitHub:

::

    pip install git+git://github.com/rackspace/pyrax.git

If you are not using
`virtualenv <http://pypi.python.org/pypi/virtualenv>`_, you will need to
run ``pip install`` as admin using ``sudo``.

You may also download and install from source. The source code for
**pyrax** is available on
`GitHub <https://github.com/rackspace/pyrax/>`_.

Once you have the source code, ``cd`` to the base directory of the
source and run (using ``sudo``, if necessary):

::

    python setup.py install

For more information on getting started, check out the following
documentation:

`https://github.com/rackspace/pyrax/blob/master/docs/getting\_started.md <https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md>`_
`https://developer.rackspace.com/sdks/python/ <https://developer.rackspace.com/sdks/python/>`_

Updates
-------

If you installed **pyrax** using pip, it is simple to get the latest
updates from either PyPI or GitHub:

::

    # PyPI
    pip install --upgrade pyrax
    # GitHub
    pip install --upgrade git+git://github.com/rackspace/pyrax.git

Contributing
------------

Please see the `HACKING <HACKING.rst>`_ file for contribution guidelines.
Make sure pull requests are on the ``working`` branch!

Support and Feedback
--------------------

You can find documentation for using the **pyrax** SDK at
https://developer.rackspace.com/sdks/python/.

Your feedback is appreciated! If you have specific issues with the
**pyrax** SDK, developers should file an `issue via
Github <https://github.com/rackspace/pyrax/issues>`_.

For general feedback and support requests, contact us at
https://developer.rackspace.com/support/
