sync with cpython 5df76528

Author: github-actions[bot]

library/pkgutil.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: 2026-04-08 00:24+0000\n"
 "PO-Revision-Date: 2024-03-08 16:07+0000\n"
 "Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -41,8 +41,8 @@ msgid ""
 "Extend the search path for the modules which comprise a package.  Intended "
 "use is to place the following code in a package's :file:`__init__.py`::"
 msgstr ""
-"擴充組成一個套件之模組的搜尋路徑。預期用法是將以下程式碼放入套件"
-"的 :file:`__init__.py`： ::"
+"擴充組成一個套件之模組的搜尋路徑。預期用法是將以下程式碼放入套件的 :file:"
+"`__init__.py`： ::"
 
 #: ../../library/pkgutil.rst:25
 msgid ""
@@ -55,10 +55,9 @@ msgstr ""
 #: ../../library/pkgutil.rst:28
 msgid ""
 "For each directory on :data:`sys.path` that has a subdirectory that matches "
-"the package name, add the subdirectory to the "
-"package's :attr:`~module.__path__`. This is useful if one wants to "
-"distribute different parts of a single logical package as multiple "
-"directories."
+"the package name, add the subdirectory to the package's :attr:`~module."
+"__path__`. This is useful if one wants to distribute different parts of a "
+"single logical package as multiple directories."
 msgstr ""
 "對於 :data:`sys.path` 上具有與套件名稱相符的子目錄的每個目錄，將該子目錄新增"
 "至套件的 :attr:`~module.__path__` 中。如果想要將單一邏輯套件的不同部分給分配"
@@ -67,12 +66,12 @@ msgstr ""
 #: ../../library/pkgutil.rst:34
 msgid ""
 "It also looks for :file:`\\*.pkg` files beginning where ``*`` matches the "
-"*name* argument.  This feature is similar to :file:`\\*.pth` files (see "
-"the :mod:`site` module for more information), except that it doesn't special-"
-"case lines starting with ``import``.  A :file:`\\*.pkg` file is trusted at "
-"face value: apart from skipping blank lines and ignoring comments, all "
-"entries found in a :file:`\\*.pkg` file are added to the path, regardless of "
-"whether they exist on the filesystem (this is a feature)."
+"*name* argument.  This feature is similar to :file:`\\*.pth` files (see the :"
+"mod:`site` module for more information), except that it doesn't special-case "
+"lines starting with ``import``.  A :file:`\\*.pkg` file is trusted at face "
+"value: apart from skipping blank lines and ignoring comments, all entries "
+"found in a :file:`\\*.pkg` file are added to the path, regardless of whether "
+"they exist on the filesystem (this is a feature)."
 msgstr ""
 "它還會尋找 :file:`\\*.pkg` 檔案，其中開頭的 ``*`` 與 *name* 引數相符。此功能"
 "類似於 :file:`\\*.pth` 檔案（更多資訊請參閱 :mod:`site` 模組），但他不特別處"
@@ -91,11 +90,11 @@ msgstr ""
 
 #: ../../library/pkgutil.rst:46
 msgid ""
-"It is assumed that :data:`sys.path` is a sequence.  Items "
-"of :data:`sys.path` that are not strings referring to existing directories "
-"are ignored. Unicode items on :data:`sys.path` that cause errors when used "
-"as filenames may cause this function to raise an exception (in line "
-"with :func:`os.path.isdir` behavior)."
+"It is assumed that :data:`sys.path` is a sequence.  Items of :data:`sys."
+"path` that are not strings referring to existing directories are ignored. "
+"Unicode items on :data:`sys.path` that cause errors when used as filenames "
+"may cause this function to raise an exception (in line with :func:`os.path."
+"isdir` behavior)."
 msgstr ""
 ":data:`sys.path` 被假設是一個序列，:data:`sys.path` 中的項目裡，若不是代表現"
 "存目錄的字串則將被忽略。:data:`sys.path` 上用作檔案名稱時導致錯誤的 Unicode "
@@ -115,8 +114,8 @@ msgstr ""
 
 #: ../../library/pkgutil.rst:60
 msgid ""
