8.2. Marvin

Marvin is the CloudStack automation framework. It originated as a tool for integration testing but is now also used to build DevCloud as well as to provide a Python CloudStack API binding.

Nota

Marvin's complete documenation is on the wiki at https://cwiki.apache.org/CLOUDSTACK/testing-with-python.html

The source code is located at tools/marvin

8.2.1. Building and Installing Marvin

Marvin is built with Maven and is dependent on APIdoc. To build it do the following in the root tree of CloudStack:

mvn -P developer -pl :cloud-apidoc

mvn -P developer -pl :cloud-marvin

If successful the build will have created the cloudstackAPI Python package under tools/marvin/marvin/cloudstackAPI as well as a gziped Marvin package under tools/marvin dist. To install the Python Marvin module do the following in tools/marvin:

sudo python ./setup.py install

The dependencies will be downloaded the Python module installed and you should be able to use Marvin in Python. Check that you can import the module before starting to use it.

$ python
Python 2.7.3 (default, Nov 17 2012, 19:54:34) 
[GCC 4.2.1 Compatible Apple Clang 4.1 ((tags/Apple/clang-421.11.66))] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import marvin
>>> from marvin.cloudstackAPI import *
>>>

You could also install it using pip or easy_install using the local distribution package in tools/marvin/dist :

pip install tools/marvin/dist/Marvin-0.1.0.tar.gz

Or:

easy_install tools/marvin/dist/Marvin-0.1.0.tar.gz