From 730111fc33991f6ee7fb524a27a3f089be0d207d Mon Sep 17 00:00:00 2001 From: Liam O'Boyle Date: Wed, 4 Sep 2019 11:56:26 +1000 Subject: [PATCH] Add "accessing the app instance" to docs/application.md Along the lines of @tomchristie's suggestion in #620 but stressing the use of `request.app`. --- docs/applications.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/applications.md b/docs/applications.md index 5c30365f..44426448 100644 --- a/docs/applications.md +++ b/docs/applications.md @@ -80,10 +80,14 @@ exceptions that occur within the application: ### Storing state on the app instance You can store arbitrary extra state on the application instance, using the -generic `app.state` attribute. This can then be accessed in middleware or endpoints via `request.app`. +generic `app.state` attribute. For example: ```python app.state.ADMIN_EMAIL = 'admin@example.org' ``` + +### Acessing the app instance + +Where a `request` is available (i.e. endpoints and middleware), the app is available on `request.app`. For other situations it can be imported from wherever it's instantiated.