asyncio-runner.po

# Copyright (C) 2001-2022, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-09-23 07:52+0800\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
"tw)\n"
"Language: zh_TW\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: ../../library/asyncio-runner.rst:6
msgid "Runners"
msgstr "Runners (執行器)"

#: ../../library/asyncio-runner.rst:8
msgid "**Source code:** :source:`Lib/asyncio/runners.py`"
msgstr "**原始碼：**\\ :source:`Lib/asyncio/runners.py`"

#: ../../library/asyncio-runner.rst:11
msgid ""
"This section outlines high-level asyncio primitives to run asyncio code."
msgstr "這個章節概述用於執行 asyncio 程式碼的高階 asyncio 原始物件。"

#: ../../library/asyncio-runner.rst:13
msgid ""
"They are built on top of an :ref:`event loop <asyncio-event-loop>` with the "
"aim to simplify async code usage for common wide-spread scenarios."
msgstr ""
"他們是基於一個\\ :ref:`事件迴圈 <asyncio-event-loop>`，目的是為了簡化常見且廣"
"泛運用場景的非同步程式碼。"

#: ../../library/asyncio-runner.rst:23
msgid "Running an asyncio Program"
msgstr "運行一個 asyncio 程式"

#: ../../library/asyncio-runner.rst:27
msgid "Execute the :term:`coroutine` *coro* and return the result."
msgstr "執行\\ :term:`協程 (coroutine) <coroutine>` *coro* 並回傳結果。"

#: ../../library/asyncio-runner.rst:29
msgid ""
"This function runs the passed coroutine, taking care of managing the asyncio "
"event loop, *finalizing asynchronous generators*, and closing the executor."
msgstr ""
"這個函式負責運行被傳入的協程、管理 asyncio 的事件迴圈、*終結非同步產生器*，以"
"及關閉執行器。"

#: ../../library/asyncio-runner.rst:33 ../../library/asyncio-runner.rst:115
msgid ""
"This function cannot be called when another asyncio event loop is running in "
"the same thread."
msgstr "當另一個非同步事件迴圈在同一執行緒中執行時，無法呼叫此函式。"

#: ../../library/asyncio-runner.rst:36 ../../library/asyncio-runner.rst:85
msgid ""
"If *debug* is ``True``, the event loop will be run in debug mode. ``False`` "
"disables debug mode explicitly. ``None`` is used to respect the global :ref:"
"`asyncio-debug-mode` settings."
msgstr ""
"如果 *debug* 為 ``True``，事件迴圈會以除錯模式執行。``False`` 則會關閉除錯模"
"式。``None`` 則會優先使用\\ :ref:`除錯模式 <asyncio-debug-mode>`\\ 的全域設"
"定。"

#: ../../library/asyncio-runner.rst:40
#, fuzzy
msgid ""
"If *loop_factory* is not ``None``, it is used to create a new event loop; "
"otherwise :func:`asyncio.new_event_loop` is used. The loop is closed at the "
"end. This function should be used as a main entry point for asyncio "
"programs, and should ideally only be called once. It is recommended to use "
"*loop_factory* to configure the event loop instead of policies. Passing :"
"class:`asyncio.EventLoop` allows running asyncio without the policy system."
msgstr ""
"如果 *loop_factory* 不為 ``None``，它會被用於建立一個新的事件迴圈；否則會改"
"用 :func:`asyncio.new_event_loop`。迴圈會在最後關閉。這個函式應該要作為"
"asyncio 程式的主要進入點，且理想上僅會被呼叫一次。推薦使用 *loop_factory* 來"
"設定事件迴圈時而不是使用 policies（政策）。"

#: ../../library/asyncio-runner.rst:48
msgid ""
"The executor is given a timeout duration of 5 minutes to shutdown. If the "
"executor hasn't finished within that duration, a warning is emitted and the "
"executor is closed."
msgstr ""

#: ../../library/asyncio-runner.rst:52
msgid "Example::"
msgstr "範例： ::"

#: ../../library/asyncio-runner.rst:54
msgid ""
"async def main():\n"
"    await asyncio.sleep(1)\n"
"    print('hello')\n"
"\n"
"asyncio.run(main())"
msgstr ""
"async def main():\n"
"    await asyncio.sleep(1)\n"
"    print('hello')\n"
"\n"
"asyncio.run(main())"

#: ../../library/asyncio-runner.rst:62
msgid "Updated to use :meth:`loop.shutdown_default_executor`."
msgstr ""

#: ../../library/asyncio-runner.rst:67
msgid ""
"*debug* is ``None`` by default to respect the global debug mode settings."
msgstr ""

#: ../../library/asyncio-runner.rst:71
msgid "Added *loop_factory* parameter."
msgstr "新增 *loop_factory* 參數。"

