Sync with CPython 3.12 (#895)

Author: pydoc-zh-tw[bot]

.scripts/poetry.lock

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-05-09 00:03+0000\n"
+"POT-Creation-Date: 2024-05-14 00:03+0000\n"
 "PO-Revision-Date: 2018-05-23 16:02+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -551,20 +551,20 @@ msgid ""
 "corresponding attributes from the original function. The default values for "
 "these arguments are the module level constants ``WRAPPER_ASSIGNMENTS`` "
 "(which assigns to the wrapper function's ``__module__``, ``__name__``, "
-"``__qualname__``, ``__annotations__`` and ``__doc__``, the documentation "
-"string) and ``WRAPPER_UPDATES`` (which updates the wrapper function's "
-"``__dict__``, i.e. the instance dictionary)."
+"``__qualname__``, ``__annotations__``, ``__type_params__``, and ``__doc__``, "
+"the documentation string) and ``WRAPPER_UPDATES`` (which updates the wrapper "
+"function's ``__dict__``, i.e. the instance dictionary)."
 msgstr ""
 
-#: ../../library/functools.rst:651
+#: ../../library/functools.rst:652
 msgid ""
 "To allow access to the original function for introspection and other "
 "purposes (e.g. bypassing a caching decorator such as :func:`lru_cache`), "
 "this function automatically adds a ``__wrapped__`` attribute to the wrapper "
 "that refers to the function being wrapped."
 msgstr ""
 
-#: ../../library/functools.rst:656
+#: ../../library/functools.rst:657
 msgid ""
 "The main intended use for this function is in :term:`decorator` functions "
 "which wrap the decorated function and return the wrapper. If the wrapper "
@@ -573,7 +573,7 @@ msgid ""
 "is typically less than helpful."
 msgstr ""
 
-#: ../../library/functools.rst:662
+#: ../../library/functools.rst:663
 msgid ""
 ":func:`update_wrapper` may be used with callables other than functions. Any "
 "attributes named in *assigned* or *updated* that are missing from the object "
@@ -582,64 +582,68 @@ msgid ""
 "wrapper function itself is missing any attributes named in *updated*."
 msgstr ""
 
-#: ../../library/functools.rst:668
+#: ../../library/functools.rst:669
 msgid ""
 "The ``__wrapped__`` attribute is now automatically added. The "
 "``__annotations__`` attribute is now copied by default. Missing attributes "
 "no longer trigger an :exc:`AttributeError`."
 msgstr ""
 
-#: ../../library/functools.rst:673
+#: ../../library/functools.rst:674
 msgid ""
 "The ``__wrapped__`` attribute now always refers to the wrapped function, "
 "even if that function defined a ``__wrapped__`` attribute. (see :issue:"
 "`17482`)"
 msgstr ""
 
-#: ../../library/functools.rst:681
+#: ../../library/functools.rst:679
+msgid "The ``__type_params__`` attribute is now copied by default."
+msgstr ""
+
+#: ../../library/functools.rst:685
 msgid ""
 "This is a convenience function for invoking :func:`update_wrapper` as a "
 "function decorator when defining a wrapper function.  It is equivalent to "
 "``partial(update_wrapper, wrapped=wrapped, assigned=assigned, "
 "updated=updated)``. For example::"
 msgstr ""
 
-#: ../../library/functools.rst:707
+#: ../../library/functools.rst:711
 msgid ""
 "Without the use of this decorator factory, the name of the example function "
 "would have been ``'wrapper'``, and the docstring of the original :func:"
 "`example` would have been lost."
 msgstr ""
 
-#: ../../library/functools.rst:715
+#: ../../library/functools.rst:719
 msgid ":class:`partial` Objects"
 msgstr ":class:`partial` 物件"
 
-#: ../../library/functools.rst:717
+#: ../../library/functools.rst:721
 msgid ""
 ":class:`partial` objects are callable objects created by :func:`partial`. "
 "They have three read-only attributes:"
 msgstr ""
 
-#: ../../library/functools.rst:723
+#: ../../library/functools.rst:727
 msgid ""
 "A callable object or function.  Calls to the :class:`partial` object will be "
 "forwarded to :attr:`func` with new arguments and keywords."
 msgstr ""
 
-#: ../../library/functools.rst:729
+#: ../../library/functools.rst:733
 msgid ""
 "The leftmost positional arguments that will be prepended to the positional "
 "arguments provided to a :class:`partial` object call."
 msgstr ""
 
-#: ../../library/functools.rst:735
+#: ../../library/functools.rst:739
 msgid ""
 "The keyword arguments that will be supplied when the :class:`partial` object "
 "is called."
 msgstr ""
 
-#: ../../library/functools.rst:738
+#: ../../library/functools.rst:742
 msgid ""
 ":class:`partial` objects are like :class:`function` objects in that they are "
 "callable, weak referenceable, and can have attributes.  There are some "

library/dataclasses.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-05-09 00:03+0000\n"
+"POT-Creation-Date: 2024-05-23 00:03+0000\n"
 "PO-Revision-Date: 2018-05-23 16:03+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -351,8 +351,9 @@ msgstr ""
 
 #: ../../library/hashlib.rst:331
 msgid ""
-"*dklen* is the length of the derived key. If *dklen* is ``None`` then the "
-"digest size of the hash algorithm *hash_name* is used, e.g. 64 for SHA-512."
+"*dklen* is the length of the derived key in bytes. If *dklen* is ``None`` "
+"then the digest size of the hash algorithm *hash_name* is used, e.g. 64 for "
+"SHA-512."
 msgstr ""
 
 #: ../../library/hashlib.rst:340
@@ -383,7 +384,7 @@ msgstr ""
 msgid ""
 "*n* is the CPU/Memory cost factor, *r* the block size, *p* parallelization "
 "factor and *maxmem* limits memory (OpenSSL 1.1.0 defaults to 32 MiB). "
-"*dklen* is the length of the derived key."
+"*dklen* is the length of the derived key in bytes."
 msgstr ""
 
 #: ../../library/hashlib.rst:366

library/functions.po

@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-05-09 00:03+0000\n"
+"POT-Creation-Date: 2024-05-20 00:04+0000\n"
 "PO-Revision-Date: 2023-04-24 21:28+0800\n"
 "Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -31,13 +31,13 @@ msgid ""
 "This module contains functions that can read and write Python values in a "
 "binary format.  The format is specific to Python, but independent of machine "
 "architecture issues (e.g., you can write a Python value to a file on a PC, "
-"transport the file to a Sun, and read it back there).  Details of the format "
+"transport the file to a Mac, and read it back there).  Details of the format "
 "are undocumented on purpose; it may change between Python versions (although "
 "it rarely does). [#]_"
 msgstr ""
 "此 module（模組）包含一個能以二進位制格式來讀寫 Python 值的函式。這種格式是 "
 "Python 專屬但獨立於機器架構的（例如，你可以在一臺 PC 上寫入某個 Python 值，再"
-"將檔案傳到一臺 Sun 上並在那裡讀取它）。這種格式的細節是有意地不在文件上說明"
+"將檔案傳到一臺 Mac 上並在那裡讀取它）。這種格式的細節是有意地不在文件上說明"
 "的；它可能在不同 Python 版本中被改變（雖然這種情況極少發生）。\\ [#]_"
 
 #: ../../library/marshal.rst:21

library/functools.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-05-09 00:03+0000\n"
+"POT-Creation-Date: 2024-05-11 00:03+0000\n"
 "PO-Revision-Date: 2022-11-30 13:42+0800\n"
 "Last-Translator: \n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -75,8 +75,8 @@ msgid "Return a randomly chosen element from a non-empty sequence."
 msgstr "從一非空序列中，回傳一個隨機選取的元素。"
 
 #: ../../library/secrets.rst:51
-msgid "Return a random int in the range [0, *n*)."
-msgstr "回傳一個 [0, *n*) 範圍之內的隨機整數。"
+msgid "Return a random int in the range [0, *exclusive_upper_bound*)."
+msgstr "回傳一個 [0, *exclusive_upper_bound*) 範圍之內的隨機整數。"
 
 #: ../../library/secrets.rst:55
 msgid "Return an int with *k* random bits."

library/hashlib.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-05-09 00:03+0000\n"
+"POT-Creation-Date: 2024-05-14 00:03+0000\n"
 "PO-Revision-Date: 2018-05-23 16:10+0000\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -442,8 +442,8 @@ msgid ""
 msgstr ""
 
 #: ../../library/shutil.rst:340
-msgid "The *dir_fd* parameter."
-msgstr "*dir_fd* 參數。"
+msgid "Added the *dir_fd* parameter."
+msgstr "新增 *dir_fd* 參數。"
 
 #: ../../library/shutil.rst:343
 msgid "Added the *onexc* parameter, deprecated *onerror*."

library/itertools.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-08-18 00:03+0000\n"
+"POT-Creation-Date: 2024-05-19 00:03+0000\n"
 "PO-Revision-Date: 2022-10-16 05:35+0800\n"
 "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -82,14 +82,13 @@ msgstr "建立虛擬環境"
 #: ../../tutorial/venv.rst:38
 msgid ""
 "The module used to create and manage virtual environments is called :mod:"
-"`venv`.  :mod:`venv` will usually install the most recent version of Python "
-"that you have available. If you have multiple versions of Python on your "
-"system, you can select a specific Python version by running ``python3`` or "
-"whichever version you want."
+"`venv`.  :mod:`venv` will install the Python version from which the command "
+"was run (as reported by the :option:`--version` option). For instance, "
+"excuting the command with ``python3.12`` will install version 3.12."
 msgstr ""
-"用來建立與管理虛擬環境的模組叫做 :mod:`venv`。:mod:`venv` 通常會安裝你能夠取"
-"得的最新版本的 Python。要是你的系統有不同版本的 Python，你可以透過 "
-"``python3`` 這個指令選擇特定或是任意版本的 Python。"
+"用來建立與管理虛擬環境的模組叫做 :mod:`venv`。:mod:`venv` 將安裝執行命令的 "
+"Python 版本（如 :option:`--version` 選項所報告的）。例如使用 ``python3.12`` "
+"執行命令將安裝 3.12 版本。"
 
 #: ../../tutorial/venv.rst:44
 msgid ""
@@ -98,9 +97,7 @@ msgid ""
 "path::"
 msgstr ""
 "在建立虛擬環境的時候，在你決定要放該虛擬環境的資料夾之後，以腳本 (script) 執"
-"行 :mod:`venv` 模組並且給定資料夾路徑：\n"
-"\n"
-"::"
+"行 :mod:`venv` 模組並且給定資料夾路徑： ::"
 
 #: ../../tutorial/venv.rst:49
 msgid ""
@@ -129,17 +126,11 @@ msgstr "一旦你建立了一個虛擬環境，你可以啟動它。"
 
 #: ../../tutorial/venv.rst:61
 msgid "On Windows, run::"
-msgstr ""
-"在 Windows 系統中，使用：\n"
-"\n"
-"::"
+msgstr "在 Windows 系統中，使用： ::"
 
 #: ../../tutorial/venv.rst:65
 msgid "On Unix or MacOS, run::"
-msgstr ""
-"在 Unix 或 MacOS 系統，使用：\n"
-"\n"
-"::"
+msgstr "在 Unix 或 MacOS 系統，使用： ::"
 
 #: ../../tutorial/venv.rst:69
 msgid ""
@@ -162,10 +153,7 @@ msgstr ""
 
 #: ../../tutorial/venv.rst:91
 msgid "To deactivate a virtual environment, type::"
-msgstr ""
-"要停用虛擬環境，輸入：\n"
-"\n"
-"::"
+msgstr "要停用虛擬環境，輸入： ::"
 
 #: ../../tutorial/venv.rst:95
 msgid "into the terminal."
@@ -192,7 +180,7 @@ msgid ""
 "etc.  (Consult the :ref:`installing-index` guide for complete documentation "
 "for ``pip``.)"
 msgstr ""
-"``pip`` 有好幾個子指令：\"install\"、\"uninstall\"、\"freeze\" 等等。（可以參"
+"``pip`` 有好幾個子命令：\"install\"、\"uninstall\"、\"freeze\" 等等。（可以參"
 "考\\ :ref:`installing-index`\\ 指南，來取得 ``pip`` 的完整說明文件。）"
 
 #: ../../tutorial/venv.rst:109
@@ -214,7 +202,7 @@ msgid ""
 "number to get that version, or you can run ``python -m pip install --"
 "upgrade`` to upgrade the package to the latest version:"
 msgstr ""
-"要是你重新執行此指令，``pip`` 會知道該版本已經安裝過，然後什麼也不做。你可以"
+"要是你重新執行此命令，``pip`` 會知道該版本已經安裝過，然後什麼也不做。你可以"
 "提供不同的版本號碼來取得該版本，或是可以執行 ``python -m pip install --"
 "upgrade`` 來把套件升級到最新的版本："