Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A tiny application that handles (cool) uri's.

Project Description

This very simple application is meant to be the handler on a domain that handles Cool Uri’s ( with 303 redirects.

All it does is map Uri’s to other uri’s and redirect them. To make thing easy you can either redirect by hitting the full URI (eg. or by querying a handle service (eg. Both of these will redirect you. The handle service also works for non-http URI’s. Finally, there’s a service that just returns information without performing a redirect, eg. This can be handy to bypass some of the strangeness that happens when you combine Cool uri’s with CORS and custom HTTP headers.

Configuration is done by editing a YAML file. For each URI you need to register a regex and a redirect template. The regex should use named placeholders, as well as the redirect string. An optional argument mount determines if your match is living at the server root or is absolute (eg. because it’s a URN). Not setting mount sets it to True.

0.3.0 (12-04-2016)

  • Added http caching to the /uris endpoint.

0.2.0 (28-09-2015)

  • Added a /uris endpoint that does not redirect, but just returns information.

0.1.0 (27-09-2015)

  • Initial version
  • Allows redirecting a a regular URI and with a query service.

Release History

This version
History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(7.3 kB) Copy SHA256 Hash SHA256
2.7 Wheel Apr 12, 2016
(5.6 kB) Copy SHA256 Hash SHA256
Source Apr 12, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting