openstack
/
horizon
Code Issues Proposed changes
OpenStack Dashboard (Horizon)
1,022 Commits 9 Branches 45 Tags 313 MiB
Python 63%
JavaScript 28.9%
HTML 6.5%
SCSS 1.5%
Go to file
Gabriel Hurley 34e217b357 Added sanity checks and environment versioning to run_tests.sh. 
Implements blueprint environment-versioning.

Fixed bug 887885. The script will bail if the seleniumrc or test scripts are missing, preventing the hang, or the possibility of bad environments.

Change-Id: I3cdeb71660c897e8b2adbf81d3794333d1847204
 		2011-11-09 16:34:30 -08:00
docs Adds selenium and qunit integration into Django test suite. 2011-11-08 16:44:16 -08:00
horizon Added sanity checks and environment versioning to run_tests.sh. 2011-11-09 16:34:30 -08:00
openstack-dashboard Added sanity checks and environment versioning to run_tests.sh. 2011-11-09 16:34:30 -08:00
tools Add .gitreview and rfc.sh. 2011-10-28 09:50:35 -04:00
.bzrignore Re-architects the OpenStack Dashboard for modularity and extensibility. 2011-11-07 12:59:21 -08:00
.gitignore Added sanity checks and environment versioning to run_tests.sh. 2011-11-09 16:34:30 -08:00
.gitreview Add .gitreview and rfc.sh. 2011-10-28 09:50:35 -04:00
.pylintrc updating run_tests.sh to mimic other openstack projects, pep8, pylint, coverage 2011-08-31 14:41:36 -07:00
LICENSE Initial commit 2011-01-12 13:43:31 -08:00
README Adding setup instructions to the quickstart docs. 2011-11-08 09:33:17 -08:00
run_tests.sh Added sanity checks and environment versioning to run_tests.sh. 2011-11-09 16:34:30 -08:00

README 

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`_

.. _reStructuredText: http://docutils.sourceforge.net/rst.html
.. _Sphinx: http://sphinx.pocoo.org/

* 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