Skip to content
A simple Python package that makes using the NearlyFreeSpeech.NET API a little easier.
Branch: master
Clone or download
Latest commit a774479 Apr 21, 2016



A simple Python package with a couple of functions (and an exception
class) that make working with the `NearlyFreeSpeech.NET API`_ easier.

.. _NearlyFreeSpeech.NET API:

``nfsnapi`` supports Python 2.7 and later, and Python 3.2 and later. For
general usage there are no prerequisites other than a supported version
of Python, however to test ``nfsnapi`` with Python 3.2 and earlier
versions the `mock`_ library is required.

.. _mock:



  >>> import nfsnapi
  >>> # Replace USERNAME, API_KEY, and so on with actual values.
  >>> nfsnapi.run_request("USERNAME", "API_KEY",
  ... "/account/ACCOUNT_NUMBER/balance")
  >>> nfsnapi.run_request("USERNAME", "API_KEY",
  ... "/dns/DOMAIN/listRRs", "type=A")
  (A bunch of JSON not shown.)
  >>> # And so on...


The usual ``python install`` dance will install ``nfsnapi`` if
grabbing the `source distribution`_. Alternatively, ``nfsnapi`` is
available from `PyPI`_ via your Python package manager of choice.

.. _source distribution:
.. _PyPI:

Documentation and Testing

The ``nfsnapi`` module is heavily documented. Running
```` will, funnily enough, run some tests. The tests
require a configuration file with API credentials and what-not (see
````'s docstring for more information), and the `mock`_
library if testing with Python 3.2 or earlier.

.. _mock:

There's support for `Tox`_, which will run the tests on all available
and supported versions of Python.

.. _Tox:


``nfsnapi`` was written by Damien Dart, <>. This is
free and unencumbered software released into the public domain. For more
information, please refer to the accompanying "UNLICENCE" file.
You can’t perform that action at this time.