By example¶

Twelve chapters that start with a single message and end with your own store. Read them in order, or jump to the one you need.

Build a view¶

Views

Describe a whole message in render() and send it.
Buttons that remember

Keep a view's fields from click to click and across restarts.
Handlers and arguments

Let one handler serve many buttons, each carrying its own value.
Selects, sections, galleries

Draw more than text and buttons: menus, images and files.
Answering in time

Answer within Discord's three seconds, even when the work takes longer, and answer a click that failed.
Dependency injection

Hand your database to a handler, and choose how long each dependency lives.

Fresh data

Read a database row on every click instead of saving it.
Where state lives

See what you can do when a view runs out of room in its message.
Stores and TTL

Move a view into a store, with room to grow and a lifetime.

Changing a view safely

See which changes break the buttons already sent, and every way to deal with one that does.
Several processes

Run more than one process, and handle two clicks that race.
Writing your own store

Write six methods against what you already run, and test them with verify_store.