Metadata-Version: 1.1
Name: pynamedotcom
Version: 0.1.0
Summary: UNKNOWN
Home-page: https://github.com/benmaddison/pynamedotcom
Author: Ben Maddison
Author-email: benm@workonline.co.za
License: MIT
Download-URL: https://github.com/benmaddison/pynamedotcom/0.1.0
Description: .. raw:: html
        
           <!--description: A python library to interact with the name.com api. -->
        
        |PyPI| |Build Status| |codecov| |Requirements Status|
        
        pynamedotcom
        ============
        
        A python library to interact with the name.com api
        
        Installation
        ------------
        
        .. code:: bash
        
            $ pip install pynamedotcom
        
        API Usage
        ---------
        
        .. code:: python
        
            >>> # read authentication details
            ...
            >>> import json
            >>> with open("tests/auth.json") as f:
            ...     auth = json.load(f)
            ...
            >>> # initialise api
            ...
            >>> import pynamedotcom
            >>> host = "api.dev.name.com"
            >>> # get domains
            ...
            >>> with pynamedotcom.API(host=host, **auth) as api:
            ...     for domain_name in api.domains:
            ...         print(domain_name)
            ...
            wolcomm.net
            maddison.family
            >>>
            >>> # fetch domain object
            ...
            >>> with pynamedotcom.API(host=host, **auth) as api:
            ...     domain = api.domain(name="maddison.family")
            ...
            >>> domain
            Domain(maddison.family)
            >>>
            >>> # get/set domain properties
            ...
            >>> domain.name
            u'maddison.family'
            >>> domain.nameservers
            [u'ns1.example.com', u'ns2.example.com']
            >>> domain.nameservers = ['foo.example.org', 'bar.example.org']
            >>> domain.nameservers
            [u'foo.example.org', u'bar.example.org']
        
        CLI Usage
        ---------
        
        See ``namedotcom --help``
        
        .. |PyPI| image:: https://img.shields.io/pypi/v/pynamedotcom.svg
           :target: https://pypi.python.org/pypi/pynamedotcom
        .. |Build Status| image:: https://travis-ci.org/benmaddison/pynamedotcom.svg?branch=master
           :target: https://travis-ci.org/benmaddison/pynamedotcom
        .. |codecov| image:: https://codecov.io/gh/benmaddison/pynamedotcom/branch/master/graph/badge.svg
           :target: https://codecov.io/gh/benmaddison/pynamedotcom
        .. |Requirements Status| image:: https://requires.io/github/benmaddison/pynamedotcom/requirements.svg?branch=master
           :target: https://requires.io/github/benmaddison/pynamedotcom/requirements/?branch=master
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet
