3_router.md

Router

The router is a subsystem responsible for directing incoming requests to particular handlers based on some conditions, namely the URL path and HTTP method. It's available under router property of an Application instance and presents add_router method which takes path pattern, handler and optionally one or more methods.

# examples/3_router/router.py
from japronto import Application


app = Application()
r = app.router


# Requests with the path set exactly to `/` and whatever method
# will be directed here.
def slash(request):
    return request.Response(text='Hello {} /!'.format(request.method))


r.add_route('/', slash)


# Requests with the path set exactly to '/love' and the method
# set exactly to `GET` will be directed here.
def get_love(request):
    return request.Response(text='Got some love')


r.add_route('/love', get_love, 'GET')


# Requests with the path set exactly to '/methods' and the method
# set to `POST` or `DELETE` will be directed here.
def methods(request):
    return request.Response(text=request.method)


r.add_route('/methods', methods, methods=['POST', 'DELETE'])


# Requests with the path starting with `/params/` segment and followed
# by two additional segments will be directed here.
# Values of the additional segments will be stored in side `request.match_dict`
# dictionary with keys taken from {} placeholders. A request to `/params/1/2`
# would leave `match_dict` set to `{'p1': 1, 'p2': '2'}`.
def params(request):
    return request.Response(text=str(request.match_dict))


r.add_route('/params/{p1}/{p2}', params)

app.run()

The source code for all the examples can be found in examples directory.

Next: Request object