-"The cache (or part of it) can be cleared manually if a rescan "
-"of :data:`sys.path_hooks` is necessary."
+"The cache (or part of it) can be cleared manually if a rescan of :data:`sys."
+"path_hooks` is necessary."
 msgstr ""
 "如果需要重新掃描 :data:`sys.path_hooks`，可以手動清除快取（或部分快取）。"
 
@@ -137,12 +136,12 @@ msgstr "yield 給定模組名稱的 :term:`finder` 物件。"
 msgid ""
 "If *fullname* contains a ``'.'``, the finders will be for the package "
 "containing *fullname*, otherwise they will be all registered top level "
-"finders (i.e. those on both :data:`sys.meta_path` "
-"and :data:`sys.path_hooks`)."
+"finders (i.e. those on both :data:`sys.meta_path` and :data:`sys."
+"path_hooks`)."
 msgstr ""
 "如果 *fullname* 包含 ``'.'``，則尋檢器將針對包含 *fullname* 的套件，否則它們"
-"全部會是在頂層被註冊的尋檢器（即 :data:`sys.meta_path` "
-"和 :data:`sys.path_hooks` 上的尋檢器）。"
+"全部會是在頂層被註冊的尋檢器（即 :data:`sys.meta_path` 和 :data:`sys."
+"path_hooks` 上的尋檢器）。"
 
 #: ../../library/pkgutil.rst:76
 msgid ""
@@ -178,12 +177,12 @@ msgstr "*prefix* 是在輸出的每個模組名稱前面的輸出字串。"
 msgid ""
 "Only works for a :term:`finder` which defines an ``iter_modules()`` method. "
 "This interface is non-standard, so the module also provides implementations "
-"for :class:`importlib.machinery.FileFinder` "
-"and :class:`zipimport.zipimporter`."
+"for :class:`importlib.machinery.FileFinder` and :class:`zipimport."
+"zipimporter`."
 msgstr ""
 "僅適用於有定義 ``iter_modules()`` 方法的 :term:`finder`。此介面並非是標準的，"
-"因此該模組還提供了 :class:`importlib.machinery.FileFinder` "
-"和 :class:`zipimport.zipimporter` 的實作。"
+"因此該模組還提供了 :class:`importlib.machinery.FileFinder` 和 :class:"
+"`zipimport.zipimporter` 的實作。"
 
 #: ../../library/pkgutil.rst:109
 msgid ""
@@ -206,13 +205,13 @@ msgstr ""
 msgid ""
 "*onerror* is a function which gets called with one argument (the name of the "
 "package which was being imported) if any exception occurs while trying to "
-"import a package.  If no *onerror* function is "
-"supplied, :exc:`ImportError`\\s are caught and ignored, while all other "
-"exceptions are propagated, terminating the search."
+"import a package.  If no *onerror* function is supplied, :exc:"
+"`ImportError`\\s are caught and ignored, while all other exceptions are "
+"propagated, terminating the search."
 msgstr ""
 "*onerror* 是一個函式，如果在嘗試引入套件時發生任何例外，則使用一個引數（正在"
-"引入之套件的名稱）來呼叫函式。如果未提供 *onerror* 函式，則會捕獲並忽"
-"略 :exc:`ImportError`，同時傳播所有其他例外並終止搜尋。"
+"引入之套件的名稱）來呼叫函式。如果未提供 *onerror* 函式，則會捕獲並忽略 :exc:"
+"`ImportError`，同時傳播所有其他例外並終止搜尋。"
 
 #: ../../library/pkgutil.rst:126
 msgid "Examples::"
@@ -237,67 +236,102 @@ msgid "Get a resource from a package."
 msgstr "從套件中取得資源。"
 
 #: ../../library/pkgutil.rst:150
+#, fuzzy
 msgid ""
