1. Ian Cordasco
  2. uritemplate


uritemplate /

Filename Size Date modified Message
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


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)
# => 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:

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.


pip install uritemplate.py


Modified BSD license