/pyrax

The Python SDK for the Rackspace Cloud

Primary LanguagePythonApache License 2.0Apache-2.0

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 for what has changed in the latest release

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

Getting Started with OpenStack/Rackspace

To sign up for a Rackspace Cloud account, go to

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.

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 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, 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.

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://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 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.

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