-"This is a wrapper for the :term:`loader` :meth:`get_data "
-"<importlib.abc.ResourceLoader.get_data>` API.  The *package* argument should "
-"be the name of a package, in standard module format (``foo.bar``).  The "
-"*resource* argument should be in the form of a relative filename, using ``/"
-"`` as the path separator.  The parent directory name ``..`` is not allowed, "
-"and nor is a rooted name (starting with a ``/``)."
+"This is a wrapper for the :term:`loader` :meth:`get_data <importlib.abc."
+"ResourceLoader.get_data>` API.  The *package* argument should be the name of "
+"a package, in standard module format (``foo.bar``).  The *resource* argument "
+"should be in the form of a relative filename, using ``/`` as the path "
+"separator."
 msgstr ""
 "這是 :term:`loader` :meth:`get_data <importlib.abc.ResourceLoader.get_data>` "
 "API 的包裝器。*package* 引數應該是採用標準模組格式 (``foo.bar``) 的套件名稱。"
 "*resource* 引數應為相對檔案名稱的形式，並使用 ``/`` 作為路徑分隔符號。不允許"
 "使用父目錄名稱 ``..``，也不允許使用根目錄名稱（以 ``/`` 開頭）。"
 
-#: ../../library/pkgutil.rst:157
+#: ../../library/pkgutil.rst:156
 msgid ""
 "The function returns a binary string that is the contents of the specified "
 "resource."
 msgstr "該函式回傳一個二進位字串，它是指定資源的內容。"
 
-#: ../../library/pkgutil.rst:160
+#: ../../library/pkgutil.rst:159
+msgid ""
+"This function uses the :term:`loader` method :func:`~importlib.abc."
+"FileLoader.get_data` to support modules installed in the filesystem, but "
+"also in zip files, databases, or elsewhere."
+msgstr ""
+
+#: ../../library/pkgutil.rst:164
 msgid ""
 "For packages located in the filesystem, which have already been imported, "
 "this is the rough equivalent of::"
 msgstr "對於位於檔案系統中且已被引入過的套件，這大致相當於： ::"
 
-#: ../../library/pkgutil.rst:163
+#: ../../library/pkgutil.rst:167
 msgid ""
 "d = os.path.dirname(sys.modules[package].__file__)\n"
 "data = open(os.path.join(d, resource), 'rb').read()"
 msgstr ""
 "d = os.path.dirname(sys.modules[package].__file__)\n"
 "data = open(os.path.join(d, resource), 'rb').read()"
 
-#: ../../library/pkgutil.rst:166
+#: ../../library/pkgutil.rst:170
+msgid ""
+"Like the :func:`open` function, :func:`!get_data` can follow parent "
+"directories (``../``) and absolute paths (starting with ``/`` or ``C:/``, "
+"for example). It can open compilation/installation artifacts like ``.py`` "
+"and ``.pyc`` files or files with :func:`reserved filenames <os.path."
+"isreserved>`. To be compatible with non-filesystem loaders, avoid using "
+"these features."
+msgstr ""
+
+#: ../../library/pkgutil.rst:179
+msgid ""
+"This function is intended for trusted input. It does not verify that "
+"*resource* \"belongs\" to *package*."
+msgstr ""
+
+#: ../../library/pkgutil.rst:182
+msgid ""
+"If you use a user-provided *resource* path, consider verifying it. For "
+"example, require an alphanumeric filename with a known extension, or install "
+"and check a list of known resources."
+msgstr ""
+
+#: ../../library/pkgutil.rst:186
 msgid ""
 "If the package cannot be located or loaded, or it uses a :term:`loader` "
-"which does not support :meth:`get_data "
-"<importlib.abc.ResourceLoader.get_data>`, then ``None`` is returned.  In "
-"particular, the :term:`loader` for :term:`namespace packages <namespace "
-"package>` does not support :meth:`get_data "
-"<importlib.abc.ResourceLoader.get_data>`."
+"which does not support :meth:`get_data <importlib.abc.ResourceLoader."
+"get_data>`, then ``None`` is returned.  In particular, the :term:`loader` "
+"for :term:`namespace packages <namespace package>` does not support :meth:"
+"`get_data <importlib.abc.ResourceLoader.get_data>`."
 msgstr ""
-"如果無法定位或載入套件，或者它使用不支援 :meth:`get_data "
-"<importlib.abc.ResourceLoader.get_data>` 的 :term:`loader` 則回傳 ``None``。"
-"特別是\\ :term:`命名空間套件 <namespace package>`\\ 的 :term:`loader` 不支"
-"援 :meth:`get_data <importlib.abc.ResourceLoader.get_data>`。"
+"如果無法定位或載入套件，或者它使用不支援 :meth:`get_data <importlib.abc."
+"ResourceLoader.get_data>` 的 :term:`loader` 則回傳 ``None``。特別是\\ :term:`"
+"命名空間套件 <namespace package>`\\ 的 :term:`loader` 不支援 :meth:`get_data "
+"<importlib.abc.ResourceLoader.get_data>`。"
 
