GeezerVison is showing github.com — python-docs-ja/library/asyncio-runner.po at 3.12 · python/python-docs-ja

Expand file tree

asyncio-runner.po

Copy path

More file actions

Latest commit

History

278 lines (237 loc) · 9.34 KB

asyncio-runner.po

Copy path

File metadata and controls

278 lines (237 loc) · 9.34 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

260

261

262

263

264

265

266

267

268

269

270

271

272

273

274

275

276

277

278

# SOME DESCRIPTIVE TITLE.

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

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

# Translators:

# Takeshi Nakazato, 2022

# tomo, 2022

# 菊池健志, 2023

#, fuzzy

msgid ""

msgstr ""

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

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

"POT-Creation-Date: 2025-05-08 02:53-0300\n"

"PO-Revision-Date: 2022-11-05 19:48+0000\n"

"Last-Translator: 菊池健志, 2023\n"

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

"ja/)\n"

"Language: ja\n"

"MIME-Version: 1.0\n"

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

"Content-Transfer-Encoding: 8bit\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 ""