Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A simple httplib2 based asynchronous HTTP library for python

Project Description

asynchttp is an almost drop in replacement for httplib2 that provides asynchronous http request behavior.

asynchttp uses python threading and Queues and provides callback mechanisms to allow de-serialization and process to happen in the background (worker threads) as well. You can queue up arbitrary numbers of requests and a specified maximum number of workers will process each request in turn.

There are two known differences between straight httplib2 and asynchttp:

  • exceptions are thrown when the response and/or content is accessed. since sending the request and receiving the response is happening in the background exceptions won’t be thrown during the call to request.
  • content (returned from request) is an object rather than a plain string. This is required since the content isn’t actually known until the background worker has completed the request, the returned content is a “promise” object of sorts. It defines a __str__ method that should in most cases cause the object to behave as required, but unfortunately there may be times when you have to str(content) to force it in to a string to get the desired behavior. (a side note, but content should really be a buffer/io object rather than a plain string in the first place.)


A simple example making a single request (not that interesting):

>>> from asynchttp import Http
>>> http = Http()
>>> url = ''
>>> response, content = http.request(url)
# http.request will return immediately and response and content will be
# "promise" objects that will block (if necessary) when accessed. you
# could/should continue to do other work or send off more requests here and
# when you're ready...
>>> print response.status
# if the request had already completed in the background the status code
# would immediately print. if not the script would block until the work had
# completed and then print.

See the examples directory for more detailed/interesting examples.


Asynchronous code can be a pain to debug so asynchttp is pretty aggressive when it comes to logging. If you’re trying to track things down your best bet is probably to turn on debug logging, at least for the asynchttp logger, and to use a format that includes the the time and thread id or name.

Adding the following snippet to your app should do the trick:

import logging

fmt = '%(asctime)s %(thread)d %(name)s %(levelname)-8s %(message)s'
logging.basicConfig(level=DEBUG, format=format)
Release History

Release History

This version
History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
asynchttp-0.0.4.tar.gz (4.6 kB) Copy SHA256 Checksum SHA256 Source Oct 28, 2011

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting