Metadata-Version: 2.0
Name: designate
Version: 2.1.0
Summary: DNS as a Service
Home-page: https://launchpad.net/designate
Author: Kiall Mac Innes
Author-email: kiall@managedit.ie
License: UNKNOWN
Platform: UNKNOWN
Classifier: Environment :: OpenStack
Classifier: Environment :: No Input/Output (Daemon)
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Internet :: Name Service (DNS)
Requires-Dist: Babel (!=2.3.2,!=2.3.0,!=2.3.1,!=2.3.3,>=1.3)
Requires-Dist: Flask (>=0.10,<1.0,!=0.11)
Requires-Dist: Jinja2 (>=2.8)
Requires-Dist: Paste
Requires-Dist: PasteDeploy (>=1.5.0)
Requires-Dist: SQLAlchemy (>=1.0.10,<1.1.0)
Requires-Dist: WebOb (>=1.2.3)
Requires-Dist: Werkzeug (>=0.7)
Requires-Dist: debtcollector (>=1.2.0)
Requires-Dist: eventlet (!=0.18.3,>=0.18.2)
Requires-Dist: greenlet (>=0.3.2)
Requires-Dist: jsonschema (<3.0.0,!=2.5.0,>=2.0.0)
Requires-Dist: keystoneauth1 (>=2.1.0)
Requires-Dist: keystonemiddleware (!=4.1.0,>=4.0.0)
Requires-Dist: netaddr (!=0.7.16,>=0.7.12)
Requires-Dist: oslo.concurrency (>=3.7.1)
Requires-Dist: oslo.config (>=3.7.0)
Requires-Dist: oslo.context (>=0.2.0)
Requires-Dist: oslo.db (>=4.1.0)
Requires-Dist: oslo.i18n (>=2.1.0)
Requires-Dist: oslo.log (>=1.14.0)
Requires-Dist: oslo.messaging (>=4.0.0)
Requires-Dist: oslo.middleware (>=3.0.0)
Requires-Dist: oslo.policy (>=0.5.0)
Requires-Dist: oslo.reports (>=0.6.0)
Requires-Dist: oslo.rootwrap (>=2.0.0)
Requires-Dist: oslo.serialization (>=1.10.0)
Requires-Dist: oslo.service (>=1.0.0)
Requires-Dist: oslo.utils (>=3.5.0)
Requires-Dist: pbr (>=1.6)
Requires-Dist: pecan (>=1.0.0)
Requires-Dist: python-designateclient (>=1.5.0)
Requires-Dist: python-memcached (>=1.56)
Requires-Dist: python-neutronclient (!=4.1.0,>=2.6.0)
Requires-Dist: requests (!=2.9.0,>=2.8.1)
Requires-Dist: setuptools (!=24.0.0,>=16.0)
Requires-Dist: six (>=1.9.0)
Requires-Dist: sqlalchemy-migrate (>=0.9.6)
Requires-Dist: stevedore (>=1.5.0)
Requires-Dist: suds-jurko (>=0.6)
Requires-Dist: tooz (>=1.28.0)
Requires-Dist: Routes (>=1.12.3,!=2.0,!=2.3.0); (python_version!='2.7')
Requires-Dist: dnspython (!=1.13.0,>=1.12.0); (python_version<'3.0')
Requires-Dist: Routes (!=2.1,>=1.12.3,!=2.0,!=2.3.0); (python_version=='2.7')
Requires-Dist: dnspython3 (>=1.12.0); (python_version>='3.0')

===================
OpenStack Designate
===================

Designate is an OpenStack project, providing DNSaaS.

IRC: #openstack-dns

Installation: http://docs.openstack.org/developer/designate/getting-started.html


Development
===========

Designate follows the `OpenStack Gerrit Workflow`_

Setup
-----

Setup a working environment:

.. code-block:: shell

    git clone https://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 Docs
-------------

To build the documentation from the restructured text source, do the following:

.. code-block:: shell

    cd doc
    pip install -r requirements.txt
    sphinx-build  source/ build/html/

now point your browser at html/index.html
(the official documentation is published to `docs.openstack.org`_  by the
maintainers.

Contributing
------------
Install the git-review package to make life easier

.. code-block:: shell

    pip install git-review


Branch, work, & submit:

.. code-block:: shell

    # 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)

.. code-block:: shell

    tox -e py27 -- designate.tests.test_central.test_service.CentralServiceTest.test_count_zones_policy_check



* Free software: Apache license
* Documentation: http://docs.openstack.org/developer/designate
* Source: http://git.openstack.org/cgit/openstack/designate
* Bugs: http://bugs.launchpad.net/designate


.. _OpenStack Gerrit Workflow: http://docs.openstack.org/infra/manual/developers.html#development-workflow
.. _docs.openstack.org: http://docs.openstack.org/developer/designate



