GOONBAG

Note

I am still looking for a better name than this. Come on, people, help me out here :)

• do work a most once
• use parse / format for url lookup / reverse
• use stencil?
• decorators are cool, ok?

Design

• App processes input into a Request, and calls Handler.
• Handler generates Response
• App formats response for output.

A request is passed to a root handler, which MUST return a Response class (or subclass thereof).

By default the root handler is a url Routes instance.

A handler may act as a middleware, modifying the Request or reacting to the Response as desired.

Examples

from goonbag import Routes, Handler, handler

api = Routes()

@api.route('/foo/{bar}/', ....)
@handler
def handler(request):
    ...
    return content: iterable


@api.route('/baz/data')
@handler.json
def handler(request):
    ...
    return {...}


@api.route('/baz/')
class MyHandler(Handler):
    default_content_type = 'application/json'

    def get(self, request, \**url_params):
        return 'content'

Since routing uses parse we can even cast values on parse:

@api.route('/math/double/{value:d}')
@handler
def double(request, value):
    # Value is already an int
    return str(value * 2)

To make a WSGI Application:

from goonbag.wsgi import WsgiApplication

application = WsgiApplication(routes=api)