<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Routes Changelog — Routes v1.12 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '#',
VERSION: '1.12',
COLLAPSE_MODINDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="search" type="application/opensearchdescription+xml"
title="Search within Routes v1.12 documentation"
href="_static/opensearch.xml"/>
<link rel="top" title="Routes v1.12 documentation" href="index.html" />
</head>
<body>
<div style="color: #D1361B; font-size: 70px; font-weight: bold; padding: 10px 0 0 10px;">Routes</div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="modindex.html" title="Global Module Index"
accesskey="M">modules</a> |</li>
<li><a href="index.html">Routes home</a> | </li>
<li><a href="contents.html">Documentation</a>»</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="routes-changelog">
<span id="changes"></span><h1>Routes Changelog<a class="headerlink" href="#routes-changelog" title="Permalink to this headline">¶</a></h1>
<div class="section" id="release-1-12-february-28-2010">
<h2>Release 1.12 (February 28, 2010)<a class="headerlink" href="#release-1-12-february-28-2010" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Split up the Routes docs.</li>
<li>Fix bug with relative URL’s using qualified merging host and URL without
including the appropriate slash. Fixes #13.</li>
<li>Fix bug with mapper.extend and Routes modifying their original args.
Fixes #24.</li>
<li>Fix url.current() not returning current args when explicit is True.</li>
<li>Added explicit way to directly use the Mapper to match with environ.</li>
<li>Fix bug with improper len placement for submapper.</li>
<li>Adding regular expression builder for entire regexp for faster rejection
in a single regexp match should none of the routes match.</li>
<li>Give Mapper a tabular string representation.</li>
<li>Make SubMapper objects nestable and add route-generation helpers.</li>
<li>Add SubMapper-based collections.</li>
<li>Make the deprecated Mapper.minimization False (disabled) by default.</li>
<li>Make the mapper explicit (true) by default.</li>
</ul>
</div>
<div class="section" id="release-1-11-september-28-2009">
<h2>Release 1.11 (September 28, 2009)<a class="headerlink" href="#release-1-11-september-28-2009" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Extensive documentation rewrite.</li>
<li>Added Mapper.extend function that allows one to add lists of Routes objects
to the mapper in one batch, optionally with a path_prefix.</li>
<li>Added Mapper.submapper function that returns a SubMapper object to enable
easier declaration of routes that have multiple keyword argument options
in common.</li>
<li>Mapper controller_scan argument now handles None, and lists of controller
names in addition to a callable.</li>
<li>Route object now takes a name parameter, which is the name it responds to.
This name is automatically added when called by using Mapper’s connect
class method.</li>
<li>Added optional LRU object for use with Routes when URL’s change too often
for the Routes urlcache dict to be a viable option.</li>
</ul>
</div>
<div class="section" id="release-1-10-3-february-8-2009">
<h2>Release 1.10.3 (February 8, 2009)<a class="headerlink" href="#release-1-10-3-february-8-2009" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Tweak to use WebOb Request rather than Paste.</li>
<li>Performance tweaks for URL recognition.</li>
<li>Bugfix for routes.middleware not re.escaping the path_info before moving it
to the script name.</li>
</ul>
</div>
<div class="section" id="release-1-10-2-january-11-2009">
<h2>Release 1.10.2 (January 11, 2009)<a class="headerlink" href="#release-1-10-2-january-11-2009" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Bugfix for unicode encoding problems with non-minimized Route generation.
Spotted by Wichert Akkerman.</li>
<li>Bugfix for when environ is {} in unit tests.</li>
</ul>
</div>
<div class="section" id="release-1-10-1-september-27-2008">
<h2>Release 1.10.1 (September 27, 2008)<a class="headerlink" href="#release-1-10-1-september-27-2008" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Removing LRU cache due to performance and threading issues. Cache does hit
a max-size for the given routes.</li>
</ul>
</div>
<div class="section" id="release-1-10-september-24-2008">
<h2>Release 1.10 (September 24, 2008)<a class="headerlink" href="#release-1-10-september-24-2008" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Adding LRU cache instead of just dict for caching generated routes. This
avoids slow memory leakage over long-running and non-existent route
generation.</li>
<li>Adding URLGenerator object.</li>
<li>Adding redirect routes.</li>
<li>Static routes can now interpolate variable parts in the path if using {}
variable part syntax.</li>
<li>Added sub_domain condition option to accept False or None, to require that
there be no sub-domain provided for the route to match.</li>
</ul>
</div>
<div class="section" id="release-1-9-2-july-8-2008">
<h2>Release 1.9.2 (July 8, 2008)<a class="headerlink" href="#release-1-9-2-july-8-2008" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed bug in url_for which caused it to return a literal when it shouldn’t
have.</li>
</ul>
</div>
<div class="section" id="release-1-9-1-june-28-2008">
<h2>Release 1.9.1 (June 28, 2008)<a class="headerlink" href="#release-1-9-1-june-28-2008" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed bug in formatted route recognition with formatting being absorbed
into the id.</li>
</ul>
</div>
<div class="section" id="release-1-9-june-12-2008">
<h2>Release 1.9 (June 12, 2008)<a class="headerlink" href="#release-1-9-june-12-2008" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fix undefined arg bug in url_for.</li>
<li>Fixed bug with url_for not working properly outside of a request when
sub-domains are active. Thanks Pavel Skvazh.</li>
<li>Add non-minimization option to Routes and the Mapper for generation and
recognition.</li>
<li>Add Routes 2.0 style syntax for making routes and regexp. For example, this
route will now work: ‘{controller}/{action}/{id}’.</li>
<li>Fixed Routes to not use quote_plus when making URL’s.</li>
<li>WARNING: Mapper now comes with hardcode_names set to True by default. This
means routes generated by name must work for the URL.</li>
<li>Actually respect having urlcache disabled.</li>
<li>WARNING: Calling url_for with a set of args that returns None now throws an
exception. Code that previously checked to see if a url could be made must
be updated accordingly.</li>
<li>Updated url_for to return url in a literal for use in templating that may
try to escape it again.</li>
<li>Added option to use X_FORWARDED_PROTO for proxying behind https to work
easier.</li>
<li>Fixed map.resource to be less restrictive on id than just spaces.</li>
<li>Fixed Mapper.create_regs not being thread safe, particularly when
always_scan=True.</li>
</ul>
</div>
<div class="section" id="release-1-8-march-28-2008">
<h2>Release 1.8 (March 28, 2008)<a class="headerlink" href="#release-1-8-march-28-2008" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed bug of map.resource not allowing spaces in id.</li>
<li>Fixed url generation to properly handle unicode defaults in addition to
unicode arguments.</li>
<li>Fixed url_for to handle lists as keyword args when generating query
parameters.</li>
<li>WARNING: Changed map.resource to not use ‘;’, for actions, but the
normal ‘/’. This means that formatted URL’s will also now have the format
come AFTER the action. Ie: /messsages/4.xml;rss -> /messages/4/rss.xml</li>
</ul>
</div>
<div class="section" id="release-1-7-3-may-28th-2008">
<h2>Release 1.7.3 (May 28th, 2008)<a class="headerlink" href="#release-1-7-3-may-28th-2008" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed triple escaping bug, since WSGI servers are responsible for basic
unescaping.</li>
</ul>
</div>
<div class="section" id="release-1-7-2-feb-27th-2008">
<h2>Release 1.7.2 (Feb. 27th, 2008)<a class="headerlink" href="#release-1-7-2-feb-27th-2008" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed bug with keyword args not being coerced to raw string properly.</li>
</ul>
</div>
<div class="section" id="release-1-7-1-nov-16th-2007">
<h2>Release 1.7.1 (Nov. 16th, 2007)<a class="headerlink" href="#release-1-7-1-nov-16th-2007" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed bug with sub-domains from route defaults getting encoded to unicode
resulting in a unicode route which then caused url_for to throw an
exception.</li>
<li>Removed duplicate assignment in map.resource. Patch by Mike Naberezny.</li>
<li>Applied test patch fix for path checking. Thanks Mike Naberezny.</li>
<li>Added additional checking of remaining URL, to properly swallow periods in
the appropriate context. Fixes #57.</li>
<li>Added mapper.hardcode_names option which restricts url generation to the
named route during generation rather than using the routes default options
during generation.</li>
<li>Fixed the special ‘_method’ attribute not being recognized during POST
requests of Content-Type ‘multipart/form-data’.</li>
</ul>
</div>
<div class="section" id="release-1-7-june-8th-2007">
<h2>Release 1.7 (June 8th, 2007)<a class="headerlink" href="#release-1-7-june-8th-2007" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed url_unquoting to only apply for strings.</li>
<li>Added _encoding option to individual routes to toggle decoding/encoding on a
per route basis.</li>
<li>Fixed route matching so that ‘.’ and other special chars are only part of the
match should they not be followed by that character. Fixed regexp creation so
that route parts with ‘.’ in them aren’t matched properly. Fixes #48.</li>
<li>Fixed Unicode decoding/encoding so that the URL decoding and encoding can be
set on the mapper with mapper.encoding. Fixes #40.</li>
<li>Don’t assume environ[‘CONTENT_TYPE’] always exists: it may be omitted
according to the WSGI PEP.</li>
<li>Fixed Unicode decode/encoding of path_info dynamic/wildcard parts so that
PATH_INFO will stay a raw string as it should. Fixes #51.</li>
<li>Fixed url_for (thus redirect_to) to throw an exception if a Unicode
string is returned as that’s an invalid URL. Fixes #46.</li>
<li>Fixed Routes middleware to only parse POST’s if the content type is
application/x-www-form-urlencoded for a HTML form. This properly avoids
parsing wsgi.input when it doesn’t need to be.</li>
</ul>
</div>
<div class="section" id="release-1-6-3-april-10th-2007">
<h2>Release 1.6.3 (April 10th, 2007)<a class="headerlink" href="#release-1-6-3-april-10th-2007" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed matching so that an attempt to match an empty path raises a
RouteException. Fixes #44.</li>
<li>Added ability to use characters in URL’s such as ‘-‘ and ‘_’ in
map.resource. Patch by Wyatt Baldwin. Fixes #45.</li>
<li>Updated Mapper.resource handling with name_prefix and path_prefix checking
to specify defaults. Also ensures that should either of them be set, they
override the prefixes should parent_resource be specified. Patch by Wyatt
Baldwin. Fixes #42.</li>
<li>Added utf-8 decoding of incoming path arguments, with fallback to ignoring
them in the very rare cases a malformed request URL is sent. Patch from
David Smith.</li>
<li>Fixed treatment of ‘#’ character as something that can be left off and
used in route paths. Found by Mike Orr.</li>
<li>Added ability to specify parent resource to map.resource command. Patch from
Wyatt Baldwin.</li>
<li>Fixed formatted route issue with map.resource when additional collection
methods are specified. Added unit tests to verify the collection methods
work properly.</li>
<li>Updated URL parsing to properly use HTTP_HOST for hostname + port info before
falling back to SERVER_PORT and SERVER_NAME. Fixes #43.</li>
<li>Added member_name and collection_name setting to Route object when made with
map.resource.</li>
<li>Updated routes.middleware to make the Routes matched accessible as
environ[‘routes.route’].</li>
<li>Updating mapper object to use thread local for request data (such as
environ) and middleware now deletes environ references at the end of the
request.</li>
<li>Added explicit option to Routes and Mapper. Routes _explicit setting will
prevent the Route defaults from being implicitly set, while setting Mapper
to explicit will prevent Route implicit defaults and stop url_for from using
Route memory. Fixes #38.</li>
<li>Updated config object so that the route is attached if possible.</li>
<li>Adding standard logging usage with debug messages.</li>
<li>Added additional test for normal ‘.’ match and fixed new special matching to
match it properly. Thanks David Smith.</li>
<li>Fixed hanging special char issue with ‘special’ URL chars at the end of a URL
that are missing the variable afterwards.</li>
<li>Changed Routes generation and recognition to handle other ‘special’ URL chars
, . and ; as if they were /. This lets them be optionally left out of the
resulting generated URL. Feature requested by David Smith.</li>
<li>Fixed lookahead assertion in regexp builder to properly handle two grouped
patterns in a row.</li>
<li>Applied patch to generation and matching to handle Unicode characters
properly. Reported with patch by David Smith.</li>
</ul>
</div>
<div class="section" id="release-1-6-2-jan-5-2007">
<h2>Release 1.6.2 (Jan. 5, 2007)<a class="headerlink" href="#release-1-6-2-jan-5-2007" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed issue with method checking not properly handling different letter
cases in REQUEST_METHOD. Reported by Sean Davis.</li>
<li>redirect_to now supports config.redirect returning a redirect, not just
raising one.</li>
</ul>
</div>
<div class="section" id="release-1-6-1-dec-29-2006">
<h2>Release 1.6.1 (Dec. 29, 2006)<a class="headerlink" href="#release-1-6-1-dec-29-2006" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed zipsafe flag to be False.</li>
</ul>
</div>
<div class="section" id="release-1-6-dec-14th-2006">
<h2>Release 1.6 (Dec. 14th, 2006)<a class="headerlink" href="#release-1-6-dec-14th-2006" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed append_slash to take effect in the route generation itself instead of
relying on url_for function. Reported by ToddG.</li>
<li>Added additional url_for tests to ensure map.resource generates proper named
routes.</li>
<li>WARNING: Changed map.resource initialization to accept individual member and
collection names to generate proper singular and plural route names. Those
using map.resource will need to update their routes and url_for statements
accordingly.</li>
<li>Added additional map.resource recognition tests.</li>
<li>Added WSGI middleware that does route resolving using new <a class="reference external" href="http://wsgi.org/wsgi/Specifications/routing_args">WSGI.org Routing
Vars Spec</a>.</li>
<li>Added _absolute keyword option route connect to ignore SCRIPT_NAME settings.
Suggested by Ian Bicking.</li>
</ul>
</div>
<div class="section" id="release-1-5-2-oct-16th-2006">
<h2>Release 1.5.2 (Oct. 16th, 2006)<a class="headerlink" href="#release-1-5-2-oct-16th-2006" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed qualified keyword to keep host port names when used, unless a host
is specifically passed in. Reported by Jon Rosebaugh.</li>
<li>Added qualified keyword option to url_for to have it generate a full
URL. Resolves #29.</li>
<li>Fixed examples in url_for doc strings so they’ll be accurate.</li>
</ul>
</div>
<div class="section" id="release-1-5-1-oct-4th-2006">
<h2>Release 1.5.1 (Oct. 4th, 2006)<a class="headerlink" href="#release-1-5-1-oct-4th-2006" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed bug with escaping part names in the regular expression, reported by
James Taylor.</li>
</ul>
</div>
<div class="section" id="release-1-5-sept-19th-2006">
<h2>Release 1.5 (Sept. 19th, 2006)<a class="headerlink" href="#release-1-5-sept-19th-2006" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Significant updates to map.resource and unit tests that comb it thoroughly
to ensure its creating all the proper routes (it now is). Increased unit
testing coverage to 95%.</li>
<li>Added unit tests to ensure controller_scan works properly with nested
controller files and appropriately scans the directory structure. This
brings the Routes util module up to full code coverage.</li>
<li>Fixed url_for so that when the protocol is changed, port information is
removed from the host.</li>
<li>Added more thorough testing to _RequestConfig object and the ability to
set your own object. This increases testing coverage of the __init__ module
to 100%.</li>
<li>Fixed bug with sub_domain not maintaining port information in url_for and
added unit tests. Reported by Jonathan Rosebaugh.</li>
<li>Added unit tests to ensure sub_domain option works with named routes, cleaned
up url_for memory argument filtering. Fixed bug with named routes and sub_domain
option not working together, reported by Jonathan Rosebaugh.</li>
<li>Changed order in which sub-domain is added to match-dict so it can be used
in a conditions function.</li>
</ul>
</div>
<div class="section" id="release-1-4-1-sept-6th-2006">
<h2>Release 1.4.1 (Sept. 6th, 2006)<a class="headerlink" href="#release-1-4-1-sept-6th-2006" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Added sub_domains option to mapper, along with sub_domains_ignore list for
subdomains that are considered equivilant to the main domain. When sub_domains
is active, url_for will now take a sub_domain option that can alter the host
the route will go to.</li>
<li>Added ability for filter functions to provide a _host, _protocol, _anchor arg
which is then used to create the URL with the appropriate host/protocol/anchor
destination.</li>
<li>Patch applied from Ticket #28. Resolves issue with Mapper’s controller_scan
function requiring a valid directory argument. Submitted by Zoran Isailovski.</li>
</ul>
</div>
<div class="section" id="release-1-4-july-21-2006">
<h2>Release 1.4 (July 21, 2006)<a class="headerlink" href="#release-1-4-july-21-2006" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed bug with map.resource related to member methods, found in Rails version.</li>
<li>Fixed bug with map.resource member methods not requiring a member id.</li>
<li>Fixed bug related to handling keyword argument controller.</li>
<li>Added map.resource command which can automatically generate a batch of routes intended
to be used in a REST-ful manner by a web framework.</li>
<li>Added URL generation handling for a ‘method’ argument. If ‘method’ is specified, it
is not dropped and will be changed to ‘_method’ for use by the framework.</li>
<li>Added conditions option to map.connect. Accepts a dict with optional keyword args
‘method’ or ‘function’. Method is a list of HTTP methods that are valid for the route.
Function is a function that will be called with environ, matchdict where matchdict is
the dict created by the URL match.</li>
<li>Fixed redirect_to function for using absolute URL’s. redirect_to now passes all args to
url_for, then passes the resulting URL to the redirect function. Reported by climbus.</li>
</ul>
</div>
<div class="section" id="release-1-3-2-april-30th-2006">
<h2>Release 1.3.2 (April 30th, 2006)<a class="headerlink" href="#release-1-3-2-april-30th-2006" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Fixed _filter bug with inclusion in match dict during matching, reported by David Creemer.</li>
<li>Fixed improper url quoting by using urllib.encode, patch by Jason Culverhouse.</li>
</ul>
</div>
<div class="section" id="release-1-3-1-april-4th-2006">
<h2>Release 1.3.1 (April 4th, 2006)<a class="headerlink" href="#release-1-3-1-april-4th-2006" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Mapper has an optional attribute <tt class="docutils literal"><span class="pre">append_slash</span></tt>. When set to <tt class="xref docutils literal"><span class="pre">True</span></tt>, any URL’s
generated will have a slash appended to the end.</li>
<li>Fixed prefix option so that if the PATH_INFO is empty after prefix regexp, its set to
‘/’ so the match proceeds ok.</li>
<li>Fixed prefix bug that caused routes after the initial one to not see the proper url
for matching. Caught by Jochen Kupperschmidt.</li>
</ul>
</div>
<div class="section" id="release-1-3-feb-25th-2006">
<h2>Release 1.3 (Feb. 25th, 2006)<a class="headerlink" href="#release-1-3-feb-25th-2006" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>url_for keyword filters:
Named routes can now have a _filter argument that should specify a function that takes
a dict as its sole argument. The dict will contain the full set of keywords passed to
url_for, which the function can then modify as it pleases. The new dict will then be
used as if it was the original set of keyword args given to url_for.</li>
<li>Fixed Python 2.3 incompatibility due to using keyword arg for a sort statement
when using the built-in controller scanner.</li>
</ul>
</div>
<div class="section" id="release-1-2-feb-17th-2006">
<h2>Release 1.2 (Feb. 17th, 2006)<a class="headerlink" href="#release-1-2-feb-17th-2006" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>If a named route doesn’t exist, and a url_for call is used, instead of using the
keyword arguments to generate a URL, they will be used as query args for the raw
URL supplied. (Backwards Incompatible)</li>
<li>If Mapper has debug=True, using match will return two additional values, the route
that matched, if one did match. And a list of routes that were tried, and information
about why they didn’t pass.</li>
<li>url_for enhancements:
Can now be used with ‘raw’ URL’s to generate proper url’s for static content that
will then automatically include SCRIPT_NAME if necessary
Static named routes can now be used to shortcut common path information as desired.</li>
<li>Controller Scanner will now sort controller names so that the longest one is first. This
ensures that the deepest nested controller is executed first before more shallow ones to
increase predictability.</li>
<li>Controller Scanner now scans directories properly, the version in 1.1 left off the
directory prefix when created the list of controllers.
(Thanks to Justin for drawing my attention to it)</li>
</ul>
</div>
<div class="section" id="release-1-1-jan-13th-2006">
<h2>Release 1.1 (Jan. 13th, 2006)<a class="headerlink" href="#release-1-1-jan-13th-2006" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Routes Mapper additions:
Now takes several optional arguments that determine how it will
generate the regexp’s.
Can now hold a function for use when determining what the available
controllers are. Comes with a default directory scanner
Given a directory for the default scanner or a function, the Mapper
will now automatically run it to get the controller list when needed</li>
<li>Syntax available for splitting routes to allow more complex route paths, such
as ‘:controller/:(action)-:(id).html’</li>
<li>Easier setup/integration with Routes per request. Setting the environ in a
WSGI environ will run match, and setup everything needed for url_for/etc.</li>
</ul>
</div>
<div class="section" id="release-1-0-2-dec-30th-2005">
<h2>Release 1.0.2 (Dec. 30th, 2005)<a class="headerlink" href="#release-1-0-2-dec-30th-2005" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Routes where a default was present but None were filling in improper values.</li>
<li>Passing a 0 would evaluate to None during generation, resulting in missing
URL parts</li>
</ul>
</div>
<div class="section" id="release-1-0-1-dec-18th-2005">
<h2>Release 1.0.1 (Dec. 18th, 2005)<a class="headerlink" href="#release-1-0-1-dec-18th-2005" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Request Local Callable - You can now designate your own callable function that
should then be used to store the request_config data. This is most useful for
environments where its possible multiple requests might be running in a single
thread. The callable should return a request specific object for attributes to
be attached. See routes.__init__.py for more information.</li>
</ul>
</div>
<div class="section" id="release-1-0-nov-21st-2005">
<h2>Release 1.0 (Nov. 21st, 2005)<a class="headerlink" href="#release-1-0-nov-21st-2005" title="Permalink to this headline">¶</a></h2>
<ul>
<li><p class="first">routes.__init__ will now load the common symbols most people will
want to actually use.
Thus, you can either:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="kn">from</span> <span class="nn">routes</span> <span class="kn">import</span> <span class="o">*</span>
</pre></div>
</div>
<p>Or:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="kn">from</span> <span class="nn">routes</span> <span class="kn">import</span> <span class="n">request_confg</span><span class="p">,</span> <span class="n">Mapper</span>
</pre></div>
</div>
<p>The following names are available for importing from routes:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">request_config</span><span class="p">,</span> <span class="n">Mapper</span><span class="p">,</span> <span class="n">url_for</span><span class="p">,</span> <span class="n">redirect_to</span>
</pre></div>
</div>
</li>
<li><p class="first">Route Names - You can now name a route, which will save a copy of the defaults
defined for later use by url_for or redirect_to.
Thus, a route and url_for looking like this:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">m</span><span class="o">.</span><span class="n">connect</span><span class="p">(</span><span class="s">'home'</span><span class="p">,</span> <span class="n">controller</span><span class="o">=</span><span class="s">'blog'</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">'splash'</span><span class="p">)</span>
<span class="n">url_for</span><span class="p">(</span><span class="n">controller</span><span class="o">=</span><span class="s">'blog'</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">'splash'</span><span class="p">)</span> <span class="c"># => /home</span>
</pre></div>
</div>
<p>Can now be used with a name:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">m</span><span class="o">.</span><span class="n">connect</span><span class="p">(</span><span class="s">'home_url'</span><span class="p">,</span><span class="s">'home'</span><span class="p">,</span> <span class="n">controller</span><span class="o">=</span><span class="s">'blog'</span><span class="p">,</span> <span class="n">action</span><span class="o">=</span><span class="s">'splash'</span><span class="p">)</span>
<span class="n">url_for</span><span class="p">(</span><span class="s">'home_url'</span><span class="p">)</span> <span class="c"># => /home</span>
</pre></div>
</div>
<p>Additional keywords can still be added to url_for and will override defaults in
the named route.</p>
</li>
<li><p class="first">Trailing / - Route recognition earlier failed on trailing slashes, not really a bug,
not really a feature I guess. Anyways, trailing slashes are o.k. now as in the Rails
version.</p>
</li>
<li><p class="first">redirect_to now has two sets of tests to ensure it works properly</p>
</li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3><a href="contents.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference external" href="#">Routes Changelog</a><ul>
<li><a class="reference external" href="#release-1-12-february-28-2010">Release 1.12 (February 28, 2010)</a></li>
<li><a class="reference external" href="#release-1-11-september-28-2009">Release 1.11 (September 28, 2009)</a></li>
<li><a class="reference external" href="#release-1-10-3-february-8-2009">Release 1.10.3 (February 8, 2009)</a></li>
<li><a class="reference external" href="#release-1-10-2-january-11-2009">Release 1.10.2 (January 11, 2009)</a></li>
<li><a class="reference external" href="#release-1-10-1-september-27-2008">Release 1.10.1 (September 27, 2008)</a></li>
<li><a class="reference external" href="#release-1-10-september-24-2008">Release 1.10 (September 24, 2008)</a></li>
<li><a class="reference external" href="#release-1-9-2-july-8-2008">Release 1.9.2 (July 8, 2008)</a></li>
<li><a class="reference external" href="#release-1-9-1-june-28-2008">Release 1.9.1 (June 28, 2008)</a></li>
<li><a class="reference external" href="#release-1-9-june-12-2008">Release 1.9 (June 12, 2008)</a></li>
<li><a class="reference external" href="#release-1-8-march-28-2008">Release 1.8 (March 28, 2008)</a></li>
<li><a class="reference external" href="#release-1-7-3-may-28th-2008">Release 1.7.3 (May 28th, 2008)</a></li>
<li><a class="reference external" href="#release-1-7-2-feb-27th-2008">Release 1.7.2 (Feb. 27th, 2008)</a></li>
<li><a class="reference external" href="#release-1-7-1-nov-16th-2007">Release 1.7.1 (Nov. 16th, 2007)</a></li>
<li><a class="reference external" href="#release-1-7-june-8th-2007">Release 1.7 (June 8th, 2007)</a></li>
<li><a class="reference external" href="#release-1-6-3-april-10th-2007">Release 1.6.3 (April 10th, 2007)</a></li>
<li><a class="reference external" href="#release-1-6-2-jan-5-2007">Release 1.6.2 (Jan. 5, 2007)</a></li>
<li><a class="reference external" href="#release-1-6-1-dec-29-2006">Release 1.6.1 (Dec. 29, 2006)</a></li>
<li><a class="reference external" href="#release-1-6-dec-14th-2006">Release 1.6 (Dec. 14th, 2006)</a></li>
<li><a class="reference external" href="#release-1-5-2-oct-16th-2006">Release 1.5.2 (Oct. 16th, 2006)</a></li>
<li><a class="reference external" href="#release-1-5-1-oct-4th-2006">Release 1.5.1 (Oct. 4th, 2006)</a></li>
<li><a class="reference external" href="#release-1-5-sept-19th-2006">Release 1.5 (Sept. 19th, 2006)</a></li>
<li><a class="reference external" href="#release-1-4-1-sept-6th-2006">Release 1.4.1 (Sept. 6th, 2006)</a></li>
<li><a class="reference external" href="#release-1-4-july-21-2006">Release 1.4 (July 21, 2006)</a></li>
<li><a class="reference external" href="#release-1-3-2-april-30th-2006">Release 1.3.2 (April 30th, 2006)</a></li>
<li><a class="reference external" href="#release-1-3-1-april-4th-2006">Release 1.3.1 (April 4th, 2006)</a></li>
<li><a class="reference external" href="#release-1-3-feb-25th-2006">Release 1.3 (Feb. 25th, 2006)</a></li>
<li><a class="reference external" href="#release-1-2-feb-17th-2006">Release 1.2 (Feb. 17th, 2006)</a></li>
<li><a class="reference external" href="#release-1-1-jan-13th-2006">Release 1.1 (Jan. 13th, 2006)</a></li>
<li><a class="reference external" href="#release-1-0-2-dec-30th-2005">Release 1.0.2 (Dec. 30th, 2005)</a></li>
<li><a class="reference external" href="#release-1-0-1-dec-18th-2005">Release 1.0.1 (Dec. 18th, 2005)</a></li>
<li><a class="reference external" href="#release-1-0-nov-21st-2005">Release 1.0 (Nov. 21st, 2005)</a></li>
</ul>
</li>
</ul>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/changes.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" size="18" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="modindex.html" title="Global Module Index"
>modules</a> |</li>
<li><a href="index.html">Routes home</a> | </li>
<li><a href="contents.html">Documentation</a>»</li>
</ul>
</div>
<div class="footer">
© Copyright 2010, Ben Bangert, Mike Orr.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 0.6.4.
</div>
</body>
</html>
distrib
>
Fedora
>
13
>
i386
>
media
>
updates
>
by-pkgid
>
0f1d1597e035b8f728906cec3e256251
>
files
>
89
