treq is an HTTP library inspired by requests but written on top of Twisted's Agents.

It provides a simple, higher level API for making HTTP requests when using Twisted.

>>> from treq import get

>>> def done(response):
...     print response.code
...     reactor.stop()

>>> get("http://www.github.com").addCallback(done)

>>> from twisted.internet import reactor
>>> reactor.run()
200

For more info read the docs.

treq is hosted on GitHub.

Feel free to fork and send contributions over.

Install dependencies:

pip install -r requirements-dev.txt

Optionally install PyOpenSSL:

pip install PyOpenSSL

Run Tests (unit & integration):

trial treq

Lint:

pep8 treq
pyflakes treq

Build docs:

cd docs; make html