Skip to main content

Nova Compute Library for Python

Project description

2012-03-08 16:22

Openstack, Nova Compute, Nova



Access Openstack Nova Compute via Python

General Overview

This is a VERY Simple library which I have found useful in projects where I needed access to the Openstack NOVA Compute API and I did not want to bother with novaclient.


If you had installed a previous version of “the book of nova” then you will need to retool the application when it comes to authentication and logging. By Default the application now uses the standard Python Logging Module, and will print out all of the logging information to the console as you access the library. If you want to log to a file simply change the “log_file” variable when you load in “computelib.NovaCommands” class. The “log_file” variable will attempt to place the log file in “/var/log” if you are running with elevated privileges, otherwise the log file will be in the users working directory. You may also change the log level for more/less output by changing the “log_level” variable. Lastly, if you have a log handler setup you can override the default logger entirely by simple using the “output” variable. To use the output variable you will need to pre-set the some logging facility which supports [error, info, debug].

Functions of the Library :
  • Do Openstack Nova Things

  • Presently only supports Openstack Nova Compute, but does so for both Vanilla Openstack and the Rackspace Open Cloud

  • Not all of the functions are built-in however the library is extendable and I would be happy to add things in as needed / requested.

Prerequisites :
  • Python => 2.6 but < 3.0

Installation is simple :

git clone git://
cd bookofnova
python install

Now in your application Import bookofnova and go forth and Access Openstack Nova.

Application Usage

Here is some Basic Usage :

# Everything in this dictionary is a string, fill in the needed values.
m_args = {"os_user": 'YOURUSERNAME',
          "os_apikey": 'RANDOMNUMBERSANDTHINGS',
          "os_auth_url": None,
          "os_rax_auth": 'ALOCATION',
          "os_verbose": None,
          "os_password": None,
          "os_tenant": None,
          "os_region": None,
          "os_version": 'v2.0'}
from bookofnova import computelib, connections
# Tell the book of Nova that you are ready
nova = computelib.NovaCommands(m_args=m_args,

# Authenticate Against the Nova API

# Using Nova to show a list of all Instances
servers = nova.server_list()

# now everything that you ever wanted to know from a Openstack Nova
# query can be found in your dictionary under the key 'nova_resp'

Get Social

See for Issues or Feature requests


Copyright [2013] [Kevin Carter]

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bookofnova-0.007.tar.gz (12.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page