Note:  The Python language bindings here are no longer being actively developed.  We recommend using our Python SDK, pyrax, in its place when possible.  You can get more information on the Python SDK on our API documentation site.

Overview

This Tutorial will take us step by step through the installation of Cloud Files Python API; in both Windows and *nix Operating systems(Should be the same for MacOSX)

What we need

• Keyboard & Mouse
• Computer
• An Internet Connection
• Cloud Files Python API
• Python (I am using 2.6 for the Windows and *nix Install.)
• About 5 - 10 min. approx.

Windows Installation

In this tutorial we only cover how to install the Cloud Files Python API. For Installation steps for Python: the Language see Python's website for more info.

• Head to our Git Hub.
• Click Download.
• Then Click the type of file you want to save it as. I suggest .zip
• You will be prompted to save the file.
• For the sake of this tutorial save it to the Desktop.
• Once downloaded unpack the zip file; also onto the Desktop.
• You should have a folder named something like this rackspace-python-cloudfiles-e8c1625ffa59d42c85215e5b176af1ba376df00b
• Open Terminal and Navigate to that folder.
• inside of the rackspace-python-cloudfiles-e8c1625ffa59d42c85215e5b176af1ba376df00b folder there should be a file called setup.py.
• Run this command.

setup.py install

You should get some output from the console and then return to the command prompt.

*Nix Installation

In this tutorial we only cover how to install the Cloud Files Python API. For Installation steps for Python: the Language see Python's website for more info.

• Head to our Git Hub.
• Click Download.
• Then Click the type of file you want to save it as. I suggest .tar.gz
• You will be prompted to save the file.
• For the sake of this tutorial save it to the Desktop.
• Open Terminal
• Once downloaded Lets move to your Desktop. Run these commands:

cd ~/Desktop

Now go ahead and untar. The command should look like this:

tar zxvf rackspace-python-cloudfiles-e8c1625ffa59d42c85215e5b176af1ba376df00b

This should unpack the files unto your desktop that number at the end may not match so please ensure you are using the right tar name you can use tab to auto complete this. Now go ahead and cd into the directory

cd rackspace-python-cloudfiles-e8c1625ffa59d42c85215e5b176af1ba376df00b

For Most RedHat Based distros its:

su

Enter Root Password then:

python setup.py install

For Debian Based Distros its:

sudo python setup.py install

Success?

Now for the fun part lets see if the install worked.

Open IDLE for *nix head to command line and type idle at the command line and it will execute the IDE. For Windows Head to start -> all programs -> python2.6 -> IDLE (Python GUI)

Then inside of the Idle Window type in:

>>> import cloudfiles

Hit enter if you get nothing in return. You were successful in installing the API!

>>> import cloudfiles
>>>

If you get something like this:

>>> import cloudfiles
Traceback (most recent call last):
  File "<pyshell#0>", line 1, in <module>
    import cloudfiles
ImportError: No module named cloudfiles
>>> 

Something is wrong double check your library path is correct and the api files are saved in the right place. For more info on where your default library path is; please take a look at the python documentation for your operating system.