sermonaudio 0.1.2

The official Python client library for accessing the SermonAudio.com APIs

This is the official Python client library for accessing the latest SermonAudio.com APIs.

For documentation on the SermonAudio API, head to api.sermonaudio.com. Proper Python type conversions have been made where appropriate (for example, dates are converted to datetime.date objects). API functions are grouped into modules by API family, just as in the main documentation (so Node API endpoint helpers are in the node module). Endpoint request methods are given an appropriate prefix such as get.

Installation Notes

This library is written in Python 3 (developed in 3.5). Please ensure that you have the latest version of OpenSSL installed. If you are on a Mac, you may need to use homebrew to install a new verison of python linked against the updated version via brew install python3 --with-brewed-openssl. Unfortunately, older versions of OpenSSL do not support TLSv1.2. Older versions have known security holes, so our server will refuse such connections. Make sure to use the new (brewed) version of python for your virtual environment.

Quickstart

The API functions are straightforward. All API methods validate the response from the server, and return a logical value from the wrapped response, or throw an exception. For example, a node that returns a single result will return only the first item in the results list, if one exists. Additionally, the object(s) returned are mapped to the correct type of object. Here are some code samples to get you started.

import sermonaudio.node

# You must set your API key before making any requests
sermonaudio.set_api_key('YOUR-API-KEY')

sermon = sermonaudio.node.get_sermon_info('261601260')
# TODO: Something with this sermon

for sermon in sermonaudio.node.get_sermons_by_source('faith'):
    # TODO: Something with each sermon in the list