Metadata-Version: 1.1
Name: tonicdnscli
Version: 0.1
Summary: TonicDNS CLI tool
Home-page: https://github.com/mkouhei/tonicdnscli
Author: Kouhei Maeda
Author-email: mkouhei@palmtb.net
License:  GNU General Public License version 3
Description: `tonicdnscli` is TonicDNS Client tool.
        ======================================
        
        This command line tool for TonicDNS API.
        TonicDNS is  RESTful API for PowerDNS.
        Convert readble text record to JSON, and create or delete zone records with TonicDNS.
        
        Requirements
        ------------
        
        * Python 2.7 or later (not support 3.x)
        
        Setup
        -----
        ::
        
           $ git clone https://github.com/mkouhei/tonicdnscli
           $ cd tonicdnscli
           $ sudo python setup.py install
           
        History
        -------
        0.1 (2012-04-20)
        ~~~~~~~~~~~~~~~~
        * first release
        
        Usage
        -----
        
        Input file (example.org.txt)
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        ::
        
           # name type content ttl priority
           test0.example.org A 10.10.10.10 86400
           test1.example.org A 10.10.10.11 86400
           test2.example.org A 10.10.10.12 86400
           example.org MX mx.example.org 86400 0
           example.org MX mx2.example.org 86400 10
           mx.example.org A 10.10.11.10 3600
           mx2.example.org A               10.10.11.10 3600
        
        Print converted JSON
        ~~~~~~~~~~~~~~~~~~~~
        ::
        
           $ tonicdnscli -o sample/example.org.txt
           {
             "records": [
               {
                 "content": "10.10.10.10", 
                 "name": "test0.example.org", 
                 "ttl": "86400", 
                 "type": "A"
               }, 
               {
                 "content": "10.10.10.11", 
                 "name": "test1.example.org", 
                 "ttl": "86400", 
                 "type": "A"
               }, 
               {
                 "content": "10.10.10.12", 
                 "name": "test2.example.org", 
                 "ttl": "86400", 
                 "type": "A"
               }, 
           (snip)
        
        Retrieve records
        ~~~~~~~~~~~~~~~~
        ::
        
           $ tonicdnscli -g -s ns.example.org -u tonicusername -p tonicpassword sample/example.org.txt
           {
             "name": "example.org", 
             "notified_serial": "2012021402", 
             "records": [
               {
                 "content": "ns.example.org hostmaster.example.org 2012021402", 
                 "name": "example.org", 
                 "priority": null, 
                 "ttl": "86400", 
                 "type": "SOA"
               }, 
               {
                 "content": "ns.example.org", 
                 "name": "example.org", 
                 "priority": null, 
                 "ttl": "86400", 
                 "type": "NS"
               }, 
           (snip)
        
        Create records
        ~~~~~~~~~~~~~~
        ::
        
           $ tonicdnscli -c -s ns.example.org -u tonicusername -p tonicpassword sample/example.org.txt
           True
        
        Delete records
        ~~~~~~~~~~~~~~~
        ::
        
           $ tonicdnscli -d -s ns.example.org -u tonicusername -p tonicpassword sample/example.org.txt
           True
        
        
        
        
        
        ToDo
        ====
        
        Features
        --------
        
        * Checking existing records When create or delete records.
        * Updating records.
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: Name Service (DNS)
Classifier: Topic :: System :: Systems Administration
