restful_client 0.1

An asynchronous RESTful client library.

==============
restful_client
==============

restful_client is an asychronous library that assists in writing clients for
RESTful services.

A RESTClient is an extension of a urllib2.Request class that also contains its own HTTP opener
so the request can be executed and results passed through an (optional) call back mechanism.

The default_callback function in __init__ demonstrates the protocol that should be supported by
the callback function.

See http://docs.python.org/library/urllib2.html#request-objects for urllib2 Request documentation
and http://www.voidspace.org.uk/python/articles/urllib2.shtml
and http://www.doughellmann.com/PyMOTW/urllib2/ for useful usage notes.

TODO: Add support for timeouts at per client instance level (via opener).
TODO: May need to implement smart exception handling. When YOU start encountering reproducable
HTTP exceptions (or others) please contact Ben so he can see what exception handling strategy
would work best for this library.