Routes
++++++

Routes is a Python re-implementation of the `Rails routes system <http://manuals.rubyonrails.com/read/book/9>`_
for mapping URL's to Controllers/Actions and generating URL's. Routes makes it easy to create pretty and concise URL's that are RESTful with little effort.

Speedy and dynamic URL generation means you get a URL with minimal cruft (no big dangling query args). Shortcut features like Named Routes cut down on repetitive typing.

Current features:

* Named Routes
* Sophisticated Route lookup and URL generation
* Wildcard path's before and after static parts
* Groupings syntax to allow flexible URL's to accommodate almost any need
* Extensive unit tests

Buzzword Compliance: *REST*, *DRY*

News
====

**April 30th, 2006**

Routes 1.3.2 released with:

* Fixed _filter bug with inclusion in match dict during matching, reported by David Creemer.
* Fixed improper url quoting by using urllib.encode, patch by Jason Culverhouse.



**April 4th, 2006**

Routes 1.3.1 released with:

* Mapper has an optional attribute ``append_slash``. When set to ``True``, any URL's
  generated will have a slash appended to the end. 
* Fixed prefix option so that if the PATH_INFO is empty after prefix regexp, its set to
  '/' so the match proceeds ok.
* Fixed prefix bug that caused routes after the initial one to not see the proper url
  for matching. Caught by Jochen Kupperschmidt.



**February 25th, 2006**

Routes 1.3 released with:

* Filter functionality when using named routes
* Fixed Python 2.3 incompatibility issue with 1.2


**February 17th, 2006**

Routes 1.2 released with:

* Mapper debugging capabilities
* URL generation enhancements for application portability
* Static named routes


**January 13th, 2006**

Routes 1.1 released with:

* Easier integration
* Powerful Groupings syntax for more flexibility

Credits
=======

Many thanks to `Nicholas Seckar <http://wiki.rubyonrails.com/rails/show/NicholasSeckar>`_ for his insight and explanation of many aspects of the Rails Route system.

Author
======

`Ben Bangert <http://www.groovie.org/>`_ (`e-mail <mailto:ben@groovie.org>`_)

Development sponsored by `Parachute LLC. <http://www.parachute.com/>`_