Metadata-Version: 2.0
Name: designate
Version: 4.0.0
Summary: DNS as a Service
Home-page: http://docs.openstack.org/developer/designate
Author: OpenStack
Author-email: openstack-dev@lists.openstack.org
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 :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Internet :: Name Service (DNS)
Requires-Dist: Babel (>=2.3.4)
Requires-Dist: Flask (!=0.11,>=0.10,<1.0)
Requires-Dist: Jinja2 (!=2.9.1,>=2.8,!=2.9.0,!=2.9.4,!=2.9.3,!=2.9.2)
Requires-Dist: Paste
Requires-Dist: PasteDeploy (>=1.5.0)
Requires-Dist: SQLAlchemy (<1.1.0,>=1.0.10)
Requires-Dist: WebOb (>=1.6.0)
Requires-Dist: Werkzeug (>=0.7)
Requires-Dist: debtcollector (>=1.2.0)
Requires-Dist: eventlet (>=0.18.2,!=0.18.3)
Requires-Dist: greenlet (>=0.3.2)
Requires-Dist: jsonschema (<3.0.0,>=2.0.0,!=2.5.0)
Requires-Dist: keystoneauth1 (>=2.18.0)
Requires-Dist: keystonemiddleware (>=4.12.0)
Requires-Dist: monasca-statsd (>=1.1.0)
Requires-Dist: netaddr (!=0.7.16,>=0.7.13)
Requires-Dist: os-win (>=1.4.0)
Requires-Dist: oslo.concurrency (>=3.8.0)
Requires-Dist: oslo.config (!=3.18.0,>=3.14.0)
Requires-Dist: oslo.context (>=2.9.0)
Requires-Dist: oslo.db (>=4.15.0)
Requires-Dist: oslo.i18n (>=2.1.0)
Requires-Dist: oslo.log (>=3.11.0)
Requires-Dist: oslo.messaging (>=5.14.0)
Requires-Dist: oslo.middleware (>=3.0.0)
Requires-Dist: oslo.policy (>=1.17.0)
Requires-Dist: oslo.reports (>=0.6.0)
Requires-Dist: oslo.rootwrap (>=5.0.0)
Requires-Dist: oslo.serialization (>=1.10.0)
Requires-Dist: oslo.service (>=1.10.0)
Requires-Dist: oslo.utils (>=3.18.0)
Requires-Dist: pbr (>=1.8)
Requires-Dist: pecan (!=1.0.3,!=1.2,>=1.0.0,!=1.0.4,!=1.0.2)
Requires-Dist: python-designateclient (>=1.5.0)
Requires-Dist: python-memcached (>=1.56)
Requires-Dist: python-neutronclient (>=5.1.0)
Requires-Dist: requests (!=2.12.2,>=2.10.0)
Requires-Dist: retrying (!=1.3.0,>=1.2.3)
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.17.1)
Requires-Dist: suds-jurko (>=0.6)
Requires-Dist: tooz (>=1.47.0)
Requires-Dist: dnspython (>=1.14.0); (python_version=='2.7')
Requires-Dist: dnspython3 (!=1.14.0,>=1.12.0,!=1.13.0); (python_version>='3.0')

========================
Team and repository tags
========================

.. image:: http://governance.openstack.org/badges/designate.svg
    :target: http://governance.openstack.org/reference/tags/index.html

.. Change things from this point on

===================
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



