Metadata-Version: 1.1
Name: gcpdns
Version: 1.2.9
Summary: A Python module and CLI for managing zones and resource record sets on Google Cloud DNS
Home-page: https://domainaware.github.io/gcpdns
Author: Sean Whalen
Author-email: whalenster@gmail.com
License: Apache 2.0
Description: ======
        gcpdns
        ======
        
        A Python module and CLI for managing zones and resource record sets on Google Cloud DNS
        
        Features
        --------
        
        - Dump all project zones names in CSV and/or JSON format
        - Dump all zone resource record sets in CSV and/or JSON format
        - Create and delete zones via CLI or CSV
        - Create and delete resource record sets via CLI
        - Update DNS resource records for multiple zones in one project using one CSV
          file
        - Automatically split ``TXT`` records longer than 255 characters when publishing
        - Automatically add an ending ``.`` to records when needed
        
        CLI
        ---
        
        ::
        
            Usage: gcpdns [OPTIONS] CREDENTIAL_FILE COMMAND [ARGS]...
        
              gcpdns: A CLI for managing zones and resource record sets on Google Cloud
              DNS.
        
            Options:
              --version  Show the version and exit.
              --verbose  Enable verbose logging.
              --help     Show this message and exit.
        
            Commands:
              record  Manage DNS resource record sets.
              zone    Manage DNS zones.
        
        
        gcpdns record
        ~~~~~~~~~~~~~
        
        ::
        
            Usage: gcpdns record [OPTIONS] COMMAND [ARGS]...
        
              Manage DNS resource record sets.
        
            Options:
              --help  Show this message and exit.
        
            Commands:
              create  Create a resource record set (Data fields separated by |).
              delete  Delete a resource record set
              dump    Dump a list of DNS resource records.
              update  Create, replace, and delete resource record sets using a CSV file.
        
        gcpdns zone
        ~~~~~~~~~~~
        
        ::
        
            Manage DNS zones.
        
            Options:
              --help  Show this message and exit.
        
            Commands:
              create  Create a DNS zone.
              delete  Delete a DNS zone and all its resource records.
              dump    Dump a list of DNS zones.
              update  Create and delete zones using a CSV file.
        
        Installation
        ------------
        
        Use ``pip`` (or ``pip3`` for Python 3).
        
        ::
        
            sudo -H pip install gcpdns
        
        Setup
        -----
        
        To use ``gcpdns``, you'll need a separate `service account`_ credentials JSON
        file for each GCP project that you want to work with.
        
        Ensure that the Service Account has the proper permissions to edit DNS
        (e.g. the DNS Administrator role) in the project.
        
        Zone CSV fields
        ---------------
        
        - ``action``
        
          - ``create`` - Creates a zone
          - ``delete`` - Deletes a zone
        
        - ``dns_name``    - The zone's DNS name
        - ``gcp_name``    - The zone's name in GCP (optional)
        - ``description`` - The zone's description (optional)
        
        
        
        Record CSV fields
        -----------------
        
        - ``action``
        
          - ``create`` - Creates a resource record set
          - ``replace`` - The same as ``create``, but will replace an existing resource
            record set with the same ``name`` and ``record_type`` (if it exists)
          - ``delete`` - Deletes a resource record set
        
        - ``name`` - The record set name (i.e. the Fully-Qualified Domain Name)
        - ``record_type`` - The DNS record type
        - ``ttl`` - DNS time to live (in seconds)
        - ``data`` - DNS record data separated by ``|``
        
        .. _service account: https://cloud.google.com/iam/docs/creating-managing-service-accounts
        
Keywords: Google Cloud,GCP,DNS
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.0
Classifier: Programming Language :: Python :: 3.1
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
