SermonAudio.com API Client Library
==================================
This is the official Python client library for accessing the latest
[SermonAudio.com](http://www.sermonaudio.com/) APIs.
For documentation on the SermonAudio API, head to
[api.sermonaudio.com](http://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`.
Detailed documentation is included with each method. If you have any questions
about how to use these methods, or feel the docstrings could be improved,
send a message to developer@sermonaudio.com.
Installation Notes
------------------
This library is written in Python 3.6+. Please ensure that you have the latest
version of OpenSSL installed. If you are on a Mac, you may need to use
[homebrew](http://brew.sh) 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
from sermonaudio.node.requests import Node
# You must set your API key before making any requests
sermonaudio.set_api_key('YOUR-API-KEY')
sermon = Node.get_sermon('261601260')
# TODO: Something with this sermon
for sermon in Node.get_sermons(broadcaster_id='faith').results:
# TODO: Something with each sermon in the list
pass
```
All methods have docstrings, so you can refer to this documentation as you
write your application. We do encourage you to read the full documentation
referenced above for the most complete, up to date details.
Localization
------------
This client library provides some support for localization. It uses the os LANGUAGE
environment variable to determine the default language for client requests. You can override
the preferred language either globally or per-request. You can override it globally
using the top-level `set_preferred_language` function. All request methods also accept a
`preferred_language_override` keyword argument so you can override the desired language for
individual requests. The locale values are passed via the HTTP `Accept-Language` header,
and should follow that format. For example, `en-US` for US English.
User Authentication
-------------------
This library has some initial support for our user API's. It supports both cookie-based and
Authentication header-based token authentication. A basic example using cookie-based
authentication:
```
# Perform login
User.login(username, password)
# Retrieve user details
user = User.get_user()
```
Raw data
{
"_id": null,
"home_page": "http://api.sermonaudio.com/",
"name": "sermonaudio",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "sermon audio sermonaudio API preaching church bible",
"author": "SermonAudio.com",
"author_email": "info@sermonaudio.com",
"download_url": "https://files.pythonhosted.org/packages/ca/90/1bf99eb82937163561726114e00412bc212e7e26cd9d87cb023f6b0f165f/sermonaudio-6.15.2.tar.gz",
"platform": null,
"description": "SermonAudio.com API Client Library\n==================================\n\nThis is the official Python client library for accessing the latest\n[SermonAudio.com](http://www.sermonaudio.com/) APIs.\n\nFor documentation on the SermonAudio API, head to\n[api.sermonaudio.com](http://api.sermonaudio.com/). Proper Python type\nconversions have been made where appropriate (for example, dates are converted\nto `datetime.date` objects). API functions are grouped into modules by API\nfamily, just as in the main documentation (so Node API endpoint helpers are\nin the `node` module). Endpoint request methods are given an appropriate\nprefix such as `get`.\n\nDetailed documentation is included with each method. If you have any questions\nabout how to use these methods, or feel the docstrings could be improved,\nsend a message to developer@sermonaudio.com.\n\nInstallation Notes\n------------------\n\nThis library is written in Python 3.6+. Please ensure that you have the latest\nversion of OpenSSL installed. If you are on a Mac, you may need to use\n[homebrew](http://brew.sh) to install a new verison of python linked against\nthe updated version via `brew install python3 --with-brewed-openssl`.\nUnfortunately, older versions of OpenSSL do not support TLSv1.2. Older versions\nhave known security holes, so our server will refuse such connections.\nMake sure to use the new (brewed) version of python for your virtual environment.\n\nQuickstart\n----------\n\nThe API functions are straightforward. All API methods validate the response\nfrom the server, and return a logical value from the wrapped response, or throw\nan exception. For example, a node that returns a single result will return only\nthe first item in the results list, if one exists. Additionally, the object(s)\nreturned are mapped to the correct type of object. Here are some code samples\nto get you started.\n\n```\nimport sermonaudio\n\nfrom sermonaudio.node.requests import Node\n\n# You must set your API key before making any requests\nsermonaudio.set_api_key('YOUR-API-KEY')\n\nsermon = Node.get_sermon('261601260')\n# TODO: Something with this sermon\n\nfor sermon in Node.get_sermons(broadcaster_id='faith').results:\n # TODO: Something with each sermon in the list\n pass\n```\n\nAll methods have docstrings, so you can refer to this documentation as you\nwrite your application. We do encourage you to read the full documentation\nreferenced above for the most complete, up to date details.\n\nLocalization\n------------\n\nThis client library provides some support for localization. It uses the os LANGUAGE\nenvironment variable to determine the default language for client requests. You can override\nthe preferred language either globally or per-request. You can override it globally\nusing the top-level `set_preferred_language` function. All request methods also accept a\n`preferred_language_override` keyword argument so you can override the desired language for\nindividual requests. The locale values are passed via the HTTP `Accept-Language` header, \nand should follow that format. For example, `en-US` for US English.\n\n\nUser Authentication\n-------------------\n\nThis library has some initial support for our user API's. It supports both cookie-based and\nAuthentication header-based token authentication. A basic example using cookie-based\nauthentication:\n\n```\n# Perform login\nUser.login(username, password)\n\n# Retrieve user details\nuser = User.get_user()\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "The official Python client library for accessing the SermonAudio.com APIs",
"version": "6.15.2",
"project_urls": {
"Homepage": "http://api.sermonaudio.com/"
},
"split_keywords": [
"sermon",
"audio",
"sermonaudio",
"api",
"preaching",
"church",
"bible"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ae00e831f4516ee0ad119f9e0030f40f2a3661a98070146dff1ab7d1ae4ec62b",
"md5": "f59258ca23ffff56ee2220212da23270",
"sha256": "27c6faf2cb6a51e9c1cc93dd0f2a3bdd03776d5dc43d0d38b5aa23ab5142bb14"
},
"downloads": -1,
"filename": "sermonaudio-6.15.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f59258ca23ffff56ee2220212da23270",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 27511,
"upload_time": "2024-02-19T14:30:14",
"upload_time_iso_8601": "2024-02-19T14:30:14.076405Z",
"url": "https://files.pythonhosted.org/packages/ae/00/e831f4516ee0ad119f9e0030f40f2a3661a98070146dff1ab7d1ae4ec62b/sermonaudio-6.15.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ca901bf99eb82937163561726114e00412bc212e7e26cd9d87cb023f6b0f165f",
"md5": "5438620a4d10ccfe9d5a346b7efb9519",
"sha256": "fcb663c5580e9aa32f0772c5d735895889feb593d2ba68e1ec983794caff4dff"
},
"downloads": -1,
"filename": "sermonaudio-6.15.2.tar.gz",
"has_sig": false,
"md5_digest": "5438620a4d10ccfe9d5a346b7efb9519",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 33620,
"upload_time": "2024-02-19T14:30:16",
"upload_time_iso_8601": "2024-02-19T14:30:16.068769Z",
"url": "https://files.pythonhosted.org/packages/ca/90/1bf99eb82937163561726114e00412bc212e7e26cd9d87cb023f6b0f165f/sermonaudio-6.15.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-19 14:30:16",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "sermonaudio"
}
JSON