Skip to content
Rackspace Open Cloud command line interface
Python
Find file
Latest commit c59d7ef @Kami Kami Merge pull request #11 from dreid/fix-pip-command
Remove -r argument from `pip install`
Failed to load latest commit information.
examples
raxcli
tests
.gitignore
.travis.yml
LICENSE.txt
README.md
requirements.txt
setup.py

README.md

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:

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:

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

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

Usage

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

For example:

raxcli 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

python setup.py test

Running lint

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

Something went wrong with that request. Please try again.