watcher-dashboard/HACKING.rst
ShangXiao 28ea3faebc Fix url links and spelling error in docs
1) Replace old http links with the newest https ones in docs.
2) fix a spelling error in HACKING.rst.

Change-Id: Idf087b08fd0053c95b9d9d139fa4269c258c95af
2018-03-02 00:18:42 -08:00

2.3 KiB

Contributing

The code repository is located at OpenStack. Please go there if you want to check it out:

git clone https://github.com/openstack/watcher-dashboard.git

The list of bugs and blueprints is on Launchpad:

https://launchpad.net/watcher-dashboard

We use OpenStack's Gerrit for the code contributions:

https://review.openstack.org/#/q/status:open+project:openstack/watcher-dashboard,n,z

and we follow the OpenStack Gerrit Workflow.

If you're interested in the code, here are some key places to start:

Running tests

There are several ways to run tests for watcher-dashboard.

Using tox:

This is the easiest way to run tests. When run, tox installs dependencies, prepares the virtual python environment, then runs test commands. The gate tests in gerrit usually also use tox to run tests. For available tox environments, see tox.ini.

By running run_tests.sh:

Tests can also be run using the run_tests.sh script, to see available options, run it with the --help option. It handles preparing the virtual environment and executing tests, but in contrast with tox, it does not install all dependencies, e.g. jshint must be installed before running the jshint testcase.

Manual tests:

To manually check watcher-dashboard, it is possible to run a development server for watcher-dashboard by running run_tests.sh --runserver.

To run the server with the settings used by the test environment: run_tests.sh --runserver 0.0.0.0:8000

OpenStack Style Commandments