Metadata-Version: 1.1
Name: portale
Version: 0.7
Summary: Requests based HTTP/REST API client with flexible cache support
Home-page: http://pypi.python.org/pypi/portale/
Author: Shekhar Tiwatne
Author-email: pythonic@gmail.com
License: http://www.opensource.org/licenses/mit-license.php
Description-Content-Type: UNKNOWN
Description: Portale
        =======
        
        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
        --------------
        
        .. code-block:: python
        
            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
        
        .. code-block:: python
        
            long_request.cache.bust(n=n)
        
        Access cache metrics
        
        .. code-block:: python
        
            print(long_request.cache.metrics)
        
        
        Tests
        -----
        
        .. code-block:: python
        
            nosetests -xv tests.py
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
