Skip to content


Subversion checkout URL

You can clone with
Download ZIP

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


Horizon: The OpenStack Dashboard Project

The Horizon project is a Django module that is used to provide web based
interactions with an OpenStack cloud.

There is a reference implementation that uses this module located at:

It is highly recommended that you make use of this reference implementation
so that changes you make can be visualized effectively and are consistent.
Using this reference implementation as a development environment will greatly
simplify development of the ``horizon`` module.

Of course, if you are developing your own Django site using Horizon, then
you can disregard this advice.

Getting Started

Horizon uses Buildout ( to manage local development.
To configure your local Buildout environment first install the following
system-level dependencies:

  * python-dev
  * git
  * bzr

Then instantiate buildout with::

  $ python
  $ bin/buildout

This will install all the dependencies of Horizon and provide some useful
scripts in the ``bin/`` directory:

  bin/python provides a python shell for the current buildout.
  bin/django provides django functions for the current buildout.

You should now be able to run unit tests as follows::

  $ bin/django test


  $ bin/test

You can run unit tests with code coverage on Horizon by setting

  $ NOSE_WITH_COVERAGE=true bin/test

Get even better coverage info by running coverage directly::

  $ coverage run --branch --source horizon bin/django test horizon && coverage html
Something went wrong with that request. Please try again.