Routing¶

Each handler can handle one path, the path of a request is the last part of the URL starting from the first /. In https://example.com/home, the path is /home.

Dynamic Routing¶

Dynamic routing is useful to pass variables in URLs. For example, if you want to show a user’s profile from their username, you won’t hardcode every username, instead you will pass the username in the URL: /profile/{username}.

To do this with baguette, it’s easy:

@app.route("/profile/<username>")
async def profile(username):
    return f"<h1>{username}'s profile</h1>"

Converters¶

Use converters if you want the path parameters to be of a certain type and reject the request otherwise. For example, if you work with user IDs, you can make sure that the provided user ID is an integer:

@app.route("/profile/<user_id:int>")
async def profile(user_id):
    # let's assume we have a database from where we can query the user from their ID
    user = User.fetch(id=user_id)
    return f"<h1>{user.name}'s profile</h1>"

You can also pass arguments to the converters to customize how they convert and what they can convert. For example if you only want strings that are 4 characters long:

@app.route("/text/<text:str(length=4)>")
async def profile(text):
    return f"{text} is 4 characters long"