Metadata-Version: 2.0
Name: cloudns-api
Version: 0.2
Summary: A python interface to the ClouDNS.net API
Home-page: https://github.com/hbradleyiii/cloudns_api
Author: Harold Bradley III
Author-email: harold@bradleystudio.net
License: MIT License
Download-URL: https://github.com/hbradleyiii/cloudns_api/archive/v0.2.tar.gz
Keywords: dns,dns api,domain name system,cloudns,server development
Platform: UNKNOWN
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5

cloudns_api
####
A python interface to the ClouDNS.net API
===========================================================

Please note that this is still in Beta. Use at your own risk.

This project is an independent project and is not endorsed by
`CloudNS.net <https://cloudns.net>`_.

The interface is designed to be simple and intuitive. Entities are represented
as modules and there is a simple list, create, update, and delete function
(when appropriate, ie, you cannot delete an SOA record) for each entity. Some
entities have functions specific to them, but whenever possible, the arguments
are consistent. The code reads pretty clearly.

For information on the `CloudNS.net <https://cloudns.net>`_ API see `here
<https://www.cloudns.net/wiki/article/41/>`_.


Installing and including in projects
====================================

Installing cloudns_api
---------------

.. code:: bash

    $ pip install cloudns_api

In order to authenticate correctly, create the following environment variables
(using your own credentials):

.. code:: bash

    export CLOUDNS_AUTH_USER=my_user
    export CLOUDNS_AUTH_PASSWORD=my_password


Running Tests
-------------

.. code:: bash

    $ cd <project directory>
    $ py.test

Importing and Basic Usage
-------------------------

.. code:: python

    >>> import cloudns_api

    >>> app = nwid.App()
    >>> app.window.add( {
            nwid.Title : { 'text' : 'An nwid App!' },
            nwid.LabeledTextBox : {
                'text' : 'Your input:',
                'validator' : App.validate_function,
                'name' :
                }
            nwid.Button : {
                'text' : 'Click me!',
                'click' : App.callback_function,
                }
            })

    >>> app.run()


----

Soli Deo gloria.


