Simple utility library around pyramid routing
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 1 commit ahead, 33 commits behind TombProject:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
tests
tomb_routes
.gitignore
.travis.yml
AUTHORS
ChangeLog
README.rst
requirements.txt
setup.cfg
setup.py
test-requirements.txt
tox.ini

README.rst

tomb_routes

Intro

A set of simple defaults for Pyramid routing.

Pyramid's URL dispatch has separate concepts for routes and views. This gives additional flexibility in that you can one route map to multiple views, using different predicates (e.g.: predicates depending on Accept header, whether request is XHR or not, etc.). In many applications, this flexibility is not needed and having both routes and views adds a bit of complexity and duplication, and reduces DRYness. This module implements some easy-to-use mechanisms that create a route and a view in one step, resulting in simpler, easier to understand code. This kind of makes Pyramid's routing look a bit more like Flask, albeit without Flask's controversial thread locals.

You can use simple_route as a decorator:

from tomb_routes import simple_route
from pyramid.response import Response

@simple_route('/hello/{name}')
def my_route(request, name):
    return Response('Hello %s' % name)

or you can use it from the configurator:

config.include('tomb_routes')
config.add_simple_route(
    '/hello/{name}', view_callable,
    renderer='json'
 )

Inspirations

Frameworks with very simple routing (including so-called "microframeworks") are nothing new. Here are a few in the Python world:

Pyramid is a very powerful and extensible web framework and it's a framework that we love, but sometimes we want very simple routing. This package brings the simplified routing from microframeworks to Pyramid, so we can have our cake and eat it too.