# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001 Python Software Foundation

# This file is distributed under the same license as the Python package.

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

#

# Translators:

# python-doc bot, 2025

# Takanori Suzuki <takanori@takanory.net>, 2026

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.14\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2026-04-17 14:50+0000\n"

"PO-Revision-Date: 2025-09-16 00:00+0000\n"

"Last-Translator: Takanori Suzuki <takanori@takanory.net>, 2026\n"

"Language-Team: Japanese (https://app.transifex.com/python-doc/teams/5390/"

"ja/)\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Language: ja\n"

"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../library/asyncio-runner.rst:6

msgid "Runners"

msgstr ""

#: ../../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 "非同期プログラムの実行"

#: ../../library/asyncio-runner.rst:27

msgid "Execute *coro* in an asyncio event loop and return the result."

msgstr ""

#: ../../library/asyncio-runner.rst:29 ../../library/asyncio-runner.rst:121

msgid "The argument can be any awaitable object."

msgstr ""

#: ../../library/asyncio-runner.rst:31

msgid ""

"This function runs the awaitable, taking care of managing the asyncio event "

"loop, *finalizing asynchronous generators*, and closing the executor."

msgstr ""

#: ../../library/asyncio-runner.rst:35 ../../library/asyncio-runner.rst:131

msgid ""

"This function cannot be called when another asyncio event loop is running in "

"the same thread."

msgstr ""

"この関数は、同じスレッドで他の非同期イベントループが実行中のときは呼び出せま"

"せん。"

#: ../../library/asyncio-runner.rst:38 ../../library/asyncio-runner.rst:97

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`` は明示的にデバッグモードを無効化します。 グローバルな :ref:"

"`asyncio-debug-mode` 設定を尊重するために ``None`` が使用されます。"

#: ../../library/asyncio-runner.rst:42

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 ""

#: ../../library/asyncio-runner.rst:50

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:54

msgid "Example::"

msgstr "以下はプログラム例です::"

#: ../../library/asyncio-runner.rst:56

msgid ""

"async def main():\n"

" await asyncio.sleep(1)\n"

" print('hello')\n"

"\n"

"asyncio.run(main())"

msgstr ""

#: ../../library/asyncio-runner.rst:64

msgid "Updated to use :meth:`loop.shutdown_default_executor`."

msgstr ""

":meth:`loop.shutdown_default_executor` メソッドを使うように更新されました。"

#: ../../library/asyncio-runner.rst:69

msgid ""

"*debug* is ``None`` by default to respect the global debug mode settings."

msgstr ""

"*debug* はグローバルなデバッグモード設定を尊重するためにデフォルトで "

"``None`` です。"

#: ../../library/asyncio-runner.rst:73

msgid "Added *loop_factory* parameter."

msgstr "*loop_factory* 引数が追加されました。"

#: ../../library/asyncio-runner.rst:77 ../../library/asyncio-runner.rst:136

msgid "*coro* can be any awaitable object."

msgstr ""

#: ../../library/asyncio-runner.rst:81

msgid ""

"The :mod:`!asyncio` policy system is deprecated and will be removed in "

"Python 3.16; from there on, an explicit *loop_factory* is needed to "

"configure the event loop."

msgstr ""

#: ../../library/asyncio-runner.rst:87

msgid "Runner context manager"

msgstr ""

#: ../../library/asyncio-runner.rst:91

msgid ""

"A context manager that simplifies *multiple* async function calls in the "

"same context."

msgstr ""

"同じコンテキスト上での *複数* の非同期関数呼び出しをシンプルにするコンテキス"

"トマネージャ。"

#: ../../library/asyncio-runner.rst:94

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:101

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:106

msgid ""

"Basically, :func:`asyncio.run` example can be rewritten with the runner "

"usage::"

msgstr ""

#: ../../library/asyncio-runner.rst:108

msgid ""

"async def main():\n"

" await asyncio.sleep(1)\n"

" print('hello')\n"

"\n"

"with asyncio.Runner() as runner:\n"

" runner.run(main())"

msgstr ""

#: ../../library/asyncio-runner.rst:119

msgid "Execute *coro* in the embedded event loop."

msgstr ""

#: ../../library/asyncio-runner.rst:123

msgid "If the argument is a coroutine, it is wrapped in a Task."

msgstr ""

#: ../../library/asyncio-runner.rst:125

msgid ""

"An optional keyword-only *context* argument allows specifying a custom :"

"class:`contextvars.Context` for the code to run in. The runner's default "

"context is used if context is ``None``."

msgstr ""

#: ../../library/asyncio-runner.rst:129

msgid "Returns the awaitable's result or raises an exception."

msgstr ""

#: ../../library/asyncio-runner.rst:140

msgid "Close the runner."

msgstr ""

#: ../../library/asyncio-runner.rst:142

msgid ""

"Finalize asynchronous generators, shutdown default executor, close the event "

"loop and release embedded :class:`contextvars.Context`."

msgstr ""

#: ../../library/asyncio-runner.rst:147

msgid "Return the event loop associated with the runner instance."

msgstr ""

#: ../../library/asyncio-runner.rst:151

msgid ""

":class:`Runner` uses the lazy initialization strategy, its constructor "

"doesn't initialize underlying low-level structures."

msgstr ""

#: ../../library/asyncio-runner.rst:154

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:159

msgid "Handling Keyboard Interruption"

msgstr ""

#: ../../library/asyncio-runner.rst:163

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:168

msgid ""

"To mitigate this issue, :mod:`asyncio` handles :const:`signal.SIGINT` as "

"follows:"

msgstr ""

#: ../../library/asyncio-runner.rst:170

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:172

msgid ""

"The :class:`~asyncio.Runner` creates the main task for the passed coroutine "

"for its execution."

msgstr ""

#: ../../library/asyncio-runner.rst:174

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:180

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 ""