paste.urlmap – Map URL paths

Map URL prefixes to WSGI applications. See URLMap

Module Contents

class paste.urlmap.URLMap(not_found_app=None)

URLMap instances are dictionary-like object that dispatch to one of several applications based on the URL.

The dictionary keys are URLs to match (like PATH_INFO.startswith(url)), and the values are applications to dispatch to. URLs are matched most-specific-first, i.e., longest URL first. The SCRIPT_NAME and PATH_INFO environmental variables are adjusted to indicate the new context.

URLs can also include domains, like http://blah.com/foo, or as tuples ('blah.com', '/foo'). This will match domain names; without the http://domain or with a domain of None any domain will be matched (so long as no other explicit domain matches).

paste.urlmap.urlmap_factory(loader, global_conf, **local_conf)
class paste.urlmap.PathProxyURLMap(map, base_paste_url, base_path, builder)

This is a wrapper for URLMap that catches any strings that are passed in as applications; these strings are treated as filenames (relative to base_path) and are passed to the callable builder, which will return an application.

This is intended for cases when configuration files can be treated as applications.

base_paste_url is the URL under which all applications added through this wrapper must go. Use "" if you want this to not change incoming URLs.

Python Paste

Table Of Contents

This Page