OpenStack Dashboard (Horizon)

The OpenStack Dashboard is a Django based reference implementation of a web based management interface for OpenStack.

It is based on the horizon module, which is designed to be a generic Django app that can be re-used in other projects.

For more information about how to get started with the OpenStack Dashboard, view the README file in the openstack-dashboard folder.

For more information about working directly with horizon, see the README file in the horizon folder.

For release management:

https://launchpad.net/horizon

For blueprints and feature specifications:

https://blueprints.launchpad.net/horizon

For issue tracking:

https://bugs.launchpad.net/horizon

Project Structure and Testing:

This project is a bit different from other OpenStack projects in that it has two very distinct components underneath it: horizon, and openstack-dashboard.

The horizon directory holds the generic libraries and components that can be used in any Django project. In testing, this component is set up with buildout (see run_tests.sh), and any dependencies that get added need to be added to the horizon/buildout.cfg file.

The openstack-dashboard directory contains a reference Django project that uses horizon and is built with a virtualenv and tested through that environment. If dependencies are added that openstack-dashboard requires they should be added to openstack-dashboard/tools/pip-requires.

The run_tests.sh script invokes tests and analyses on both of these components in its process, and is what Jenkins uses to verify the stability of the project.

To run the tests:

$ ./run_tests.sh

Building Contributor Documentation

This documentation is written by contributors, for contributors.

The source is maintained in the docs/source folder using reStructuredText and built by Sphinx

Building Automatically:
```
$ ./run_tests.sh --docs
```

Building Manually:

$ export DJANGO_SETTINGS_MODULE=local.local_settings
$ python doc/generate_autodoc_index.py
$ sphinx-build -b html doc/source build/sphinx/html

Results are in the build/sphinx/html directory

File	Mode	Size
docs
horizon
openstack-dashboard
tools
.bzrignore	-rw-r--r--	365 bytes
.gitignore	-rw-r--r--	558 bytes
.gitreview	-rw-r--r--	76 bytes
.pylintrc	-rw-r--r--	1.4 KB
LICENSE	-rw-r--r--	9.9 KB
README.rst	-rw-r--r--	2.3 KB
run_tests.sh	-rwxr-xr-x	13.8 KB

README.rst