- Notifications
You must be signed in to change notification settings - Fork 32
/
Copy pathasyncio-stream.po
752 lines (651 loc) · 28.2 KB
/
asyncio-stream.po
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
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
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2025, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Takeshi Nakazato, 2022
# Arihiro TAKASE, 2023
# tomo, 2023
# Rafael Fontenelle <rffontenelle@gmail.com>, 2024
#
#,fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-04-04 14:18+0000\n"
"PO-Revision-Date: 2021-06-28 00:55+0000\n"
"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2024\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-stream.rst:7
msgid"Streams"
msgstr"ストリーム"
#:../../library/asyncio-stream.rst:9
msgid"**Source code:** :source:`Lib/asyncio/streams.py`"
msgstr"**ソースコード:** :source:`Lib/asyncio/streams.py`"
#:../../library/asyncio-stream.rst:13
msgid""
"Streams are high-level async/await-ready primitives to work with network "
"connections. Streams allow sending and receiving data without using "
"callbacks or low-level protocols and transports."
msgstr""
"ストリームはネットワークコネクションと合わせて動作する高水準の async/await 可"
"能な基本要素です。ストリームはコールバックや低水準のプロトコルやトランスポー"
"トを使うことなくデータを送受信することを可能にします。"
#:../../library/asyncio-stream.rst:19
msgid"Here is an example of a TCP echo client written using asyncio streams::"
msgstr""
"以下は asyncio ストリームを使って書いた TCP エコークライアントの例です::"
#:../../library/asyncio-stream.rst:22../../library/asyncio-stream.rst:430
msgid""
"import asyncio\n"
"\n"
"async def tcp_echo_client(message):\n"
" reader, writer = await asyncio.open_connection(\n"
" '127.0.0.1', 8888)\n"
"\n"
" print(f'Send: {message!r}')\n"
" writer.write(message.encode())\n"
" await writer.drain()\n"
"\n"
" data = await reader.read(100)\n"
" print(f'Received: {data.decode()!r}')\n"
"\n"
" print('Close the connection')\n"
" writer.close()\n"
" await writer.wait_closed()\n"
"\n"
"asyncio.run(tcp_echo_client('Hello World!'))"
msgstr""
#:../../library/asyncio-stream.rst:42
msgid"See also the `Examples`_ section below."
msgstr"下記の `使用例`_ 節も参照してください。"
#:../../library/asyncio-stream.rst:46
msgid"Stream Functions"
msgstr"ストリーム関数"
#:../../library/asyncio-stream.rst:47
msgid""
"The following top-level asyncio functions can be used to create and work "
"with streams:"
msgstr""
"以下の asyncio のトップレベル関数はストリームの作成や操作を行うことができま"
"す:"
#:../../library/asyncio-stream.rst:59
msgid""
"Establish a network connection and return a pair of ``(reader, writer)`` "
"objects."
msgstr""
"ネットワークコネクションを確立し、 ``(reader, writer)`` のオブジェクトのペア"
"を返します。"
#:../../library/asyncio-stream.rst:62
msgid""
"The returned *reader* and *writer* objects are instances of :class:"
"`StreamReader` and :class:`StreamWriter` classes."
msgstr""
"戻り値の *reader* と *writer* はそれぞれ :class:`StreamReader` と :class:"
"`StreamWriter` クラスのインスタンスです。"
#:../../library/asyncio-stream.rst:65../../library/asyncio-stream.rst:112
msgid""
"*limit* determines the buffer size limit used by the returned :class:"
"`StreamReader` instance. By default the *limit* is set to 64 KiB."
msgstr""
"*limit* は戻り値の :class:`StreamReader` インスタンスが利用するバッファのサイ"
"ズの上限値を設定します。デフォルトでは *limit* は 64 KiB に設定されます。"
#:../../library/asyncio-stream.rst:69
msgid""
"The rest of the arguments are passed directly to :meth:`loop."
"create_connection`."
msgstr"残りの引数は直接 :meth:`loop.create_connection` に渡されます。"
#:../../library/asyncio-stream.rst:74../../library/asyncio-stream.rst:154
msgid""
"The *sock* argument transfers ownership of the socket to the :class:"
"`StreamWriter` created. To close the socket, call its :meth:`~asyncio."
"StreamWriter.close` method."
msgstr""
#:../../library/asyncio-stream.rst:78
msgid"Added the *ssl_handshake_timeout* parameter."
msgstr""
#:../../library/asyncio-stream.rst:81
msgid"Added the *happy_eyeballs_delay* and *interleave* parameters."
msgstr"*happy_eyeballs_delay* と *interleave* が追加されました。"
#:../../library/asyncio-stream.rst:84../../library/asyncio-stream.rst:128
#:../../library/asyncio-stream.rst:164../../library/asyncio-stream.rst:195
msgid"Removed the *loop* parameter."
msgstr"*loop* パラメータが削除されました。"
#:../../library/asyncio-stream.rst:87../../library/asyncio-stream.rst:131
#:../../library/asyncio-stream.rst:167../../library/asyncio-stream.rst:198
#:../../library/asyncio-stream.rst:397
msgid"Added the *ssl_shutdown_timeout* parameter."
msgstr"*ssl_shutdown_timeout* パラメータが追加されました。"
#:../../library/asyncio-stream.rst:101
msgid"Start a socket server."
msgstr"ソケットサーバーを起動します。"
#:../../library/asyncio-stream.rst:103
msgid""
"The *client_connected_cb* callback is called whenever a new client "
"connection is established. It receives a ``(reader, writer)`` pair as two "
"arguments, instances of the :class:`StreamReader` and :class:`StreamWriter` "
"classes."
msgstr""
"*client_connected_cb* コールバックは新しいクライアントコネクションが確立され"
"るたびに呼び出されます。このコールバックは :class:`StreamReader` と :class:"
"`StreamWriter` クラスのインスタンスのペア ``(reader, writer)`` を2つの引数と"
"して受け取ります。"
#:../../library/asyncio-stream.rst:108
msgid""
"*client_connected_cb* can be a plain callable or a :ref:`coroutine function "
"<coroutine>`; if it is a coroutine function, it will be automatically "
"scheduled as a :class:`Task`."
msgstr""
"*client_connected_cb* には単純な呼び出し可能オブジェクトか、または :ref:`コ"
"ルーチン関数 <coroutine>` を指定します; コルーチン関数が指定された場合、コー"
"ルバックの呼び出しは自動的に :class:`Task` としてスケジュールされます。"
#:../../library/asyncio-stream.rst:116
msgid""
"The rest of the arguments are passed directly to :meth:`loop.create_server`."
msgstr"残りの引数は直接 :meth:`loop.create_server` に渡されます。"
#:../../library/asyncio-stream.rst:121../../library/asyncio-stream.rst:185
msgid""
"The *sock* argument transfers ownership of the socket to the server created. "
"To close the socket, call the server's :meth:`~asyncio.Server.close` method."
msgstr""
#:../../library/asyncio-stream.rst:125
msgid"Added the *ssl_handshake_timeout* and *start_serving* parameters."
msgstr""
"*ssl_handshake_timeout* と *start_serving* パラメータが追加されました。"
#:../../library/asyncio-stream.rst:134
msgid"Added the *keep_alive* parameter."
msgstr""
#:../../library/asyncio-stream.rst:139
msgid"Unix Sockets"
msgstr"Unix ソケット"
#:../../library/asyncio-stream.rst:145
msgid""
"Establish a Unix socket connection and return a pair of ``(reader, writer)``."
msgstr""
"Unix ソケットコネクションを確立し、 ``(reader, writer)`` のオブジェクトのペア"
"を返します。"
#:../../library/asyncio-stream.rst:148
msgid"Similar to :func:`open_connection` but operates on Unix sockets."
msgstr""
"この関数は :func:`open_connection` と似ていますが Unix ソケットに対して動作し"
"ます。"
#:../../library/asyncio-stream.rst:150
msgid"See also the documentation of :meth:`loop.create_unix_connection`."
msgstr":meth:`loop.create_unix_connection` のドキュメントも参照してください。"
#:../../library/asyncio-stream.rst:158../../library/asyncio-stream.rst:189
msgid"Availability"
msgstr""
#:../../library/asyncio-stream.rst:160
msgid""
"Added the *ssl_handshake_timeout* parameter. The *path* parameter can now be "
"a :term:`path-like object`"
msgstr""
#:../../library/asyncio-stream.rst:177
msgid"Start a Unix socket server."
msgstr"Unix のソケットサーバーを起動します。"
#:../../library/asyncio-stream.rst:179
msgid"Similar to :func:`start_server` but works with Unix sockets."
msgstr":func:`start_server` と似ていますが Unix ソケットに対して動作します。"
#:../../library/asyncio-stream.rst:181
msgid"See also the documentation of :meth:`loop.create_unix_server`."
msgstr":meth:`loop.create_unix_server` のドキュメントも参照してください。"
#:../../library/asyncio-stream.rst:191
msgid""
"Added the *ssl_handshake_timeout* and *start_serving* parameters. The *path* "
"parameter can now be a :term:`path-like object`."
msgstr""
#:../../library/asyncio-stream.rst:203
msgid"StreamReader"
msgstr"StreamReader"
#:../../library/asyncio-stream.rst:207
msgid""
"Represents a reader object that provides APIs to read data from the IO "
"stream. As an :term:`asynchronous iterable`, the object supports the :"
"keyword:`async for` statement."
msgstr""
#:../../library/asyncio-stream.rst:211
msgid""
"It is not recommended to instantiate *StreamReader* objects directly; use :"
"func:`open_connection` and :func:`start_server` instead."
msgstr""
"*StreamReader* オブジェクトを直接インスタンス化することは推奨されません; 代わ"
"りに :func:`open_connection` や :func:`start_server` を使ってください。"
#:../../library/asyncio-stream.rst:217
msgid"Acknowledge the EOF."
msgstr"EOF の肯定応答を行います。"
#:../../library/asyncio-stream.rst:222
msgid"Read up to *n* bytes from the stream."
msgstr"ストリームから最大 *n* バイト読み込みます。"
#:../../library/asyncio-stream.rst:224
msgid""
"If *n* is not provided or set to ``-1``, read until EOF, then return all "
"read :class:`bytes`. If EOF was received and the internal buffer is empty, "
"return an empty ``bytes`` object."
msgstr""
"*n* が指定されないか ``-1`` が指定されていた場合 EOF になるまで読み込み、読み"
"込まれた全ての :class:`bytes` を返します。EOF を受信し、かつ内部バッファーが"
"空の場合、空の ``bytes`` オブジェクトを返します。"
#:../../library/asyncio-stream.rst:229
msgid"If *n* is ``0``, return an empty ``bytes`` object immediately."
msgstr"*n* が ``0`` なら、ただちに空の ``bytes`` オブジェクトを返します。"
#:../../library/asyncio-stream.rst:231
msgid""
"If *n* is positive, return at most *n* available ``bytes`` as soon as at "
"least 1 byte is available in the internal buffer. If EOF is received before "
"any byte is read, return an empty ``bytes`` object."
msgstr""
"*n* が正なら、内部バッファで最低でも 1 バイトが利用可能になり次第、利用可能な"
"最大 *n* ``bytes`` を返します。1 バイトも読み込まないうちに EOF を受信したな"
"ら、空の ``bytes`` オブジェクトを返します。"
#:../../library/asyncio-stream.rst:239
msgid""
"Read one line, where \"line\" is a sequence of bytes ending with ``\\n``."
msgstr""
"1 行読み込みます。 \"行\" とは、``\\n`` で終了するバイト列のシーケンスです。"
#:../../library/asyncio-stream.rst:242
msgid""
"If EOF is received and ``\\n`` was not found, the method returns partially "
"read data."
msgstr""
"EOF を受信し、かつ ``\\n`` が見つからない場合、このメソッドは部分的に読み込ん"
"だデータを返します。"
#:../../library/asyncio-stream.rst:245
msgid""
"If EOF is received and the internal buffer is empty, return an empty "
"``bytes`` object."
msgstr""
"EOF を受信し、かつ内部バッファーが空の場合、空の ``bytes`` オブジェクトを返し"
"ます。"
#:../../library/asyncio-stream.rst:251
msgid"Read exactly *n* bytes."
msgstr"厳密に *n* バイトのデータを読み出します。"
#:../../library/asyncio-stream.rst:253
msgid""
"Raise an :exc:`IncompleteReadError` if EOF is reached before *n* can be "
"read. Use the :attr:`IncompleteReadError.partial` attribute to get the "
"partially read data."
msgstr""
"*n* バイトを読み出す前に EOF に達した場合 :exc:`IncompleteReadError` を送出し"
"ます。部分的に読み出したデータを取得するには :attr:`IncompleteReadError."
"partial` 属性を使ってください。"
#:../../library/asyncio-stream.rst:260
msgid"Read data from the stream until *separator* is found."
msgstr"*separator* が見つかるまでストリームからデータを読み出します。"
#:../../library/asyncio-stream.rst:262
msgid""
"On success, the data and separator will be removed from the internal buffer "
"(consumed). Returned data will include the separator at the end."
msgstr""
"成功時には、データと区切り文字は内部バッファから削除されます (消費されます)。"
"返されるデータの最後には区切り文字が含まれます。"
#:../../library/asyncio-stream.rst:266
msgid""
"If the amount of data read exceeds the configured stream limit, a :exc:"
"`LimitOverrunError` exception is raised, and the data is left in the "
"internal buffer and can be read again."
msgstr""
"読み出したデータの量が設定したストリームの上限を超えると :exc:"
"`LimitOverrunError` 例外が送出されます。このときデータは内部バッファーに残さ"
"れ、再度読み出すことができます。"
#:../../library/asyncio-stream.rst:270
msgid""
"If EOF is reached before the complete separator is found, an :exc:"
"`IncompleteReadError` exception is raised, and the internal buffer is "
"reset. The :attr:`IncompleteReadError.partial` attribute may contain a "
"portion of the separator."
msgstr""
"完全な区切り文字が見つかる前に EOF に達すると :exc:`IncompleteReadError` 例"
"外が送出され、内部バッファーがリセットされます。このとき :attr:"
"`IncompleteReadError.partial` 属性は区切り文字の一部を含むかもしれません。"
#:../../library/asyncio-stream.rst:275
msgid""
"The *separator* may also be a tuple of separators. In this case the return "
"value will be the shortest possible that has any separator as the suffix. "
"For the purposes of :exc:`LimitOverrunError`, the shortest possible "
"separator is considered to be the one that matched."
msgstr""
#:../../library/asyncio-stream.rst:285
msgid"The *separator* parameter may now be a :class:`tuple` of separators."
msgstr""
#:../../library/asyncio-stream.rst:290
msgid"Return ``True`` if the buffer is empty and :meth:`feed_eof` was called."
msgstr""
"バッファーが空で :meth:`feed_eof` が呼ばれていた場合 ``True`` を返します。"
#:../../library/asyncio-stream.rst:295
msgid"StreamWriter"
msgstr"StreamWriter"
#:../../library/asyncio-stream.rst:299
msgid""
"Represents a writer object that provides APIs to write data to the IO stream."
msgstr""
"IO ストリームにデータを書き込むための API を提供するライターオブジェクトを表"
"します。"
#:../../library/asyncio-stream.rst:302
msgid""
"It is not recommended to instantiate *StreamWriter* objects directly; use :"
"func:`open_connection` and :func:`start_server` instead."
msgstr""
"*StreamWriter* オブジェクトを直接インスタンス化することは推奨されません; 代わ"
"りに :func:`open_connection` や :func:`start_server` を使ってください。"
#:../../library/asyncio-stream.rst:308
msgid""
"The method attempts to write the *data* to the underlying socket "
"immediately. If that fails, the data is queued in an internal write buffer "
"until it can be sent."
msgstr""
"このメソッドは、背後にあるソケットにデータ *data* を即座に書き込みます。書き"
"込みに失敗した場合、データは送信可能になるまで内部の書き込みバッファーに格納"
"されて待機します。"
#:../../library/asyncio-stream.rst:312../../library/asyncio-stream.rst:324
msgid"The method should be used along with the ``drain()`` method::"
msgstr"このメソッドは ``drain()`` メソッドと組み合わせて使うべきです::"
#:../../library/asyncio-stream.rst:314
msgid""
"stream.write(data)\n"
"await stream.drain()"
msgstr""
#:../../library/asyncio-stream.rst:319
msgid""
"The method writes a list (or any iterable) of bytes to the underlying socket "
"immediately. If that fails, the data is queued in an internal write buffer "
"until it can be sent."
msgstr""
"このメソッドは、背後にあるソケットにバイトデータのリスト (またはイテラブル) "
"を即座に書き込みます。書き込みに失敗した場合、データは送信可能になるまで内部"
"の書き込みバッファーに格納されて待機します。"
#:../../library/asyncio-stream.rst:326
msgid""
"stream.writelines(lines)\n"
"await stream.drain()"
msgstr""
#:../../library/asyncio-stream.rst:331
msgid"The method closes the stream and the underlying socket."
msgstr"このメソッドはストリームと背後にあるソケットをクローズします。"
#:../../library/asyncio-stream.rst:333
msgid""
"The method should be used, though not mandatory, along with the "
"``wait_closed()`` method::"
msgstr""
#:../../library/asyncio-stream.rst:336
msgid""
"stream.close()\n"
"await stream.wait_closed()"
msgstr""
#:../../library/asyncio-stream.rst:341
msgid""
"Return ``True`` if the underlying transport supports the :meth:`write_eof` "
"method, ``False`` otherwise."
msgstr""
"背後にあるトランスポートが :meth:`write_eof` メソッドをサポートしている場合 "
"``True`` を返し、そうでない場合は ``False`` を返します。"
#:../../library/asyncio-stream.rst:346
msgid""
"Close the write end of the stream after the buffered write data is flushed."
msgstr""
"バッファーされた書き込みデータを全て書き込んでから、ストリームの書き込み側終"
"端をクローズします。"
#:../../library/asyncio-stream.rst:351
msgid"Return the underlying asyncio transport."
msgstr"背後にある asyncio トランスポートを返します。"
#:../../library/asyncio-stream.rst:355
msgid""
"Access optional transport information; see :meth:`BaseTransport."
"get_extra_info` for details."
msgstr""
"オプションのトランスポート情報にアクセスします。詳細は :meth:`BaseTransport."
"get_extra_info` を参照してください。"
#:../../library/asyncio-stream.rst:361
msgid"Wait until it is appropriate to resume writing to the stream. Example::"
msgstr"ストリームへの書き込み再開に適切な状態になるまで待ちます。使用例::"
#:../../library/asyncio-stream.rst:364
msgid""
"writer.write(data)\n"
"await writer.drain()"
msgstr""
#:../../library/asyncio-stream.rst:367
msgid""
"This is a flow control method that interacts with the underlying IO write "
"buffer. When the size of the buffer reaches the high watermark, *drain()* "
"blocks until the size of the buffer is drained down to the low watermark and "
"writing can be resumed. When there is nothing to wait for, the :meth:"
"`drain` returns immediately."
msgstr""
"このメソッドは背後にある IO 書き込みバッファーとやりとりを行うフロー制御メ"
"ソッドです。バッファーのサイズが最高水位点に達した場合、*drain()* はバッファ"
"のサイズが最低水位点を下回るまで減量され、書き込み再開可能になるまで書き込み"
"をブロックします。待ち受けの必要がない場合、 :meth:`drain` は即座にリターンし"
"ます。"
#:../../library/asyncio-stream.rst:378
msgid"Upgrade an existing stream-based connection to TLS."
msgstr""
#:../../library/asyncio-stream.rst:380
msgid"Parameters:"
msgstr"引数:"
#:../../library/asyncio-stream.rst:382
msgid"*sslcontext*: a configured instance of :class:`~ssl.SSLContext`."
msgstr"*sslcontext*: 構成済みの :class:`~ssl.SSLContext` インスタンスです。"
#:../../library/asyncio-stream.rst:384
msgid""
"*server_hostname*: sets or overrides the host name that the target server's "
"certificate will be matched against."
msgstr""
"*server_hostname*: 対象のサーバーの証明書との照合に使われるホスト名を設定また"
"は上書きします。"
#:../../library/asyncio-stream.rst:387
msgid""
"*ssl_handshake_timeout* is the time in seconds to wait for the TLS handshake "
"to complete before aborting the connection. ``60.0`` seconds if ``None`` "
"(default)."
msgstr""
#:../../library/asyncio-stream.rst:391
msgid""
"*ssl_shutdown_timeout* is the time in seconds to wait for the SSL shutdown "
"to complete before aborting the connection. ``30.0`` seconds if ``None`` "
"(default)."
msgstr""
#:../../library/asyncio-stream.rst:403
msgid""
"Return ``True`` if the stream is closed or in the process of being closed."
msgstr""
"ストリームがクローズされたか、またはクローズ処理中の場合に ``True`` を返しま"
"す。"
#:../../library/asyncio-stream.rst:411
msgid"Wait until the stream is closed."
msgstr"ストリームがクローズされるまで待機します。"
#:../../library/asyncio-stream.rst:413
msgid""
"Should be called after :meth:`close` to wait until the underlying connection "
"is closed, ensuring that all data has been flushed before e.g. exiting the "
"program."
msgstr""
#:../../library/asyncio-stream.rst:421
msgid"Examples"
msgstr"使用例"
#:../../library/asyncio-stream.rst:426
msgid"TCP echo client using streams"
msgstr"ストリームを使った TCP Echo クライアント"
#:../../library/asyncio-stream.rst:428
msgid"TCP echo client using the :func:`asyncio.open_connection` function::"
msgstr""
":func:`asyncio.open_connection` 関数を使った TCP Echo クライアントです::"
#:../../library/asyncio-stream.rst:452
msgid""
"The :ref:`TCP echo client protocol "
"<asyncio_example_tcp_echo_client_protocol>` example uses the low-level :meth:"
"`loop.create_connection` method."
msgstr""
":ref:`TCP エコークライアントプロトコル "
"<asyncio_example_tcp_echo_client_protocol>` の例は低水準の :meth:`loop."
"create_connection` メソッドを使っています。"
#:../../library/asyncio-stream.rst:459
msgid"TCP echo server using streams"
msgstr"ストリームを使った TCP Echo サーバー"
#:../../library/asyncio-stream.rst:461
msgid"TCP echo server using the :func:`asyncio.start_server` function::"
msgstr":func:`asyncio.start_server` 関数を使った TCP Echo サーバーです::"
#:../../library/asyncio-stream.rst:463
msgid""
"import asyncio\n"
"\n"
"async def handle_echo(reader, writer):\n"
" data = await reader.read(100)\n"
" message = data.decode()\n"
" addr = writer.get_extra_info('peername')\n"
"\n"
" print(f\"Received {message!r} from {addr!r}\")\n"
"\n"
" print(f\"Send: {message!r}\")\n"
" writer.write(data)\n"
" await writer.drain()\n"
"\n"
" print(\"Close the connection\")\n"
" writer.close()\n"
" await writer.wait_closed()\n"
"\n"
"async def main():\n"
" server = await asyncio.start_server(\n"
" handle_echo, '127.0.0.1', 8888)\n"
"\n"
" addrs = ', '.join(str(sock.getsockname()) for sock in server.sockets)\n"
" print(f'Serving on {addrs}')\n"
"\n"
" async with server:\n"
" await server.serve_forever()\n"
"\n"
"asyncio.run(main())"
msgstr""
#:../../library/asyncio-stream.rst:495
msgid""
"The :ref:`TCP echo server protocol "
"<asyncio_example_tcp_echo_server_protocol>` example uses the :meth:`loop."
"create_server` method."
msgstr""
":ref:`TCP エコーサーバープロトコル "
"<asyncio_example_tcp_echo_server_protocol>` の例は :meth:`loop."
"create_server` メソッドを使っています。"
#:../../library/asyncio-stream.rst:500
msgid"Get HTTP headers"
msgstr"HTTP ヘッダーの取得"
#:../../library/asyncio-stream.rst:502
msgid""
"Simple example querying HTTP headers of the URL passed on the command line::"
msgstr""
"コマンドラインから渡された URL の HTTP ヘッダーを問い合わせる簡単な例です::"
#:../../library/asyncio-stream.rst:504
msgid""
"import asyncio\n"
"import urllib.parse\n"
"import sys\n"
"\n"
"async def print_http_headers(url):\n"
" url = urllib.parse.urlsplit(url)\n"
" if url.scheme == 'https':\n"
" reader, writer = await asyncio.open_connection(\n"
" url.hostname, 443, ssl=True)\n"
" else:\n"
" reader, writer = await asyncio.open_connection(\n"
" url.hostname, 80)\n"
"\n"
" query = (\n"
" f\"HEAD {url.path or '/'} HTTP/1.0\\r\\n\"\n"
" f\"Host: {url.hostname}\\r\\n\"\n"
" f\"\\r\\n\"\n"
" )\n"
"\n"
" writer.write(query.encode('latin-1'))\n"
" while True:\n"
" line = await reader.readline()\n"
" if not line:\n"
" break\n"
"\n"
" line = line.decode('latin1').rstrip()\n"
" if line:\n"
" print(f'HTTP header> {line}')\n"
"\n"
" # Ignore the body, close the socket\n"
" writer.close()\n"
" await writer.wait_closed()\n"
"\n"
"url = sys.argv[1]\n"
"asyncio.run(print_http_headers(url))"
msgstr""
#:../../library/asyncio-stream.rst:541
msgid"Usage::"
msgstr"使い方::"
#:../../library/asyncio-stream.rst:543
msgid"python example.py http://example.com/path/page.html"
msgstr""
#:../../library/asyncio-stream.rst:545
msgid"or with HTTPS::"
msgstr"または HTTPS を使用::"
#:../../library/asyncio-stream.rst:547
msgid"python example.py https://example.com/path/page.html"
msgstr""
#:../../library/asyncio-stream.rst:553
msgid"Register an open socket to wait for data using streams"
msgstr"ストリームを使ってデータを待つオープンソケットの登録"
#:../../library/asyncio-stream.rst:555
msgid""
"Coroutine waiting until a socket receives data using the :func:"
"`open_connection` function::"
msgstr""
":func:`open_connection` 関数を使ってソケットがデータを受信するまで待つコルー"
"チンです::"
#:../../library/asyncio-stream.rst:558
msgid""
"import asyncio\n"
"import socket\n"
"\n"
"async def wait_for_data():\n"
" # Get a reference to the current event loop because\n"
" # we want to access low-level APIs.\n"
" loop = asyncio.get_running_loop()\n"
"\n"
" # Create a pair of connected sockets.\n"
" rsock, wsock = socket.socketpair()\n"
"\n"
" # Register the open socket to wait for data.\n"
" reader, writer = await asyncio.open_connection(sock=rsock)\n"
"\n"
" # Simulate the reception of data from the network\n"
" loop.call_soon(wsock.send, 'abc'.encode())\n"
"\n"
" # Wait for data\n"
" data = await reader.read(100)\n"
"\n"
" # Got data, we are done: close the socket\n"
" print(\"Received:\", data.decode())\n"
" writer.close()\n"
" await writer.wait_closed()\n"
"\n"
" # Close the second socket\n"
" wsock.close()\n"
"\n"
"asyncio.run(wait_for_data())"
msgstr""
#:../../library/asyncio-stream.rst:590
msgid""
"The :ref:`register an open socket to wait for data using a protocol "
"<asyncio_example_create_connection>` example uses a low-level protocol and "
"the :meth:`loop.create_connection` method."
msgstr""
":ref:`プロトコルを使ってオープンしたソケットをデータ待ち受けのために登録する "
"<asyncio_example_create_connection>` 例では、低水準のプロトコルと :meth:"
"`loop.create_connection` メソッドを使っています。"
#:../../library/asyncio-stream.rst:594
msgid""
"The :ref:`watch a file descriptor for read events "
"<asyncio_example_watch_fd>` example uses the low-level :meth:`loop."
"add_reader` method to watch a file descriptor."
msgstr""
":ref:`ファイル記述子の読み出しイベントを監視する <asyncio_example_watch_fd>` "
"例では、低水準の :meth:`loop.add_reader` メソッドを使ってファイル記述子を監視"
"しています。"