Skip to main content

Stuff to make working with the NearlyFreeSpeech.NET API easier.

Project description

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

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.


>>> 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.

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.

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


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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
nfsnapi-0.3.0.tar.gz (5.6 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page