Metadata-Version: 2.0
Name: designate
Version: 1.0.2
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: Programming Language :: Python :: 2.6
Classifier: Topic :: Internet :: Name Service (DNS)
Requires-Dist: Babel (>=1.3)
Requires-Dist: Flask (<1.0,>=0.10)
Requires-Dist: Jinja2 (>=2.6)
Requires-Dist: Paste
Requires-Dist: PasteDeploy (>=1.5.0)
Requires-Dist: SQLAlchemy (<1.1.0,>=0.9.9)
Requires-Dist: WebOb (>=1.2.3)
Requires-Dist: Werkzeug (>=0.7)
Requires-Dist: eventlet (>=0.17.4)
Requires-Dist: greenlet (>=0.3.2)
Requires-Dist: iso8601 (>=0.1.9)
Requires-Dist: jsonschema (<3.0.0,>=2.0.0,!=2.5.0)
Requires-Dist: keystonemiddleware (>=2.0.0,!=2.4.0)
Requires-Dist: netaddr (>=0.7.12,!=0.7.16)
Requires-Dist: oslo.concurrency (>=2.3.0)
Requires-Dist: oslo.config (>=2.3.0)
Requires-Dist: oslo.context (>=0.2.0)
Requires-Dist: oslo.db (>=2.4.1)
Requires-Dist: oslo.i18n (>=1.5.0)
Requires-Dist: oslo.log (>=1.8.0)
Requires-Dist: oslo.messaging (!=2.8.0,!=2.8.1,!=3.1.0,!=2.6.0,!=2.6.1,!=1.17.0,!=1.17.1,>=1.16.0,!=2.9.0,!=2.7.0)
Requires-Dist: oslo.middleware (!=3.2.0,!=3.0.0,!=3.1.0,>=2.8.0)
Requires-Dist: oslo.policy (>=0.5.0)
Requires-Dist: oslo.rootwrap (>=2.0.0)
Requires-Dist: oslo.serialization (>=1.4.0)
Requires-Dist: oslo.service (>=0.7.0)
Requires-Dist: oslo.utils (>=2.0.0,!=2.6.0)
Requires-Dist: pbr (>=1.6)
Requires-Dist: pecan (>=1.0.0)
Requires-Dist: psutil (<2.0.0,>=1.1.1)
Requires-Dist: python-designateclient (>=1.0.0)
Requires-Dist: python-memcached (>=1.56)
Requires-Dist: python-neutronclient (>=2.6.0)
Requires-Dist: requests (!=2.9.0,!=2.8.0,>=2.5.2)
Requires-Dist: setuptools (>=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.19.0)
Requires-Dist: Routes (>=1.12.3,!=2.0); (python_version!='2.7')
Requires-Dist: dnspython (>=1.12.0); (python_version<'3.0')
Requires-Dist: Routes (!=2.1,>=1.12.3,!=2.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