-#: ../../library/pkgutil.rst:175
+#: ../../library/pkgutil.rst:194
+msgid ""
+"The :mod:`importlib.resources` module provides structured access to module "
+"resources."
+msgstr ""
+
+#: ../../library/pkgutil.rst:199
 msgid "Resolve a name to an object."
 msgstr "將名稱解析為物件。"
 
-#: ../../library/pkgutil.rst:177
+#: ../../library/pkgutil.rst:201
 msgid ""
-"This functionality is used in numerous places in the standard library "
-"(see :issue:`12915`) - and equivalent functionality is also in widely used "
-"third-party packages such as setuptools, Django and Pyramid."
+"This functionality is used in numerous places in the standard library (see :"
+"issue:`12915`) - and equivalent functionality is also in widely used third-"
+"party packages such as setuptools, Django and Pyramid."
 msgstr ""
 "標準函式庫中的許多地方都使用了此功能（請參閱 :issue:`12915`），且相同功能也被"
 "用於擁有廣大使用者的第三方套件，如 setuptools、Django 和 Pyramid。"
 
-#: ../../library/pkgutil.rst:181
+#: ../../library/pkgutil.rst:205
 msgid ""
 "It is expected that *name* will be a string in one of the following formats, "
 "where W is shorthand for a valid Python identifier and dot stands for a "
@@ -306,15 +340,15 @@ msgstr ""
 "*name* 預期要是以下格式之一的字串，其中 W 是有效 Python 識別字的簡寫，而點 "
 "(dot) 代表這些偽正規表示式 (pseudo-regex) 中的字面句點 (literal period)："
 
-#: ../../library/pkgutil.rst:185
+#: ../../library/pkgutil.rst:209
 msgid "``W(.W)*``"
 msgstr "``W(.W)*``"
 
-#: ../../library/pkgutil.rst:186
+#: ../../library/pkgutil.rst:210
 msgid "``W(.W)*:(W(.W)*)?``"
 msgstr "``W(.W)*:(W(.W)*)?``"
 
-#: ../../library/pkgutil.rst:188
+#: ../../library/pkgutil.rst:212
 msgid ""
 "The first form is intended for backward compatibility only. It assumes that "
 "some part of the dotted name is a package, and the rest is an object "
@@ -328,7 +362,7 @@ msgstr ""
 "於無法透過檢查 (inspection) 來推斷出套件停止的位置和物件層次結構的開始位置，"
 "因此必須使用此形式來重複嘗試引入。"
 
-#: ../../library/pkgutil.rst:195
+#: ../../library/pkgutil.rst:219
 msgid ""
 "In the second form, the caller makes the division point clear through the "
 "provision of a single colon: the dotted name to the left of the colon is a "
@@ -340,21 +374,21 @@ msgstr ""
 "引入的套件，右側的點名稱是該套件內的物件層次結構。這種形式只需要一次引入。如"
 "果它以冒號結尾，則回傳一個模組物件。"
 
-#: ../../library/pkgutil.rst:201
+#: ../../library/pkgutil.rst:225
 msgid ""
 "The function will return an object (which might be a module), or raise one "
 "of the following exceptions:"
 msgstr "此函式會回傳一個物件（可能是一個模組），或引發以下其中一個例外："
 
-#: ../../library/pkgutil.rst:204
+#: ../../library/pkgutil.rst:228
 msgid ":exc:`ValueError` -- if *name* isn't in a recognised format."
 msgstr ":exc:`ValueError` -- 如果 *name* 不是可辨識的格式。"
 
-#: ../../library/pkgutil.rst:206
+#: ../../library/pkgutil.rst:230
 msgid ":exc:`ImportError` -- if an import failed when it shouldn't have."
 msgstr ":exc:`ImportError` -- 如果在不應該失敗的情況下引入失敗。"
 
-#: ../../library/pkgutil.rst:208
+#: ../../library/pkgutil.rst:232
 msgid ""
 ":exc:`AttributeError` -- If a failure occurred when traversing the object "
 "hierarchy within the imported package to get to the desired object."