sync with cpython 8566ee25

Author: github-actions[bot]

library/asyncio-stream.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-08-19 00:16+0000\n"
+"POT-Creation-Date: 2025-10-05 00:16+0000\n"
 "PO-Revision-Date: 2022-10-31 16:28+0800\n"
 "Last-Translator: Matt Wang <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -42,7 +42,7 @@ msgstr ""
 msgid "Here is an example of a TCP echo client written using asyncio streams::"
 msgstr "這是一個使用 asyncio 串流編寫的 TCP echo 用戶端範例： ::"
 
-#: ../../library/asyncio-stream.rst:22 ../../library/asyncio-stream.rst:440
+#: ../../library/asyncio-stream.rst:22 ../../library/asyncio-stream.rst:441
 msgid ""
 "import asyncio\n"
 "\n"
@@ -146,7 +146,7 @@ msgstr "移除 *loop* 參數。"
 
 #: ../../library/asyncio-stream.rst:87 ../../library/asyncio-stream.rst:131
 #: ../../library/asyncio-stream.rst:167 ../../library/asyncio-stream.rst:202
-#: ../../library/asyncio-stream.rst:407
+#: ../../library/asyncio-stream.rst:408
 msgid "Added the *ssl_shutdown_timeout* parameter."
 msgstr "新增 *ssl_shutdown_timeout* 參數。"
 
@@ -409,25 +409,25 @@ msgstr ""
 "此方法會嘗試立即將 *data* 寫入到底層的 socket。如果失敗，資料會被放到內部寫入"
 "緩衝中排隊等待 (queue)，直到它可被發送。"
 
-#: ../../library/asyncio-stream.rst:319 ../../library/asyncio-stream.rst:334
+#: ../../library/asyncio-stream.rst:319
+msgid ""
+"The *data* buffer should be a bytes, bytearray, or C-contiguous one-"
+"dimensional memoryview object."
+msgstr ""
+
+#: ../../library/asyncio-stream.rst:322 ../../library/asyncio-stream.rst:335
 msgid "The method should be used along with the ``drain()`` method::"
 msgstr "此方法應當與 ``drain()`` 方法一起使用： ::"
 
-#: ../../library/asyncio-stream.rst:321
+#: ../../library/asyncio-stream.rst:324
 msgid ""
 "stream.write(data)\n"
 "await stream.drain()"
 msgstr ""
 "stream.write(data)\n"
 "await stream.drain()"
 
-#: ../../library/asyncio-stream.rst:325
-msgid ""
-"The *data* buffer should be a C contiguous one-dimensional :term:`bytes-like "
-"object <bytes-like object>`."
-msgstr ""
-
-#: ../../library/asyncio-stream.rst:329
+#: ../../library/asyncio-stream.rst:330
 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 "
@@ -436,68 +436,68 @@ msgstr ""
 "此方法會立即嘗試將一個位元組 list（或任何可疊代物件 (iterable)）寫入到底層的 "
 "socket。如果失敗，資料會被放到內部寫入緩衝中排隊等待，直到它可被發送。"
 
-#: ../../library/asyncio-stream.rst:336
+#: ../../library/asyncio-stream.rst:337
 msgid ""
 "stream.writelines(lines)\n"
 "await stream.drain()"
 msgstr ""
 "stream.writelines(lines)\n"
 "await stream.drain()"
 
-#: ../../library/asyncio-stream.rst:341
+#: ../../library/asyncio-stream.rst:342
 msgid "The method closes the stream and the underlying socket."
 msgstr "此方法會關閉串流以及底層的 socket。"
 
-#: ../../library/asyncio-stream.rst:343
+#: ../../library/asyncio-stream.rst:344
 msgid ""
 "The method should be used, though not mandatory, along with the "
 "``wait_closed()`` method::"
 msgstr "此方法應與 ``wait_closed()`` 方法一起使用，但並非強制： ::"
 
-#: ../../library/asyncio-stream.rst:346
+#: ../../library/asyncio-stream.rst:347
 msgid ""
 "stream.close()\n"
 "await stream.wait_closed()"
 msgstr ""
 "stream.close()\n"
 "await stream.wait_closed()"
 
-#: ../../library/asyncio-stream.rst:351
+#: ../../library/asyncio-stream.rst:352
 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:356
+#: ../../library/asyncio-stream.rst:357
 msgid ""
 "Close the write end of the stream after the buffered write data is flushed."
 msgstr "在已緩衝的寫入資料被清理 (flush) 後關閉串流的寫入端。"
 
-#: ../../library/asyncio-stream.rst:361
+#: ../../library/asyncio-stream.rst:362
 msgid "Return the underlying asyncio transport."
 msgstr "回傳底層的 asyncio 傳輸。"
 
-#: ../../library/asyncio-stream.rst:365
+#: ../../library/asyncio-stream.rst:366
 msgid ""
 "Access optional transport information; see :meth:`BaseTransport."
 "get_extra_info` for details."
 msgstr "存取可選的傳輸資訊；詳情請見 :meth:`BaseTransport.get_extra_info`。"
 
