The official Recurly API client
Project description
Recurly’s Python client library is an interface to its REST API.
Python Versions
The minimum supported requirements for this library are:
Python >= 2.7.9
OpenSSL >= 1.0.1
Installation
Recurly is packaged as a Python package. We recommend you install it with PyPI by adding it to your requirements.txt:
pip install recurly
Configuration
Set your API key and optionally set a certificate authority certificate file and default currency:
import recurly recurly.SUBDOMAIN = 'your-subdomain' recurly.API_KEY = '012345678901234567890123456789ab' # Set a certificate authority certs file to validate Recurly's certificate recurly.CA_CERTS_FILE = '/etc/pki/tls/certs/ca-bundle.crt' # Set a default currency for your API requests recurly.DEFAULT_CURRENCY = 'USD'
A Note on Headers
In accordance with section 4.2 of RFC 2616, HTTP header fields are case-insensitive.
Recurly Python Client Tests
_NOTE_: The unit tests require certain packages to be installed on your system. Install the following packages with pip:
$ pip install defusedxml six mock iso8601 backports.ssl-match-hostname
To run these tests, use the unittest test runner with the RECURLY_INSECURE_DEBUG environment variable set to ‘true’:
$ RECURLY_INSECURE_DEBUG=true python3 -m unittest discover -s tests
The resource tests in test_resources.py will run using the HTTP fixtures in tests/fixtures. To run the tests against a live Recurly API endpoint, configure your Recurly test account and use its API key in the RECURLY_API_KEY environment variable:
$ RECURLY_API_KEY=1274…54e3 python3 -m unittest tests.test_resources
The live Recurly API endpoint can also be tested while validating the server certificate with the RECURLY_CA_CERTS_FILE environment variable, which should be a filename of concatenated certificate authority X.509 certificates:
$ RECURLY_API_KEY=1274…54e3 RECURLY_CA_CERTS_FILE=/etc/pki/tls/certs/ca-bundle.crt -m unittest tests.test_resources
Usage
Please see the Recurly API for more information.
Support
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for recurly-2.10.16-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 836bd10fbfe418969a848aebb8794ceeb1b8d4424fc57354822db15b9cafcdee |
|
MD5 | f2252e350b6ca62394bdcdd06767ce48 |
|
BLAKE2b-256 | 4905fd4c9f936888fd21a5187ead902eda4af441fd82de118b47f82b5a52e933 |