#: ../../library/asyncio-runner.rst:75
msgid "Runner context manager"
msgstr ""

#: ../../library/asyncio-runner.rst:79
msgid ""
"A context manager that simplifies *multiple* async function calls in the "
"same context."
msgstr ""

#: ../../library/asyncio-runner.rst:82
msgid ""
"Sometimes several top-level async functions should be called in the same :"
"ref:`event loop <asyncio-event-loop>` and :class:`contextvars.Context`."
msgstr ""

#: ../../library/asyncio-runner.rst:89
msgid ""
"*loop_factory* could be used for overriding the loop creation. It is the "
"responsibility of the *loop_factory* to set the created loop as the current "
"one. By default :func:`asyncio.new_event_loop` is used and set as current "
"event loop with :func:`asyncio.set_event_loop` if *loop_factory* is ``None``."
msgstr ""

#: ../../library/asyncio-runner.rst:94
msgid ""
"Basically, :func:`asyncio.run` example can be rewritten with the runner "
"usage::"
msgstr ""

#: ../../library/asyncio-runner.rst:96
msgid ""
"async def main():\n"
"    await asyncio.sleep(1)\n"
"    print('hello')\n"
"\n"
"with asyncio.Runner() as runner:\n"
"    runner.run(main())"
msgstr ""
"async def main():\n"
"    await asyncio.sleep(1)\n"
"    print('hello')\n"
"\n"
"with asyncio.Runner() as runner:\n"
"    runner.run(main())"

#: ../../library/asyncio-runner.rst:107
msgid "Run a :term:`coroutine <coroutine>` *coro* in the embedded loop."
msgstr ""

#: ../../library/asyncio-runner.rst:109
msgid "Return the coroutine's result or raise its exception."
msgstr ""

#: ../../library/asyncio-runner.rst:111
msgid ""
"An optional keyword-only *context* argument allows specifying a custom :"
"class:`contextvars.Context` for the *coro* to run in. The runner's default "
"context is used if ``None``."
msgstr ""

#: ../../library/asyncio-runner.rst:120
msgid "Close the runner."
msgstr ""

#: ../../library/asyncio-runner.rst:122
msgid ""
"Finalize asynchronous generators, shutdown default executor, close the event "
"loop and release embedded :class:`contextvars.Context`."
msgstr ""

#: ../../library/asyncio-runner.rst:127
msgid "Return the event loop associated with the runner instance."
msgstr ""

#: ../../library/asyncio-runner.rst:131
msgid ""
":class:`Runner` uses the lazy initialization strategy, its constructor "
"doesn't initialize underlying low-level structures."
msgstr ""

#: ../../library/asyncio-runner.rst:134
msgid ""
"Embedded *loop* and *context* are created at the :keyword:`with` body "
"entering or the first call of :meth:`run` or :meth:`get_loop`."
msgstr ""

#: ../../library/asyncio-runner.rst:139
msgid "Handling Keyboard Interruption"
msgstr ""

#: ../../library/asyncio-runner.rst:143
msgid ""
"When :const:`signal.SIGINT` is raised by :kbd:`Ctrl-C`, :exc:"
"`KeyboardInterrupt` exception is raised in the main thread by default. "
"However this doesn't work with :mod:`asyncio` because it can interrupt "
"asyncio internals and can hang the program from exiting."
msgstr ""

#: ../../library/asyncio-runner.rst:148
msgid ""
"To mitigate this issue, :mod:`asyncio` handles :const:`signal.SIGINT` as "
"follows:"
msgstr ""

#: ../../library/asyncio-runner.rst:150
msgid ""
":meth:`asyncio.Runner.run` installs a custom :const:`signal.SIGINT` handler "
"before any user code is executed and removes it when exiting from the "
"function."
msgstr ""

#: ../../library/asyncio-runner.rst:152
msgid ""
"The :class:`~asyncio.Runner` creates the main task for the passed coroutine "
"for its execution."
msgstr ""

#: ../../library/asyncio-runner.rst:154
msgid ""
"When :const:`signal.SIGINT` is raised by :kbd:`Ctrl-C`, the custom signal "
"handler cancels the main task by calling :meth:`asyncio.Task.cancel` which "
"raises :exc:`asyncio.CancelledError` inside the main task.  This causes the "
"Python stack to unwind, ``try/except`` and ``try/finally`` blocks can be "
"used for resource cleanup.  After the main task is cancelled, :meth:`asyncio."
"Runner.run` raises :exc:`KeyboardInterrupt`."
msgstr ""

#: ../../library/asyncio-runner.rst:160
msgid ""
"A user could write a tight loop which cannot be interrupted by :meth:"
"`asyncio.Task.cancel`, in which case the second following :kbd:`Ctrl-C` "
"immediately raises the :exc:`KeyboardInterrupt` without cancelling the main "
"task."
msgstr ""