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

About the developer

129 Stars 12 Forks BSD 3-Clause "New" or "Revised" License 52 Commits 3 Opened issues


A Tornado async HTTP/HTTPS client adaptor for python-requests

Services available


Need anything else?

Contributors list

No Data


.. image::

A Tornado async HTTP/HTTPS client adapter for python-requests.

The problem

You enjoy using

_ to build fast non-blocking web applications, and you want to use a library from PyPI that makes a few HTTP requests, but pretty much every dev and their dog uses
_ to make HTTP requests (rightly so, because it's awesome), but requests has no knowledge of the event loop nor can it yield when a socket blocks, which means any time you try to use a library like that it begins to block your request handling and grud-knows what other worlds of pain.

The solution

Luckily there are solutions, one such is to use the

_ module to wrap blocking operations and swap Tornado coroutines at the right time, there is even the handy
_ module which handles this for you.

To make life even easier, you lucky lucky people, I've created

, an async Requests adapter which uses greenlets (via tornalet) and the inbuilt non-blocking HTTP client methos in Tornado, to make any call to a library (utilizing Requests) non-blocking.


.. code-block:: bash

$ pip install trequests


.. code-block:: python

# Assume bobs_big_data uses python-requests for HTTP requests
import bobs_big_data

from tornado.web import RequestHandler from trequests import setup_session from tornalet import tornalet

Tell requests to use our AsyncHTTPadapter for the default

session instance, you can also pass you own through


class WebHandler(RequestHandler): @tornalet def get(self): data = {'foo': 'bar'} # This will now unblock the current coroutine, like magic response = bobs_big_data.BigData(data).post() return self.write(response)


To run the basic testsuite hit up

python test


has been used in production in a large scale metrics application, and is a very small and quite simple module.

However I've released it as

mainly because it's missing 100% compatibility with the Requests adapter API, most noticeably cookie jar and session support, which I will improve (or please send me a pull request if you fancy adding support), and release as a
branch when I have the time.

Also at the moment the

utility actually monkey patches the
utility functions in Requests, as this was the only way I could see to override the mounts on "default" session instances (e.g. those created for every call when a session isn't provided). I'm hoping to change this in the future.

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.