Metadata-Version: 2.1
Name: designate
Version: 5.0.2
Summary: DNS as a Service
Home-page: https://docs.openstack.org/designate/latest/
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
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Internet :: Name Service (DNS)
Requires-Dist: Babel (!=2.4.0,>=2.3.4)
Requires-Dist: eventlet (!=0.18.3,!=0.20.1,<0.21.0,>=0.18.2)
Requires-Dist: Flask (!=0.11,<1.0,>=0.10)
Requires-Dist: greenlet (>=0.3.2)
Requires-Dist: Jinja2 (!=2.9.0,!=2.9.1,!=2.9.2,!=2.9.3,!=2.9.4,>=2.8)
Requires-Dist: jsonschema (!=2.5.0,<3.0.0,>=2.0.0)
Requires-Dist: keystoneauth1 (>=3.1.0)
Requires-Dist: keystonemiddleware (>=4.12.0)
Requires-Dist: netaddr (!=0.7.16,>=0.7.13)
Requires-Dist: oslo.config (!=4.3.0,!=4.4.0,>=4.0.0)
Requires-Dist: oslo.concurrency (>=3.8.0)
Requires-Dist: oslo.messaging (!=5.25.0,>=5.24.2)
Requires-Dist: oslo.middleware (>=3.27.0)
Requires-Dist: oslo.log (>=3.22.0)
Requires-Dist: oslo.reports (>=0.6.0)
Requires-Dist: oslo.rootwrap (>=5.0.0)
Requires-Dist: oslo.serialization (!=2.19.1,>=1.10.0)
Requires-Dist: oslo.service (>=1.10.0)
Requires-Dist: oslo.utils (>=3.20.0)
Requires-Dist: Paste
Requires-Dist: PasteDeploy (>=1.5.0)
Requires-Dist: pbr (!=2.1.0,>=2.0.0)
Requires-Dist: pecan (!=1.0.2,!=1.0.3,!=1.0.4,!=1.2,>=1.0.0)
Requires-Dist: python-designateclient (>=1.5.0)
Requires-Dist: python-neutronclient (>=6.3.0)
Requires-Dist: requests (>=2.14.2)
Requires-Dist: tenacity (>=3.2.1)
Requires-Dist: six (>=1.9.0)
Requires-Dist: SQLAlchemy (!=1.1.5,!=1.1.6,!=1.1.7,!=1.1.8,>=1.0.10)
Requires-Dist: sqlalchemy-migrate (>=0.11.0)
Requires-Dist: stevedore (>=1.20.0)
Requires-Dist: suds-jurko (>=0.6)
Requires-Dist: setuptools (!=24.0.0,!=34.0.0,!=34.0.1,!=34.0.2,!=34.0.3,!=34.1.0,!=34.1.1,!=34.2.0,!=34.3.0,!=34.3.1,!=34.3.2,!=36.2.0,>=16.0)
Requires-Dist: WebOb (>=1.7.1)
Requires-Dist: oslo.db (>=4.24.0)
Requires-Dist: oslo.i18n (!=3.15.2,>=2.1.0)
Requires-Dist: oslo.context (>=2.14.0)
Requires-Dist: oslo.policy (>=1.23.0)
Requires-Dist: Werkzeug (>=0.7)
Requires-Dist: python-memcached (>=1.56)
Requires-Dist: tooz (>=1.47.0)
Requires-Dist: debtcollector (>=1.2.0)
Requires-Dist: os-win (>=2.0.0)
Requires-Dist: monasca-statsd (>=1.1.0)
Requires-Dist: dnspython (>=1.14.0); (python_version=='2.7')
Requires-Dist: dnspython3 (!=1.13.0,!=1.14.0,>=1.12.0); (python_version>='3.0')

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

.. image:: https://governance.openstack.org/badges/designate.svg
    :target: https://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: https://docs.openstack.org/designate/latest/


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: https://docs.openstack.org/designate/latest/
* Source: https://git.openstack.org/cgit/openstack/designate
* Bugs: https://bugs.launchpad.net/designate


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



