Metadata-Version: 2.0
Name: minicloudstack
Version: 1.0.5
Summary: Minimal CloudStack Access Library and Utilities
Home-page: https://github.com/greenqloud/minicloudstack
Author: Greenqloud
Author-email: UNKNOWN
License: Apache
Keywords: cloudstack
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: requests-toolbelt (>=0.7.0)

minicloudstack
==============

Makes it easy to connect to Apache `CloudStack`_.  Tested with version 4.2 and later.

.. _CloudStack: https://cloudstack.apache.org/

Includes helper scripts to work with zones and hosts and helps you get started with your own scripts.

Alternatives
------------
This library makes it easy to create quick utilities for Operational and Development purposes.
For an interactive shell you should try `cloudmonkey`_ or shell scripting you can try `cs`_.

.. _cloudmonkey: https://pypi.python.org/pypi/cloudmonkey/
.. _cs: https://pypi.python.org/pypi/cs

Installation
------------

    pip install minicloudstack


Quickstart
----------
Export the following environment variables (alternatively arguments can be used):

.. code:: bash

    export CS_API_URL="http://mycloudstackapi.example.com/"
    export CS_API_KEY="1235..."
    export CS_SECRET_KEY="abcdef..."


Start your python shell (python or ipython).

.. code:: python

    import minicloudstack
    mcs = minicloudstack.MiniCloudStack()
    for template in mcs.list("templates", templatefilter="featured"):
        print template.id, template.name


Helper scripts
--------------
Also provided are the following scripts that can be useful:

.. code:: bash

    mcs-createzone
    mcs-deletezone
    mcs-registertemplate
    mcs-addhost
    mcs-volume
    minicloudstack

Start them with --help for detailed instructions.


Background
----------
These scripts were created by `Greenqloud`_ when developing `Qstack`_.

.. _Greenqloud: https://www.greenqloud.com/
.. _Qstack: https://qstack.com/

We hope you find them useful!

Greenqloud Dev Team.

