edeffaf03c
New tox (>=1.7.0) sets a random python hash seed by default. This is generally good for testing because it will help keep projects working regardless of the hash seed, but designate unittests don't currently pass with a random hash seed so set it to the python default seed. This change will allow us to use new tox again and remove the restriction on tox<=1.6.1 to run unittests. Note this change will need to be backported to the stable branches to keep unittests there working with new tox as well. See also Ib54364877a251db48c54dfdc43c503281ea1f04a Change-Id: I3b3d152148a2055da1e2eaef5f4fbb63ebbde6fa
Introduction
Designate is an OpenStack inspired DNSaaS.
Docs: http://designate.readthedocs.org and some below for now. Bugs / Blueprints: http://launchpad.net/moniker
IRC: #openstack-dns
Installation: http://designate.readthedocs.org/en/latest/getting-started.html
Development
Designate follows the OpenStack Gerrit Workflow
Setup
Setup a working environment:
git clone git@github.com:openstack/designate.git
cd designate
virtualenv .venv
. .venv/bin/activate
pip install -r requirements.txt -r test-requirements.txt
python setup.py develop
Building the documentation
To build the documentation from the restructred text source, do the following:
cd doc
pip install -r requirements.txt
sphinx-build source/ html/
now point your browser at html/index.html (the official documentation is published to readthedocs by the maintainers.
Contributing
Install the git-review package to make life easier
pip install git-review
Branch, work, & submit:
# cut a new branch, tracking master
git checkout --track -b bug/id origin/master
# work work work
git add stuff
git commit
# rebase/squash to a single commit before submitting
git rebase -i
# submit
git-review
Testing
Execute a single test using py27 (test is CentralServiceTest.test_count_domains)
tox -e py27 -- designate/tests/test_central/test_service.py:CentralServiceTest.test_count_domains