-#: ../../library/asyncio-stream.rst:371
+#: ../../library/asyncio-stream.rst:372
 msgid "Wait until it is appropriate to resume writing to the stream. Example::"
 msgstr "等待直到可以繼續寫入到串流。範例： ::"
 
-#: ../../library/asyncio-stream.rst:374
+#: ../../library/asyncio-stream.rst:375
 msgid ""
 "writer.write(data)\n"
 "await writer.drain()"
 msgstr ""
 "writer.write(data)\n"
 "await writer.drain()"
 
-#: ../../library/asyncio-stream.rst:377
+#: ../../library/asyncio-stream.rst:378
 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()* "
@@ -509,48 +509,48 @@ msgstr ""
 "(high watermark) 時，*drain()* 會阻塞直到緩衝區大小減少至最低標記位 (low "
 "watermark) 以便繼續寫入。當沒有要等待的資料時，:meth:`drain` 會立即回傳。"
 
-#: ../../library/asyncio-stream.rst:388
+#: ../../library/asyncio-stream.rst:389
 msgid "Upgrade an existing stream-based connection to TLS."
 msgstr "將現有的基於串流的連線升級到 TLS。"
 
-#: ../../library/asyncio-stream.rst:390
+#: ../../library/asyncio-stream.rst:391
 msgid "Parameters:"
 msgstr "參數："
 
-#: ../../library/asyncio-stream.rst:392
+#: ../../library/asyncio-stream.rst:393
 msgid "*sslcontext*: a configured instance of :class:`~ssl.SSLContext`."
 msgstr "*sslcontext*：一個 :class:`~ssl.SSLContext` 的已配置實例。"
 
-#: ../../library/asyncio-stream.rst:394
+#: ../../library/asyncio-stream.rst:395
 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:397
+#: ../../library/asyncio-stream.rst:398
 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:401
+#: ../../library/asyncio-stream.rst:402
 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:413
+#: ../../library/asyncio-stream.rst:414
 msgid ""
 "Return ``True`` if the stream is closed or in the process of being closed."
 msgstr "如果串流已被關閉或正在被關閉則回傳 ``True``。"
 
-#: ../../library/asyncio-stream.rst:421
+#: ../../library/asyncio-stream.rst:422
 msgid "Wait until the stream is closed."
 msgstr "等待直到串流被關閉。"
 
-#: ../../library/asyncio-stream.rst:423
+#: ../../library/asyncio-stream.rst:424
 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 "
@@ -559,19 +559,19 @@ msgstr ""
 "應當在 :meth:`close` 之後才被呼叫，這會持續等待直到底層的連線被關閉，以確保在"
 "這之前（例如在程式退出前）所有資料都已經被清空"
 
-#: ../../library/asyncio-stream.rst:431
+#: ../../library/asyncio-stream.rst:432
 msgid "Examples"
 msgstr "範例"
 
-#: ../../library/asyncio-stream.rst:436
+#: ../../library/asyncio-stream.rst:437
 msgid "TCP echo client using streams"
 msgstr "使用串流的 TCP echo 用戶端"
 
-#: ../../library/asyncio-stream.rst:438
+#: ../../library/asyncio-stream.rst:439
 msgid "TCP echo client using the :func:`asyncio.open_connection` function::"
 msgstr "使用 :func:`asyncio.open_connection` 函式的 TCP echo 用戶端： ::"
 
-#: ../../library/asyncio-stream.rst:462
+#: ../../library/asyncio-stream.rst:463
 msgid ""
 "The :ref:`TCP echo client protocol "
 "<asyncio_example_tcp_echo_client_protocol>` example uses the low-level :meth:"
@@ -580,15 +580,15 @@ msgstr ""
 "使用低階 :meth:`loop.create_connection` 方法的 :ref:`TCP echo 用戶端協定 "
 "<asyncio_example_tcp_echo_client_protocol>`\\ 範例。"
 
-#: ../../library/asyncio-stream.rst:469
+#: ../../library/asyncio-stream.rst:470
 msgid "TCP echo server using streams"
 msgstr "使用串流的 TCP echo 伺服器"
 
-#: ../../library/asyncio-stream.rst:471
+#: ../../library/asyncio-stream.rst:472
 msgid "TCP echo server using the :func:`asyncio.start_server` function::"
 msgstr "TCP echo 伺服器使用 :func:`asyncio.start_server` 函式： ::"
 
-#: ../../library/asyncio-stream.rst:473
+#: ../../library/asyncio-stream.rst:474
 msgid ""
 "import asyncio\n"
 "\n"
@@ -648,7 +648,7 @@ msgstr ""
 "\n"
 "asyncio.run(main())"
 
-#: ../../library/asyncio-stream.rst:505
+#: ../../library/asyncio-stream.rst:506
 msgid ""
 "The :ref:`TCP echo server protocol "
 "<asyncio_example_tcp_echo_server_protocol>` example uses the :meth:`loop."
