Tremolo uses only basic routing and built-in re module. There are no difficult abstractions, and never will.

Basic

The following will handle http://example.com/hello and query string (if any).

@app.route('/hello')
async def hello_world(**server):
    yield b'Hello '
    yield b'world!'

Regular expression

To be recognized as a regex string, at least the path must start with ^ or end with $ character.

The following will match for example with http://example.com/page/12, http://example.com/page/101, and so on.

@app.route(r'^/page/(?P<page_id>\d+)')
async def my_page(**server):
    request = server['request']
    page_id = request.params.path.get('page_id', b'1')

    # Tremolo often uses bytes-like objects as is,
    # rather than converting to str or int.
    # so do not assume page_id is an int.
    yield b'You are on page ' + page_id

The regex syntax above uses named groups which you can learn more about at https://docs.python.org/3/library/re.html#re.Match.groupdict

You can always check what kind of data is received if using regex in request.params.path. It’s a dict object.

It is worth noting that the routing has a limitation, which is that you cannot capture the beginning of the path. So it requires a prefix like /page/ because Tremolo makes use of prefixes for caching.

Custom 404 page

@app.error(404)
async def my_error_page(**server):
    return 'This is my custom 404 page.'