Source

wheezy.routing / README

Full commit
`wheezy-routing`_ is a `python`_ package written in pure Python
code. It is a simple mapping between URL patterns (as plain
simple strings, curly expressions or regular expressions) to
a handler that can be anything you like (there is no limitation
or prescription what handler is or could be).

The mapping can include other mappings and constructed
dynamically.

It is optimized for performance, well tested and `documented`_.

The source code is available on `bitbucket`_.

Install
-------

`wheezy-routing`_ requires `python`_ version 2.4 to 2.7 or 3.2.
It is independent of operating system. You can install it using
`setuptools`_::

    easy_install wheezy-routing


Develop
-------

Get the `source code`_ using `mercurial`_::

    hg clone https://bitbucket.org/akorn/wheezy-routing
    cd wheezy-routing

Prepare virtualenv environment in *env* directory and run
all tests for python2.6 (default)::

    make env test VERSION=2.6

doctests can be run with python3.2::

    make env doctest-cover VERSION=3.2

If you run into any issue or have comments, go ahead and add on
`bitbucket`_.


User Guide and Examples
-----------------------

Please see the `user guide`_ and `examples`_ for more
information.

.. _`wheezy-routing`: http://pypi.python.org/pypi/wheezy-routing
.. _`python`: http://www.python.org
.. _`setuptools`: http://pypi.python.org/pypi/setuptools
.. _`documented`: http://packages.python.org/wheezy-routing
.. _`examples`: https://bitbucket.org/akorn/wheezy-routing/src/tip/demos/
.. _`bitbucket`: https://bitbucket.org/akorn/wheezy-routing
.. _`source code`: https://bitbucket.org/akorn/wheezy-routing/src
.. _`mercurial`: http://mercurial.selenic.com/
.. _`user guide`: http://packages.python.org/wheezy-routing/userguide.html