Name | Date | Size | #Lines | LOC | ||
---|---|---|---|---|---|---|
.. | 03-May-2022 | - | ||||
docs/ | H | 19-Dec-2019 | - | 454 | 191 | |
tests/ | H | 19-Dec-2019 | - | 1,933 | 1,736 | |
uritemplate/ | H | 19-Dec-2019 | - | 732 | 512 | |
uritemplate.egg-info/ | H | 03-May-2022 | - | 174 | 120 | |
AUTHORS.rst | H A D | 02-Dec-2019 | 233 | 16 | 12 | |
HISTORY.rst | H A D | 19-Dec-2019 | 1.6 KiB | 82 | 51 | |
LICENSE | H A D | 02-Dec-2019 | 196 | 4 | 3 | |
LICENSE.APACHE | H A D | 02-Dec-2019 | 11.1 KiB | 203 | 169 | |
LICENSE.BSD | H A D | 02-Dec-2019 | 1.3 KiB | 24 | 21 | |
MANIFEST.in | H A D | 02-Dec-2019 | 237 | 13 | 10 | |
PKG-INFO | H A D | 19-Dec-2019 | 5.8 KiB | 174 | 120 | |
README.rst | H A D | 02-Dec-2019 | 1.8 KiB | 64 | 43 | |
setup.cfg | H A D | 19-Dec-2019 | 74 | 8 | 5 | |
setup.py | H A D | 19-Dec-2019 | 1.6 KiB | 50 | 43 |
README.rst
1uritemplate 2=========== 3 4Documentation_ -- GitHub_ -- Travis-CI_ 5 6Simple python library to deal with `URI Templates`_. The API looks like 7 8.. code-block:: python 9 10 from uritemplate import URITemplate, expand 11 12 # NOTE: URI params must be strings not integers 13 14 gist_uri = 'https://api.github.com/users/sigmavirus24/gists{/gist_id}' 15 t = URITemplate(gist_uri) 16 print(t.expand(gist_id='123456')) 17 # => https://api.github.com/users/sigmavirus24/gists/123456 18 19 # or 20 print(expand(gist_uri, gist_id='123456')) 21 22 # also 23 t.expand({'gist_id': '123456'}) 24 print(expand(gist_uri, {'gist_id': '123456'})) 25 26Where it might be useful to have a class 27 28.. code-block:: python 29 30 import requests 31 32 class GitHubUser(object): 33 url = URITemplate('https://api.github.com/user{/login}') 34 def __init__(self, name): 35 self.api_url = url.expand(login=name) 36 response = requests.get(self.api_url) 37 if response.status_code == 200: 38 self.__dict__.update(response.json()) 39 40When the module containing this class is loaded, ``GitHubUser.url`` is 41evaluated and so the template is created once. It's often hard to notice in 42Python, but object creation can consume a great deal of time and so can the 43``re`` module which uritemplate relies on. Constructing the object once should 44reduce the amount of time your code takes to run. 45 46Installing 47---------- 48 49:: 50 51 pip install uritemplate 52 53License 54------- 55 56Modified BSD license_ 57 58 59.. _Documentation: https://uritemplate.readthedocs.io/ 60.. _GitHub: https://github.com/python-hyper/uritemplate 61.. _Travis-CI: https://travis-ci.org/python-hyper/uritemplate 62.. _URI Templates: http://tools.ietf.org/html/rfc6570 63.. _license: https://github.com/python-hyper/uritemplate/blob/master/LICENSE 64