The official Recurly API client
Recurly’s Python client library is an interface to its REST API.
The minimum supported requirements for this library are:
Recurly is packaged as a Python package. We recommend you install it with PyPI by adding it to your requirements.txt:
pip install recurly
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'
To run these tests, use the
unittest test runner:
$ python -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 python -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
Please see the Recurly API for more information.
If you have general questions about the library or integration, you may find some of us in the #recurly irc channel on the Freenode network.