OpenStack Dashboard (Horizon)
Go to file
Tony Breeds a909ed26c2 Add constraints support to run_tests.sh
Currently developers need to manually build a constratined venv if they
want to  match the versions that are tested in the gate.  This change
adds logic to run_tests.sh and install_venv*.py to default to the same
constraints file used in the gate.

With constraints enabled the 'churn' in the environment should be
minimised so remove the developer optimisation for detecting when
packaged versions change and always just install/update.  This has the
down side of making the script preamble slightly longer but we always
print_help() so I don't think it'll be terribly inconvenient.

Change-Id: I9bf85adb5aa2c85d8c0f0f22ac9efe5cac3646c0
Closes-Bug: 1644697
2016-11-28 11:06:07 +11:00
doc Note how to use local.conf in stable branches 2016-11-25 01:08:39 +00:00
horizon Imported Translations from Zanata 2016-11-25 07:33:01 +00:00
openstack_dashboard Imported Translations from Zanata 2016-11-25 07:33:01 +00:00
releasenotes Merge "Removing deprecated Swift UI code" 2016-11-24 07:55:17 +00:00
tools Add constraints support to run_tests.sh 2016-11-28 11:06:07 +11:00
.eslintignore bump eslint version to 1.10.3 2016-03-31 14:06:45 +00:00
.eslintrc Disabling warnings of 'quote-props' 2016-05-18 15:04:00 -06:00
.gitignore doc: Do not generate no source code reference 2016-09-24 20:44:48 +09:00
.gitreview Add .gitreview and rfc.sh. 2011-10-28 09:50:35 -04:00
.mailmap Update my mailmap 2013-10-25 14:49:23 +08:00
.pylintrc updating run_tests.sh to mimic other openstack projects, pep8, pylint, coverage 2011-08-31 14:41:36 -07:00
.testr.conf Add testr support 2015-12-10 09:45:41 +01:00
CONTRIBUTING.rst Workflow documentation is now in infra-manual 2014-12-05 03:30:36 +00:00
HACKING.rst Eliminate mutable default arguments 2015-12-17 09:58:46 +00:00
LICENSE Initial commit 2011-01-12 13:43:31 -08:00
MANIFEST.in Update MANIFEST for SCSS 2015-09-09 14:42:10 +01:00
Makefile Unifies the project packaging into one set of modules. 2012-02-29 00:20:13 -08:00
README.rst Add install guide for users and clean up README 2014-10-09 03:29:26 +09:00
babel-django.cfg Added a django extract for .csv files 2015-09-15 21:57:42 +00:00
babel-djangojs.cfg Angular translation via babel (singular only) 2015-07-02 11:13:45 +10:00
manage.py Gate on H102 Apache 2.0 license header not found for pep8 2013-11-19 13:55:04 -05:00
package.json Update devDependencies in package.json 2016-08-01 08:24:10 +01:00
requirements.txt ceilometerclient removed from requirements.txt 2016-11-25 14:14:33 +03:00
run_tests.sh Add constraints support to run_tests.sh 2016-11-28 11:06:07 +11:00
setup.cfg Add Python 3.5 classifier 2016-09-06 04:41:48 +00:00
setup.py Updated from global requirements 2015-09-19 05:37:19 +00:00
test-requirements.txt Updated from global requirements 2016-11-02 21:53:34 +00:00
test-shim.js Fix bug where WEBROOT is not respected 2015-07-22 04:10:50 +00:00
tox.ini Merge "Turn on docs warning check in document generation" 2016-09-30 20:57:40 +00:00

README.rst

Horizon (OpenStack Dashboard)

Horizon is a Django-based project aimed at providing a complete OpenStack Dashboard along with an extensible framework for building new dashboards from reusable components. The openstack_dashboard module is a reference implementation of a Django site that uses the horizon app to provide web-based interactions with the various OpenStack projects.

Using Horizon

See doc/source/topics/install.rst about how to install Horizon in your OpenStack setup. It describes the example steps and has pointers for more detailed settings and configurations.

It is also available at http://docs.openstack.org/developer/horizon/topics/install.html.

Getting Started for Developers

doc/source/quickstart.rst or http://docs.openstack.org/developer/horizon/quickstart.html describes how to setup Horizon development environment and start development.

Building Contributor Documentation

This documentation is written by contributors, for contributors.

The source is maintained in the doc/source directory using reStructuredText and built by Sphinx

  • Building Automatically:

    $ ./run_tests.sh --docs
  • Building Manually:

    $ tools/with_venv.sh sphinx-build doc/source doc/build/html

Results are in the doc/build/html directory