Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Translate async-await #24

Open
wants to merge 7 commits into
base: main
Choose a base branch
from
Open

Translate async-await #24

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
9cb04e7
Assign async-await to @rosekc
rosekc May 25, 2021
3f65caa
Merge branch 'main' into assign-async-await
rosekc Jun 2, 2021
0c75ad1
Translate async-await
rosekc May 25, 2021
139dd74
Apply suggestions from code review
rosekc Jun 10, 2021
01b76c6
Merge remote-tracking branch 'greyli/main' into translate-async-await
rosekc Jun 10, 2021
edab285
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Jun 10, 2021
b014948
Fix typos & sync with upstream
rosekc Jun 10, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@

- [ ] advanced_foreword (reserved)
- [ ] appcontext [@rosekc](https://github.com/rosekc) rosekc
- [ ] async-await
- [x] async-await [@rosekc](https://github.com/rosekc) rosekc
- [ ] becomingbig
- [x] blueprints [@frostming](https://github.com/frostming) Frost Ming
- [ ] changes
Expand Down
56 changes: 47 additions & 9 deletions docs/locales/zh_CN/LC_MESSAGES/async-await.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ msgstr ""
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-05-30 19:27+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Last-Translator: rosekc <[email protected]>\n"
"Language-Team: zh_CN <[email protected]>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
Expand All @@ -19,7 +19,7 @@ msgstr ""

#: ../../async-await.rst:4
msgid "Using ``async`` and ``await``"
msgstr ""
msgstr "使用 ``async`` 和 ``await``"

#: ../../async-await.rst:8
msgid ""
Expand All @@ -29,21 +29,27 @@ msgid ""
"where ``contextvars.ContextVar`` is available. This allows views to be "
"defined with ``async def`` and use ``await``."
msgstr ""
"在安装 Flask 时使用 ``async`` 额外后缀（``pip install flask[async]``）后，"
"包括路由、错误处理、请求前、请求后、清理（teardown）的函数都可以使用协程函数。"
"这允许视图函数使用 ``async def`` 定义，以及使用 ``await``。"

#: ../../async-await.rst:21
msgid "Using ``async`` on Windows on Python 3.8"
msgstr ""
msgstr "在 Windows，Python 3.8 环境下使用 ``async``"

#: ../../async-await.rst:23
msgid ""
"Python 3.8 has a bug related to asyncio on Windows. If you encounter "
"something like ``ValueError: set_wakeup_fd only works in main thread``, "
"please upgrade to Python 3.9."
msgstr ""
"在 Windows，Python 3.8 环境下存在一个与 asyncio 相关的 bug。如果遇到"
"类似 ``ValueError: set_wakeup_fd only works in main thread`` 的信息，"
"请更新到 Python 3.9。"

#: ../../async-await.rst:29
msgid "Performance"
msgstr ""
msgstr "性能"

#: ../../async-await.rst:31
msgid ""
Expand All @@ -52,6 +58,9 @@ msgid ""
" request comes in to an async view, Flask will start an event loop in a "
"thread, run the view function there, then return the result."
msgstr ""
"异步函数需要一个事件循环来执行。作为一个 WSGI 应用，Flask 使用一个线程去处理"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

worker翻译为线程似不妥，建议翻为例程（worker）以总括进程线程协程，首次使用可附上原词，并参考翻译词汇的讨论结果

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

已将 例程 放到 #12 投票中。

顺便一提有相关 worker 译为 例程 的例子吗？我是第一次见到这种翻译。

"请求/响应循环。当请求进入一个异步视图函数时，Flask 将在一个线程中启动一个事件"
"循环，在这个事件循环中执行视图函数，然后返回结果。"

#: ../../async-await.rst:36
msgid ""
Expand All @@ -61,6 +70,9 @@ msgid ""
"etc. However, the number of requests your application can handle at one "
"time will remain the same."
msgstr ""
"即使使用异步视图函数，每一个请求依然与一个线程绑定在一起。这样设计的好处是让"
"视图函数中可以执行异步代码，例如多个并行的数据库查询，HTTP请求外部API等等。"
"然而，同一时间应用本身能接受的请求数量不会改变。"

#: ../../async-await.rst:42
msgid ""
Expand All @@ -70,10 +82,13 @@ msgid ""
"most use cases, but Flask's async support enables writing and using code "
"that wasn't possible natively before."
msgstr ""
"**异步并不一定比同步代码快。** 异步的优势是在IO密集任务上，但是在CPU密集任务上"
"则不然。传统的 Flask 视图函数在大多数情况下是合适的选择，而 Flask 对异步的支持让"
"运行和使用协程代码成为可能，这是以前原生环境无法做到的。"

#: ../../async-await.rst:50
msgid "Background tasks"
msgstr ""
msgstr "后台任务"

#: ../../async-await.rst:52
msgid ""
Expand All @@ -83,6 +98,9 @@ msgid ""
"cancelled. Therefore you cannot spawn background tasks, for example via "
"``asyncio.create_task``."
msgstr ""
"异步函数在其执行完成前，都一个事件循环中运行。当异步函数完成时，事件循环也将停止。"
"这意味着异步函数完成的时候，所有尚未完成的其他衍生任务都将被取消。因此，不能使用"
"类似 ``asyncio.create_task`` 的方法来创建后台任务。"

#: ../../async-await.rst:58
msgid ""
Expand All @@ -93,10 +111,14 @@ msgid ""
":ref:`asgi`. This works as the adapter creates an event loop that runs "
"continually."
msgstr ""
"要使用后台任务，最好的方法就是使用任务队列去激活后台任务，而不是在视图函数中"
"创建。考虑到这点，使用 ASGI 服务器来为 Flask 提供服务来创建后台任务，然后如"
" :ref:`asgi` 提到的使用 asgiref 中的 WsgiToAsgi 适配器。这种做法与适配器"
"创建了一个持续运行的事件循环类似。"

#: ../../async-await.rst:67
msgid "When to use Quart instead"
msgstr ""
msgstr "何时使用 Quart 作为替代品"

#: ../../async-await.rst:69
msgid ""
Expand All @@ -107,6 +129,10 @@ msgid ""
"handle many concurrent requests, long running requests, and websockets "
"without requiring multiple worker processes or threads."
msgstr ""
"基于实现上的不同，Flask 的异步支持的性能比异步优先的框架会稍低。如果已经拥有"
"一个以异步为主的代码库，考虑使用 `Quart`_ 是明智的选择。Quart 是一个基于 `ASGI`_ "
"的 Flask 重新实现版本（而 Flask 是基于 WSGI 的）。这让多并行请求，长时间运行"
"的请求，以及 websockets 编程不再需要多个工作进程或线程。"

#: ../../async-await.rst:76
msgid ""
Expand All @@ -117,10 +143,14 @@ msgid ""
"whether you should use Flask, Quart, or something else is ultimately up "
"to understanding the specific needs of your project."
msgstr ""
"当前已经可以使用 Gevent 或 Eventlet 运行 Flask 来得到使用异步请求处理的好处。"
"这些库通过为底层 Python 库打补丁的方式实现，而 ``async``/``await`` 与 ASGI"
"使用了现代标准 Python 的特性。决定是否应使用 Flask，Quart 或其他工具最终取决于"
"了解项目的特定需求。"

#: ../../async-await.rst:88
msgid "Extensions"
msgstr ""
msgstr "扩展"

#: ../../async-await.rst:90
msgid ""
Expand All @@ -131,6 +161,10 @@ msgid ""
"awaitable either and will probably be blocking if called within an async "
"view."
msgstr ""
"Flask 扩展系统的实现先于 Flask 异步支持，所以并不会假设视图函数是异步的。如果扩展"
"提供了对视图函数的有附加功能的装饰器，这些装饰器因为不会异步等待（await）函数运行或者不是"
"异步可等待（awaitable）的，可能在异步视图函数上不能正常运行。扩展提供的其他函数或许"
"同样不是异步可等待的，在异步视图函数调用的时候大概会阻塞。"

#: ../../async-await.rst:96
msgid ""
Expand All @@ -139,23 +173,28 @@ msgid ""
"provides a view function decorator add ``ensure_sync`` before calling the"
" decorated function,"
msgstr ""
"扩展作者可以通过使用 :meth:`flask.Flask.ensure_sync` 方法来支持异步函数。"
"举例来说，如果扩展提供了一个视图函数装饰器，使用 ``ensure_sync`` 调用被包裹的函数。"

#: ../../async-await.rst:111
msgid ""
"Check the changelog of the extension you want to use to see if they've "
"implemented async support, or make a feature request or PR to them."
msgstr ""
"检查扩展的更新记录，查看是否实现了异步支持。如果没有可以向他们提交 PR。"

#: ../../async-await.rst:116
msgid "Other event loops"
msgstr ""
msgstr "其他事件循环"

#: ../../async-await.rst:118
msgid ""
"At the moment Flask only supports :mod:`asyncio`. It's possible to "
"override :meth:`flask.Flask.ensure_sync` to change how async functions "
"are wrapped to use a different library."
msgstr ""
"当前 Flask 只支持 :mod:`asyncio`。覆盖 :meth:`flask.Flask.ensure_sync` "
"可以修改包裹异步函数的实现，以使用其他库。"

#~ msgid ""
#~ "Routes, error handlers, before request, "
Expand All @@ -166,4 +205,3 @@ msgstr ""
#~ " allows views to be defined with "
#~ "``async def`` and use ``await``."
#~ msgstr ""