Skip to content

Commit

Permalink
Update docs for order of listeners #1805 (#1834)
Browse files Browse the repository at this point in the history
  • Loading branch information
Prasanna Walimbe authored Apr 26, 2020
1 parent 638322d commit 9987893
Showing 1 changed file with 11 additions and 0 deletions.
11 changes: 11 additions & 0 deletions docs/sanic/middleware.rst
Original file line number Diff line number Diff line change
Expand Up @@ -132,6 +132,17 @@ For example:
async def close_db(app, loop):
await app.db.close()
Note:

The listeners are deconstructed in the reverse order of being constructed.

For example:

If the first listener in before_server_start handler setups a database connection,
ones registered after it can rely on that connection being alive both when they are started
and stopped, because stopping is done in reverse order, and the database connection is
torn down last.

It's also possible to register a listener using the `register_listener` method.
This may be useful if you define your listeners in another module besides
the one you instantiate your app in.
Expand Down

0 comments on commit 9987893

Please sign in to comment.