maya-chen/flask
1
0
Fork 0
forked from orbit-oss/flask
Code Pull requests Activity

Minor docs fixes. (#3988)

Browse source
This commit is contained in:
Joshua Bronson 2021-05-02 16:05:08 -04:00 • committed by GitHub
parent 98fbb6a3a7
commit 8bfce88e39
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 4 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

8
docs/async-await.rst
View file

@ -57,7 +57,7 @@ example via ``asyncio.create_task``.
If you wish to use background tasks it is best to use a task queue to If you wish to use background tasks it is best to use a task queue to
trigger background work, rather than spawn tasks in a view trigger background work, rather than spawn tasks in a view
function. With that in mind you can spawn asyncio tasks by serving function. With that in mind you can spawn asyncio tasks by serving
Flask with a ASGI server and utilising the asgiref WsgiToAsgi adapter Flask with an ASGI server and utilising the asgiref WsgiToAsgi adapter
as described in :ref:`asgi`. This works as the adapter creates an as described in :ref:`asgi`. This works as the adapter creates an
event loop that runs continually. event loop that runs continually.
@ -70,7 +70,7 @@ to the way it is implemented. If you have a mainly async codebase it
would make sense to consider `Quart`_. Quart is a reimplementation of would make sense to consider `Quart`_. Quart is a reimplementation of
Flask based on the `ASGI`_ standard instead of WSGI. This allows it to Flask based on the `ASGI`_ standard instead of WSGI. This allows it to
handle many concurrent requests, long running requests, and websockets handle many concurrent requests, long running requests, and websockets
without requiring individual worker processes or threads. without requiring multiple worker processes or threads.
It has also already been possible to run Flask with Gevent or Eventlet It has also already been possible to run Flask with Gevent or Eventlet
to get many of the benefits of async request handling. These libraries to get many of the benefits of async request handling. These libraries
@ -86,8 +86,8 @@ to understanding the specific needs of your project.
Extensions Extensions
---------- ----------
Existing Flask extensions only expect views to be synchronous. If they Flask extensions predating Flask's async support do not expect async views.
provide decorators to add functionality to views, those will probably If they provide decorators to add functionality to views, those will probably
not work with async views because they will not await the function or be not work with async views because they will not await the function or be
awaitable. Other functions they provide will not be awaitable either and awaitable. Other functions they provide will not be awaitable either and
will probably be blocking if called within an async view. will probably be blocking if called within an async view.