openstack/aodh
Code Issues Proposed changes
aodh/doc/source/contributing/source.rst
Gordon Chung 4a1cda6c80 add v2 query examples 
add v2 query curl examples to doc and fix a spelling mistake.

Change-Id: Ide0bae84c3fadfdb5c4c0c40b7f47aa174e46f43
2013-04-01 10:42:58 -04:00

2.5 KiB
Raw Blame History

Working with the Source

Setting up a Development Sandbox

  1. Set up a server or virtual machine to run OpenStack using devstack.

  2. Clone the ceilometer project to the machine:

    $ cd /opt/stack
$ git clone https://github.com/openstack/ceilometer.git
$ cd ./ceilometer

  3. Once this is done, you need to setup the review process:

    $ git remote add gerrit ssh://<username>@review.openstack.org:29418/openstack/ceilometer.git

  4. If you are preparing a patch, create a topic branch and switch to it before making any changes:

    $ git checkout -b TOPIC-BRANCH

Running the Tests

Ceiloemter includes an extensive set of automated unit tests which are run through tox.

  1. Install tox:

    $ sudo pip install tox

  2. Install the test dependencies:

    $ sudo pip install -r /opt/stack/ceilometer/tools/test-requires

  3. Run the unit and code-style tests:

    $ cd /opt/stack/ceilometer
$ tox -e py27,pep8

    As tox is a wrapper around nose, it also accepts the same flags as nosetests. See the nose options documentation for details about these additional flags.

    Use a double hyphen to pass options to nose. For example, to set verbose flag and to run only tests under tests/api/v2:

    $ tox -e py27 -- -v api/v2

Code Reviews

Ceilometer uses the OpenStack review process for all code and developer documentation contributions. Code reviews are managed through gerrit.