Route handling
==============

.. module:: pyroutes
   :synopsis: Core pyroutes public API
.. moduleauthor:: Kristian Klette <klette@samfundet.no>

.. function:: route(path)

   Decorator for declaring a method as a handler for a specific path, and paths
   above it if no better match exists. The decorated method should take an
   instance of :mod:`pyroutes.http.request.Request` as its first argument, and
   optionally more arguments auto-populated from the path.

   All handler methods must return an instance of
   :mod:`pyroutes.http.response.Response`.


.. function:: reverse_url(handler)

   Return the path a handler is responible for.

   Example::

       @pyroutes.route('/foo/bar')
       def foo_method(request):
           return "foo"

       pyroutes.reverse_url('foo_method')
       '/foo/bar'