Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Python RightScale API wrapper
Python Shell
branch: master

Merge pull request #13 from michaeljoseph/fix-coverage-reporting

Exclude virtualenv from coverage reports
latest commit ba95c574a9
@michaeljoseph authored

README.md

righteous: Python RightScale API client

Build Status Stories in Ready pypi version # of downloads code coverage

righteous is a Python client implementation of the RightScale API for EC2 instance management.

righteous

righteous provides an API and CLI to create, start/stop, delete, remove and introspect RightScale EC2 Servers. This library implements RightScale API 1.0 and has only been tested with EC2 instances using ServerTemplates and managed in a Deployment.

Installation

Get it from pypi (like it's hot):

pip install righteous

API Usage

First, initialise righteous (to access all the current functionality (besides creating new instances), you just need to provide the following authentication parameters):

import righteous
username, password = 'me@domain.com', 'security'
# find your RightScale account_id by going to Settings -> Account Settings in the RightScale Dashboard
# The URL that is shown in your browser's location bar should look like the following: https://my.rightscale.com/accounts/1234.
account_id = 1234
righteous.initialise(username, password, account_id)

# list servers
servers = righteous.list_servers()

CLI Usage

Configure the CLI by copying righteous.config.template to ~/.righteous and customise appropriately.

Righteous CLI.

Usage:
  righteous [options] list
  righteous [options] create <environment> <instance-type> (<server-template-key>=<server-template-value>)...
  righteous [options] stop <environment>...
  righteous [options] status <environment>...
  righteous [options] delete <environment>...
  righteous --version

Options:
  -c FILE --config=FILE        Specify the configuration file location, default is ~/.righteous
  -v --verbose                 Show debug output          
  -h --help                    Show this screen.

List all the instances

$ righteous list

Status of a single instance

$ righteous status my-instance

Stop an instance

$ righteous stop my-instance

Remove an instance

$ righteous delete my-instance

Development / Running the tests

$ nosetests

The integration tests take a couple of minutes to run since they test all the current functionality (creating, starting, stopping and deleting environments, server templates and deployments) against RightScale. These tests require a configured righteous.config in the root of the directory, so copy and customise righteous.config.template before running:

$ nosetests tests.integration.base

Michael Joseph 2012

Something went wrong with that request. Please try again.