@@ -657,16 +657,16 @@ msgstr ""
 "使用 :meth:`loop.create_server` 方法的 :ref:`TCP echo 伺服器協定 "
 "<asyncio_example_tcp_echo_server_protocol>` 範例。"
 
-#: ../../library/asyncio-stream.rst:510
+#: ../../library/asyncio-stream.rst:511
 msgid "Get HTTP headers"
 msgstr "取得 HTTP 標頭"
 
-#: ../../library/asyncio-stream.rst:512
+#: ../../library/asyncio-stream.rst:513
 msgid ""
 "Simple example querying HTTP headers of the URL passed on the command line::"
 msgstr "查詢自命令列傳入之 URL 所帶有 HTTP 標頭的簡單範例： ::"
 
-#: ../../library/asyncio-stream.rst:514
+#: ../../library/asyncio-stream.rst:515
 msgid ""
 "import asyncio\n"
 "import urllib.parse\n"
@@ -705,34 +705,34 @@ msgid ""
 "asyncio.run(print_http_headers(url))"
 msgstr ""
 
-#: ../../library/asyncio-stream.rst:551
+#: ../../library/asyncio-stream.rst:552
 msgid "Usage::"
 msgstr "用法： ::"
 
-#: ../../library/asyncio-stream.rst:553
+#: ../../library/asyncio-stream.rst:554
 msgid "python example.py http://example.com/path/page.html"
 msgstr "python example.py http://example.com/path/page.html"
 
-#: ../../library/asyncio-stream.rst:555
+#: ../../library/asyncio-stream.rst:556
 msgid "or with HTTPS::"
 msgstr "或使用 HTTPS： ::"
 
-#: ../../library/asyncio-stream.rst:557
+#: ../../library/asyncio-stream.rst:558
 msgid "python example.py https://example.com/path/page.html"
 msgstr "python example.py https://example.com/path/page.html"
 
-#: ../../library/asyncio-stream.rst:563
+#: ../../library/asyncio-stream.rst:564
 msgid "Register an open socket to wait for data using streams"
 msgstr "註冊一個使用串流來等待資料的開放 socket"
 
-#: ../../library/asyncio-stream.rst:565
+#: ../../library/asyncio-stream.rst:566
 msgid ""
 "Coroutine waiting until a socket receives data using the :func:"
 "`open_connection` function::"
 msgstr ""
 "等待直到 socket 透過使用 :func:`open_connection` 函式接收到資料的協程： ::"
 
-#: ../../library/asyncio-stream.rst:568
+#: ../../library/asyncio-stream.rst:569
 msgid ""
 "import asyncio\n"
 "import socket\n"
@@ -765,7 +765,7 @@ msgid ""
 "asyncio.run(wait_for_data())"
 msgstr ""
 
-#: ../../library/asyncio-stream.rst:600
+#: ../../library/asyncio-stream.rst:601
 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 "
@@ -775,7 +775,7 @@ msgstr ""
 "<asyncio_example_create_connection>`\\ 範例中，有使用了低階協定以及 :meth:"
 "`loop.create_connection` 方法。"
 
-#: ../../library/asyncio-stream.rst:604
+#: ../../library/asyncio-stream.rst:605
 msgid ""
 "The :ref:`watch a file descriptor for read events "
 "<asyncio_example_watch_fd>` example uses the low-level :meth:`loop."

library/compression.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-09-08 15:25+0800\n"
+"POT-Creation-Date: 2025-10-05 00:16+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <[email protected]>\n"
@@ -20,7 +20,7 @@ msgstr ""
 msgid "The :mod:`!compression` package"
 msgstr ":mod:`!compression` 套件"
 
-#: ../../library/compression.rst:6
+#: ../../library/compression.rst:8
 msgid ""
 "The :mod:`!compression` package contains the canonical compression modules "
 "containing interfaces to several different compression algorithms. Some of "
@@ -30,23 +30,23 @@ msgid ""
 "modules in :mod:`!compression` is encouraged where practical."
 msgstr ""
 
-#: ../../library/compression.rst:13
+#: ../../library/compression.rst:15
 msgid ":mod:`!compression.bz2` -- Re-exports :mod:`bz2`"
 msgstr ""
 
-#: ../../library/compression.rst:14
+#: ../../library/compression.rst:16
 msgid ":mod:`!compression.gzip` -- Re-exports :mod:`gzip`"
 msgstr ""
 
-#: ../../library/compression.rst:15
+#: ../../library/compression.rst:17
 msgid ":mod:`!compression.lzma` -- Re-exports :mod:`lzma`"
 msgstr ""
 
-#: ../../library/compression.rst:16
+#: ../../library/compression.rst:18
 msgid ":mod:`!compression.zlib` -- Re-exports :mod:`zlib`"
 msgstr ""
 
-#: ../../library/compression.rst:17
+#: ../../library/compression.rst:19
 msgid ""
 ":mod:`compression.zstd` -- Wrapper for the Zstandard compression library"
 msgstr ""