Working with the Source¶

Setting up a Development Sandbox¶

Clone the ceilometer project to the machine:

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

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

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

If you are preparing a patch, create a topic branch and switch to it before making any changes:
```
$ git checkout -b TOPIC-BRANCH
```

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

Install the test dependencies:

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

Run the unit and code-style tests:

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

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