demands 3.0.0

HTTPServiceClient Overview

• base class for creating service clients

• provides flexible way of http error handling for descendants

• HTTPServiceError raised on unexpected service response

• Supports pre-send and post-send hooks

Usage

from demands import HTTPServiceClient

class MyService(HTTPServiceClient):
    def get_user(self, user_id):
        return self.get('/users/%s/' % user_id).json()

    def safe_get_user(self, user_id, default_user):
        response = self.get(
            '/users/%s/' % user_id,
            expected_response_codes=[404])
        return response.json() if response.is_ok else default_user


service = MyService(url='http://localhost/')
user = service.get_user(1234)

Any parameters passed to the constructor will also be used for each and every request:

service = MyService(
    url='http://localhost/',
    headers={'h1':'value'},
    auth=('username','pass'),
)

# sent with auth and both headers
user = service.get('/some-path', headers={'h2': 'kittens'})

Testing

Install development requirements:

pip install -r requirements.txt

Run the tests with:

nosetests

API documentation

To generate the documentation:

cd docs && PYTHONPATH=.. make singlehtml