Skip to content
This repository has been archived by the owner on Jul 30, 2024. It is now read-only.

TombProject/tomb_routes

Repository files navigation

tomb_routes

https://coveralls.io/repos/tomborine/tomb_routes/badge.svg?branch=master

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.

About

Simple utility library around pyramid routing

Resources

Stars

Watchers

Forks

Packages

No packages published