Metadata-Version: 1.2
Name: designate
Version: 10.0.2
Summary: DNS as a Service
Home-page: https://docs.openstack.org/designate/latest/
Author: OpenStack
Author-email: openstack-discuss@lists.openstack.org
License: UNKNOWN
Description: ========================
        Team and repository tags
        ========================
        
        .. image:: https://governance.openstack.org/tc/badges/designate.svg
            :target: https://governance.openstack.org/tc/reference/tags/index.html
        
        .. Change things from this point on
        
        ===================
        OpenStack Designate
        ===================
        
        Designate is an OpenStack project, providing DNSaaS.
        
        IRC: #openstack-dns @ freenode
        
        Installation: https://docs.openstack.org/designate/latest/
        
        API
        ---
        
        To learn how to use Designate's API, consult the documentation available
        online at:
        
        - `DNS API Reference <https://docs.openstack.org/api-ref/dns/>`__
        
        For more information on OpenStack APIs, SDKs and CLIs in general, refer to:
        
        - `OpenStack for App Developers <https://www.openstack.org/appdev/>`__
        - `Development resources for OpenStack clouds
          <https://developer.openstack.org/>`__
        
        Development
        ===========
        
        Designate follows the `OpenStack Gerrit Workflow`_
        
        Setup
        -----
        
        Setup a working environment:
        
        .. code-block:: bash
        
            git clone https://opendev.org/openstack/designate
            cd designate
            virtualenv .venv
            . .venv/bin/activate
            pip install -r requirements.txt -r test-requirements.txt
            pip install -e .
        
        Building Docs
        -------------
        
        To build the documentation from the restructured text source, do the following:
        
        .. code-block:: bash
        
            tox -e docs
        
        Now point your browser at doc/build/html/index.html
        (the official documentation is published to `docs.openstack.org`_  by the
        maintainers.
        
        Testing
        -------
        
        Execute all unit tests
        
        .. code-block:: shell
        
            tox -e py36
        
        Execute only backend tests
        
        .. code-block:: shell
        
            tox -e py36 -- unit.backend
        
        Execute only a single test
        
        .. code-block:: shell
        
            tox -e py36 -- unit.backend.test_pdns4.PDNS4BackendTestCase.test_create_zone_success
        
        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
        
        Other Information
        -----------------
        
        * Free software: Apache license
        * Documentation: https://docs.openstack.org/designate/latest/
        * Release notes: https://docs.openstack.org/releasenotes/designate/
        * Source: https://opendev.org/openstack/designate
        * Bugs: https://bugs.launchpad.net/designate
        * Blueprints: https://blueprints.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/
        
        
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 :: Implementation :: CPython
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Internet :: Name Service (DNS)
Requires-Python: >=3.6
