added failing tests for request object
handle request objects
documented request object api
0.2.0