Need help with grequests?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

spyoungtech
3.9K Stars 336 Forks BSD 2-Clause "Simplified" License 84 Commits 9 Opened issues

Description

Requests + Gevent = <3

Services available

!
?

Need anything else?

Contributors list

GRequests: Asynchronous Requests

GRequests allows you to use Requests with Gevent to make asynchronous HTTP Requests easily.

|version| |pyversions|

Note: You should probably use

requests-threads 
_ or
requests-futures 
_ instead.

Usage

Usage is simple:

.. code-block:: python

import grequests

urls = [ 'http://www.heroku.com', 'http://python-tablib.org', 'http://httpbin.org', 'http://python-requests.org', 'http://fakedomain/', 'http://kennethreitz.com' ]

Create a set of unsent Requests:

.. code-block:: python

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

Send them all at the same time:

.. code-block:: python

>>> grequests.map(rs)
[, , , , None, ]

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:

.. code-block:: python

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

>>> reqs = [ ... grequests.get('http://httpbin.org/delay/1', timeout=0.001), ... grequests.get('http://fakedomain/'), ... grequests.get('http://httpbin.org/status/500')] >>> grequests.map(reqs, exception_handler=exception_handler) Request failed Request failed [None, None, ]

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
.

Installation

Installation is easy with pip::

$ pip install grequests
✨🍰✨

.. |version| image:: https://img.shields.io/pypi/v/grequests.svg?colorB=blue :target: https://pypi.org/project/grequests/

.. |pyversions| image:: https://img.shields.io/pypi/pyversions/grequests.svg? :target: https://pypi.org/project/grequests/

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.