1. Ian Cordasco
  2. uritemplate

Source

uritemplate /

Filename Size Date modified Message
docs
tests
uritemplate
93 B
Update gitignore
524 B
Use Travis CI's new Docker infra
79 B
Add package metadata files
594 B
Update history in prep for new version
1.3 KB
Add license and more info to the README
194 B
Clean up and actually run tests from fixtures
1.9 KB
updaing README to show how only strings are supported'
1.4 KB
Clean up and actually run tests from fixtures
236 B
Pass along {posargs} to pytest

uritemplate

Documentation -- GitHub -- BitBucket -- Travis-CI

Simple python library to deal with URI Templates. The API looks like

from uritemplate import URITemplate, expand

# NOTE: URI params must be strings not integers

gist_uri = 'https://api.github.com/users/sigmavirus24/gists{/gist_id}'
t = URITemplate(gist_uri)
print(t.expand(gist_id='123456'))
# => https://api.github.com/users/sigmavirus24/gists/123456

# or
print(expand(gist_uri, gist_id='123456'))

# also
t.expand({'gist_id': '123456'})
print(expand(gist_uri, {'gist_id': '123456'}))

Where it might be useful to have a class

import requests

class GitHubUser(object):
    url = URITemplate('https://api.github.com/user{/login}')
    def __init__(self, name):
        self.api_url = url.expand(login=name)
        response = requests.get(self.api_url)
        if response.status_code == 200:
            self.__dict__.update(response.json())

When the module containing this class is loaded, GitHubUser.url is evaluated and so the template is created once. It's often hard to notice in Python, but object creation can consume a great deal of time and so can the re module which uritemplate relies on. Constructing the object once should reduce the amount of time your code takes to run.

Installing

pip install uritemplate.py

License

Modified BSD license