tawdry 0.0.2

Example Application

import tawdry

def hello(request, publisher):
    return 'World!'

app = tawdry.Tawdry({'hello': hello})

if __name__ == '__main__':
    app.serve()

Once run, it will create a single route at /hello, on localhost by default.

$ curl localhost:5000/hello
World!

Installation

pip install tawdry

Requires Python 3 (and you’re best off with 3.5)

Type Annotations

The above example doesn’t really do much to show the purpose of Tawdry though. The whole point here is to use type annotations, as they are the mechanism through which Tawdry does its stuff! So lets look at a slightly more complex example.

import tawdry

def exclaim(request, exclamation: str) -> Response:
    return exclamation + '!'

sitemap = {
    'exclaim': {
        '{exclamation}': exclaim,
    },
}
app = tawdry.Tawdry(sitemap)

if __name__ == '__main__':
    app.serve()

$ curl localhost:5000/exclaim/wahhoooo
wahhoooo!

Of note in the above example:

• An argument type annotation will convert the argument to the annotated type before calling the function.

• A return type, type annotation will convert the function’s return value after it returns.

• The sitemap is a dict given in the form where:

  • The values are the functions which will be called in the event of a match.

  • The keys match a url segment with the same string, so nested dictionaries result in matches to subsequent nested segments.

  • Any key enclosed in curly braces is given as a parameter to the function given as a value, as well as any parameters leading up to it.

So in the above example:

1. the sitemap defines a single manifested route in the form /exclaim/{paramerer}.

2. parameter will be converted (in this case unnecessarily) to a string before being passed to exclaim.

3. The return value of exclaim will be converted to a Response object (note Response is applied by default, but other return types exist, such as JsonResponse and XmlResponse)

4. The Response object is wsgi compatible and will return the result to the caller