Metadata-Version: 1.1
Name: recurly
Version: 2.3.2
Summary: The official Recurly API client
Home-page: https://recurly.readme.io/v2.0/page/python
Author: Recurly
Author-email: support@recurly.com
License: MIT
Description: *********************
        Recurly Python Client
        *********************
        .. image:: https://travis-ci.org/recurly/recurly-client-python.png?branch=master
         :target: https://travis-ci.org/recurly/recurly-client-python
        
        Recurly's Python client library is an interface to its `REST API <https://dev.recurly.com>`_.
        
        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 <https://pypi.python.org/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'
        
        
        Recurly Python Client Tests
        ---------------------------
        
        To run these tests in Python 2.7, use the `unittest` test runner:
        
            $ python -m unittest discover -s tests
        
        Under Python 2.6 or earlier, install the `unittest2` distribution and use it
        instead:
        
            $ pip install unittest2  # or easy_install
            $ python -m unittest2 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
        
        
        Usage
        -----
        
        Please see the `Recurly API <https://dev.recurly.com/docs/getting-started>`_ for more information.
        
        
        Support
        -------
        
        - `https://support.recurly.com <https://support.recurly.com>`_
        - `stackoverflow <http://stackoverflow.com/questions/tagged/recurly>`_
        
        IRC
        ---
        
        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.
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
