Metadata-Version: 2.0
Name: stronglib
Version: 0.1.4
Summary: A Python library for STRONGARM API
Home-page: http://strongarm.io/
Author: Percipient Networks, LLC
Author-email: support@percipientnetworks.com
License: Apache 2.0
Download-URL: https://github.com/percipient/stronglib
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Networking
Requires-Dist: requests (==2.7.0)
Requires-Dist: six (==1.9.0)

stronglib
=========

stronglib is an Apache2 licensed Python library for the
`STRONGARM <http://strongarm.io>`_
`API <https://strongarm.percipientnetworks.com/api/>`_.

.. image:: https://travis-ci.org/percipient/stronglib.svg?branch=master
    :target: https://travis-ci.org/percipient/stronglib

.. image:: https://coveralls.io/repos/percipient/stronglib/badge.svg?branch=master
    :target: https://coveralls.io/github/percipient/stronglib

features
--------

- token authentication
- get, create, and delete blackholed domains

installation
------------

The **latest release** can be installed from PyPI:

.. code-block:: bash

  $ pip install --upgrade stronglib

The **latest development version** can be installed directly from GitHub:

.. code-block:: bash

    $ pip install --upgrade https://github.com/percipient/stronglib/tarball/master

usage
-----

.. code-block:: python

    import strongarm

    # token authentication
    strongarm.api_key = 'your_api_token'

    # get (ie, search) a single Domain
    domain = strongarm.Domain.get('example.com')
    print(domain.name)

    # list all blackholed domains
    for domain in strongarm.Domain.all():
        print(domain.name)

    # create a new blackholed domain
    domain = strongarm.Domain.create(name='example.com')

    # delete a blackholed domain
    domain.delete()

contribute
----------

#. Check for open issues or open a fresh issue to start a discussion
   around a feature idea or a bug.
#. If you feel uncomfortable or uncertain about an issue or your changes,
   feel free to email support@percipientnetworks.com and we will happily help you.
#. Fork `the repository`_ on GitHub to start making your changes to the
   **master** branch (or branch off of it).
#. Write a test which shows that the bug was fixed or that the feature
   works as expected.
#. Send a pull request and bug the maintainer until it gets merged and
   published. :) Make sure to add yourself to AUTHORS_.

.. _the repository: http://github.com/percipient/stronglib
.. _AUTHORS: https://github.com/percipient/stronglib/blob/master/AUTHORS.rst


