portale 0.7.1

Requests based HTTP/REST API client with flexible cache support

Portale is minimalistic requests based HTTP/REST API client.

Advantage over other libraries: Allows different cache timeout policy for each API

Simple example

from portale import PrefixedURLSession

session = PrefixedURLSession('https://httpbin.org/')

get_thing = session.GETRequest('anything?thing={0}', timeout=10)
long_request = session.GETJSONRequest('delay/{n}', timeout=20)

thing = get_thing('snake')

result = long_request(n=2)
result = long_request(n=2)  # cached response

Cache

Busting cache

long_request.cache.bust(n=n)

Access cache metrics

print(long_request.cache.metrics)

Tests

nosetests -xv tests.py