Skip to main content

Elegant use of requests in gevent

Project description

gevent-requests: Asynchronous Requests


PyPI - License version pyversions PyPI - Downloads Pepy Total Downlods

gevent-requests allows you to use Requests with Gevent to make asynchronous HTTP Requests easily.

A fork from grequests <https://github.com/spyoungtech/grequests>.

It is highly recommended that you patch from the entry and do not include thread, this package does not include patch!

pip install gevent-requests

Usage is simple:

from gevent import monkey
monkey.patch_all(thread=False, select=False)
import gevent_requests

urls = [
    'http://www.heroku.com',
    'http://python-tablib.org',
    'http://httpbin.org',
    'https://shields.io',
    'http://fakedomain/',
]

Create a set of unsent Requests:

>>> rs = (gevent_requests.get(u) for u in urls)

Send them all at the same time:

>>> print(gevent_requests.gmap(rs))
[<Response [200]>, <Response [200]>, <Response [200]>, <Response [200]>, <Response [502]>]

Optionally, in the event of a timeout or any other exception during the connection of the request, you can add an exception handler that will be called with the request and exception inside the main thread:

>>> def exception_handler(request, exception):
...    print("Request failed")

>>> reqs = [
...    gevent_requests.get('http://httpbin.org/delay/1', timeout=0.001),
...    gevent_requests.get('http://fakedomain/'),
...    gevent_requests.get('http://httpbin.org/status/500')]
>>> print(gevent_requests.gmap(reqs, exception_handler=exception_handler))
Request failed
[None, <Response [502]>, <Response [500]>]

For some speed/performance gains, you may also want to use imap instead of map. imap returns a generator of responses. Order of these responses does not map to the order of the requests you send out. The API for imap is equivalent to the API for map.

Use indexed requests in gevent, use gimap_enumerate will yield a indexed requests just like enumerate return, an index and a response:

>>> rs = (gevent_requests.get(u) for u in urls)

>>> for i in gevent_requests.gimap_enumerate(rs, size=len(urls)):
        print(i)
(4, <Response [502]>)
(2, <Response [200]>)
(0, <Response [200]>)
(3, <Response [200]>)
(1, <Response [200]>)

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

gevent_requests-1.1.1.tar.gz (5.1 kB view hashes)

Uploaded Source

Built Distribution

gevent_requests-1.1.1-py3-none-any.whl (5.6 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