Skip to main content

An asynchronous wrapper around Stripe's official python library.

Project description

async-stripe

An asynchronous wrapper around Stripe's official python library.

How it works

async-stripe monkey-patches the stripe library and replaces the synchronous http request methods with asynchronous methods.

Monkey-patching allows us to avoid a complete rewrite and keep the usage api similar to the official library.

This doesn't use threads, but actual async coroutines and non-blocking http client to make requests.

Install

Install requires Python 3.6 or newer.

$ pip install async-stripe

Usage

The usage api is similar to Stripe's official library:

from async_stripe import stripe

stripe.api_key = '<stripe-secret-key>'

payment_intent = await stripe.PaymentIntent.create(amount=1000, currency='usd')

print(payment_intent.id)

/!\ Note: Since this library monkey-patches the actual stripe library, you should avoid using the two in the same process.

Once you import async_stripe, the official stripe library gets patched with async methods and the original synchronous api won't be available.


Development and Testing

When adding new features and monkey-patches, please add relevant tests and ensure that all the tests also pass.

For testing, first, install and run the stripe-mock api server.

Next, install pytest, pytest-mock and pytest-asyncio python packages in your virtualenv.

Finally, run the tests like this:

$ pytest tests

# or run a specific test
$ pytests tests/api_resources/test_customer.py
$ pytests tests/api_resources/test_customer.py::TestCustomer

License

A lot of the code (especially tests) are copied with slight modifications from Stripe's official library. That code is licensed under MIT License.

Rest of the original code is licensed under BSD-3-Clause License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

async-stripe-1.0.0b1.tar.gz (15.9 kB view hashes)

Uploaded Source

Built Distribution

async_stripe-1.0.0b1-py3-none-any.whl (34.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page