racker/python-raxcli

Name: python-raxcli

Owner: racker

Description: Rackspace Open Cloud command line interface

Created: 2013-05-02 18:11:00.0

Updated: 2014-10-16 04:00:18.0

Pushed: 2013-06-01 07:59:14.0

Homepage: null

Size: 675

Language: Python

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Rackspace CLI

Command line client for interacting with various Rackspace Cloud APIs.

Installation

Command line client is available on PyPi and can be installed using pip:

install raxcli

Settings Credentials

Credentials can be set (in order of precedence) as environment variables in a configuration file or you can pass them manually to each command.

Default configuration file path is ~/.raxrc but you can overrride it by setting the RAXCLI_RAXRC environment variable. For example:

LI_RAXRC=~/.raxrc.uk raxcli registry services list

Example configuration files can be found in the examples/ directory.

Usage

li <service> <resource> <action> [options]

For example:

li registry services list

Custom Output Formatter

To specify a custom formatter, use -f option. For example:

raxcli registry services list -f json

Available Formatters

• table
• csv
• json
• yaml
• html

Development

Testing and Lint

Running tests

on setup.py test

Running lint

on setup.py flake8

Goals / Brain dump

• Common command line client for all the Rackspace Cloud APIs
• Supports user and machine friendly input and output formats
• Default to user friendly output format
• Multiple output formats (table, json, csv)
• Command structure which makes sense - raxcli
• Supported Python version - 2.6, 2.7, PyPy
• Autocomplete
• REPL for every api
• Friendly debug output when using –debug
• Print CURL request actions when using –debug
• Single, unified configuration file (~/.raxrc)

License

Library is distributed under the Apache 2.0 license.