portale 0.5

Requests based HTTP/REST API client with flexible cache support

Portale is minimalistic requests based HTTP/REST API client.

Big advantage it has over other libraries is it also lets you configure cache timeout policy for each of the APIs independently.

Simple example

from portale import PrefixedURLSession, GETRequest, GETJSONRequest

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

get_thing = GETRequest(session, 'anything?thing={0}', timeout=10)
long_request = GETJSONRequest(session, '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