Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

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.

Files for nfsnapi, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size nfsnapi-0.3.0.tar.gz (5.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page