Deploy preview for PR 1214 🛫

Author: pydoc-zh-tw[bot]

pr-preview/pr-1214/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file records the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: d6751eade72bed0b8f7a3e9e8373c012
+config: 429e5f11a7c447b979c1ef472ceffa09
 tags: b5e2c454ba7771976391ed0cecdde553

pr-preview/pr-1214/_sources/library/pkgutil.rst.txt

@@ -151,24 +151,48 @@ support.
    :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 ``/``).
+   filename, using ``/`` as the path separator.
 
    The function returns a binary string that is the contents of the specified
    resource.
 
+   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.
+
    For packages located in the filesystem, which have already been imported,
    this is the rough equivalent of::
 
       d = os.path.dirname(sys.modules[package].__file__)
       data = open(os.path.join(d, resource), 'rb').read()
 
+   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.
+
+   .. warning::
+
+      This function is intended for trusted input.
+      It does not verify that *resource* "belongs" to *package*.
+
+   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.
+
    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>`.
 
+   .. seealso::
+
+      The :mod:`importlib.resources` module provides structured access to
+      module resources.
 
 .. function:: resolve_name(name)
 

pr-preview/pr-1214/_static/documentation_options.js

@@ -1,5 +1,5 @@
 const DOCUMENTATION_OPTIONS = {
-    VERSION: '3.14.3',
+    VERSION: '3.14.4',
     LANGUAGE: 'zh-TW',
     COLLAPSE_INDEX: false,
     BUILDER: 'html',

pr-preview/pr-1214/_static/opensearch.xml

@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
   <ShortName>Python</ShortName>
-  <Description>搜尋 Python 3.14.3 說明文件</Description>
+  <Description>搜尋 Python 3.14.4 說明文件</Description>
   <InputEncoding>utf-8</InputEncoding>
   <Url type="text/html" method="get"
        template="https://docs.python.org/3.14/search.html?q={searchTerms}"/>
-  <LongName>Python 3.14.3 說明文件</LongName>
+  <LongName>Python 3.14.4 說明文件</LongName>
 <Image height="16" width="16" type="image/x-icon">https://www.python.org/images/favicon16x16.ico</Image>
 </OpenSearchDescription>

pr-preview/pr-1214/about.html

@@ -5,22 +5,22 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <title>關於這份說明文件 &#8212; Python 3.14.3 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>關於這份說明文件 &#8212; Python 3.14.4 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
 
     <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=b86133f3" />
     <link rel="stylesheet" type="text/css" href="_static/classic.css?v=234b1a7c" />
     <link rel="stylesheet" type="text/css" href="_static/pydoctheme.css?v=82640b3f" />
     <link id="pygments_dark_css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css" href="_static/pygments_dark.css?v=5349f25f" />
 
-    <script src="_static/documentation_options.js?v=e2c088d7"></script>
+    <script src="_static/documentation_options.js?v=9e923c91"></script>
     <script src="_static/doctools.js?v=9bcbadda"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/translations.js?v=cbf116e0"></script>
 
     <script src="_static/sidebar.js"></script>
 
     <link rel="search" type="application/opensearchdescription+xml"
-          title="在 Python 3.14.3 說明文件 中搜尋"
+          title="在 Python 3.14.4 說明文件 中搜尋"
           href="_static/opensearch.xml"/>
     <link rel="author" title="關於這些文件" href="#" />
     <link rel="index" title="索引" href="genindex.html" />
@@ -169,7 +169,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="index.html">3.14.3 Documentation</a> &#187;
+      <a href="index.html">3.14.4 Documentation</a> &#187;
     </li>
 
         <li class="nav-item nav-item-this"><a href="">關於這份說明文件</a></li>
@@ -312,7 +312,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="index.html">3.14.3 Documentation</a> &#187;
+      <a href="index.html">3.14.4 Documentation</a> &#187;
     </li>
 
         <li class="nav-item nav-item-this"><a href="">關於這份說明文件</a></li>
@@ -356,7 +356,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 4月 07, 2026 (00:29 UTC)。
+      最後更新於 4月 08, 2026 (00:30 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1214/bugs.html

@@ -5,22 +5,22 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <title>處理錯誤 (Bug) &#8212; Python 3.14.3 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>處理錯誤 (Bug) &#8212; Python 3.14.4 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
 
     <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=b86133f3" />
     <link rel="stylesheet" type="text/css" href="_static/classic.css?v=234b1a7c" />
     <link rel="stylesheet" type="text/css" href="_static/pydoctheme.css?v=82640b3f" />
     <link id="pygments_dark_css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css" href="_static/pygments_dark.css?v=5349f25f" />
 
-    <script src="_static/documentation_options.js?v=e2c088d7"></script>
+    <script src="_static/documentation_options.js?v=9e923c91"></script>
     <script src="_static/doctools.js?v=9bcbadda"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/translations.js?v=cbf116e0"></script>
 
     <script src="_static/sidebar.js"></script>
 
     <link rel="search" type="application/opensearchdescription+xml"
-          title="在 Python 3.14.3 說明文件 中搜尋"
+          title="在 Python 3.14.4 說明文件 中搜尋"
           href="_static/opensearch.xml"/>
     <link rel="author" title="關於這些文件" href="about.html" />
     <link rel="index" title="索引" href="genindex.html" />
@@ -171,7 +171,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="index.html">3.14.3 Documentation</a> &#187;
+      <a href="index.html">3.14.4 Documentation</a> &#187;
     </li>
 
         <li class="nav-item nav-item-this"><a href="">處理錯誤 (Bug)</a></li>
@@ -250,7 +250,7 @@ <h2>說明文件的錯誤<a class="headerlink" href="#documentation-bugs" title=
 </section>
 <section id="getting-started-contributing-to-python-yourself">
 <span id="contributing-to-python"></span><h2>開始讓自己貢獻 Python<a class="headerlink" href="#getting-started-contributing-to-python-yourself" title="連結到這個標頭">¶</a></h2>
-<p>除了只是回報你所發現的錯誤之外，同樣也歡迎你提交修正它們的修補程式 (patch)。你可以在 <a class="reference external" href="https://mail.python.org/mailman3/lists/core-mentorship.python.org/">Python 開發者指南</a>中找到如何開始修補 Python 的更多資訊。如果你有任何問題，<a class="reference external" href="https://devguide.python.org/">核心導師郵寄清單</a>是一個友善的地方，你可以在那裡得到，關於 Python 修正錯誤的過程中，所有問題的答案。</p>
+<p>除了只是回報你所發現的錯誤之外，同樣也歡迎你提交修正它們的修補程式 (patch)。你可以在 <a class="reference external" href="https://devguide.python.org/">Python 開發者指南</a>中找到如何開始修補 Python 的更多資訊。如果你有任何問題，<a class="reference external" href="https://mail.python.org/mailman3/lists/core-mentorship.python.org/">核心導師郵寄清單</a>是一個友善的地方，你可以在那裡得到，關於 Python 修正錯誤的過程中，所有問題的答案。</p>
 </section>
 </section>
 
@@ -349,7 +349,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="index.html">3.14.3 Documentation</a> &#187;
+      <a href="index.html">3.14.4 Documentation</a> &#187;
     </li>
 
         <li class="nav-item nav-item-this"><a href="">處理錯誤 (Bug)</a></li>
@@ -393,7 +393,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 4月 07, 2026 (00:29 UTC)。
+      最後更新於 4月 08, 2026 (00:30 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1214/c-api/abstract.html

@@ -5,22 +5,22 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <title>抽象物件層 (Abstract Objects Layer) &#8212; Python 3.14.3 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>抽象物件層 (Abstract Objects Layer) &#8212; Python 3.14.4 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
 
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=b86133f3" />
     <link rel="stylesheet" type="text/css" href="../_static/classic.css?v=234b1a7c" />
     <link rel="stylesheet" type="text/css" href="../_static/pydoctheme.css?v=82640b3f" />
     <link id="pygments_dark_css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css" href="../_static/pygments_dark.css?v=5349f25f" />
 
-    <script src="../_static/documentation_options.js?v=e2c088d7"></script>
+    <script src="../_static/documentation_options.js?v=9e923c91"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/translations.js?v=cbf116e0"></script>
 
     <script src="../_static/sidebar.js"></script>
 
     <link rel="search" type="application/opensearchdescription+xml"
-          title="在 Python 3.14.3 說明文件 中搜尋"
+          title="在 Python 3.14.4 說明文件 中搜尋"
           href="../_static/opensearch.xml"/>
     <link rel="author" title="關於這些文件" href="../about.html" />
     <link rel="index" title="索引" href="../genindex.html" />
@@ -159,7 +159,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="../index.html">3.14.3 Documentation</a> &#187;
+      <a href="../index.html">3.14.4 Documentation</a> &#187;
     </li>
 
           <li class="nav-item nav-item-1"><a href="index.html" accesskey="U">Python/C API 參考手冊</a> &#187;</li>
@@ -320,7 +320,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="../index.html">3.14.3 Documentation</a> &#187;
+      <a href="../index.html">3.14.4 Documentation</a> &#187;
     </li>
 
           <li class="nav-item nav-item-1"><a href="index.html" >Python/C API 參考手冊</a> &#187;</li>
@@ -365,7 +365,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 4月 07, 2026 (00:29 UTC)。
+      最後更新於 4月 08, 2026 (00:30 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1214/c-api/allocation.html

@@ -5,22 +5,22 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <title>在 heap 上分配物件 &#8212; Python 3.14.3 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>在 heap 上分配物件 &#8212; Python 3.14.4 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
 
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=b86133f3" />
     <link rel="stylesheet" type="text/css" href="../_static/classic.css?v=234b1a7c" />
     <link rel="stylesheet" type="text/css" href="../_static/pydoctheme.css?v=82640b3f" />
     <link id="pygments_dark_css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css" href="../_static/pygments_dark.css?v=5349f25f" />
 
-    <script src="../_static/documentation_options.js?v=e2c088d7"></script>
+    <script src="../_static/documentation_options.js?v=9e923c91"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/translations.js?v=cbf116e0"></script>
 
     <script src="../_static/sidebar.js"></script>
 
     <link rel="search" type="application/opensearchdescription+xml"
-          title="在 Python 3.14.3 說明文件 中搜尋"
+          title="在 Python 3.14.4 說明文件 中搜尋"
           href="../_static/opensearch.xml"/>
     <link rel="author" title="關於這些文件" href="../about.html" />
     <link rel="index" title="索引" href="../genindex.html" />
@@ -169,7 +169,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="../index.html">3.14.3 Documentation</a> &#187;
+      <a href="../index.html">3.14.4 Documentation</a> &#187;
     </li>
 
           <li class="nav-item nav-item-1"><a href="index.html" >Python/C API 參考手冊</a> &#187;</li>
@@ -528,7 +528,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="../index.html">3.14.3 Documentation</a> &#187;
+      <a href="../index.html">3.14.4 Documentation</a> &#187;
     </li>
 
           <li class="nav-item nav-item-1"><a href="index.html" >Python/C API 參考手冊</a> &#187;</li>
@@ -574,7 +574,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 4月 07, 2026 (00:29 UTC)。
+      最後更新於 4月 08, 2026 (00:30 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1214/c-api/apiabiversion.html

@@ -5,22 +5,22 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <title>API 和 ABI 版本管理 &#8212; Python 3.14.3 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>API 和 ABI 版本管理 &#8212; Python 3.14.4 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
 
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=b86133f3" />
     <link rel="stylesheet" type="text/css" href="../_static/classic.css?v=234b1a7c" />
     <link rel="stylesheet" type="text/css" href="../_static/pydoctheme.css?v=82640b3f" />
     <link id="pygments_dark_css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css" href="../_static/pygments_dark.css?v=5349f25f" />
 
-    <script src="../_static/documentation_options.js?v=e2c088d7"></script>
+    <script src="../_static/documentation_options.js?v=9e923c91"></script>
     <script src="../_static/doctools.js?v=9bcbadda"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/translations.js?v=cbf116e0"></script>
 
     <script src="../_static/sidebar.js"></script>
 
     <link rel="search" type="application/opensearchdescription+xml"
-          title="在 Python 3.14.3 說明文件 中搜尋"
+          title="在 Python 3.14.4 說明文件 中搜尋"
           href="../_static/opensearch.xml"/>
     <link rel="author" title="關於這些文件" href="../about.html" />
     <link rel="index" title="索引" href="../genindex.html" />
@@ -171,7 +171,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="../index.html">3.14.3 Documentation</a> &#187;
+      <a href="../index.html">3.14.4 Documentation</a> &#187;
     </li>
 
           <li class="nav-item nav-item-1"><a href="index.html" accesskey="U">Python/C API 參考手冊</a> &#187;</li>
@@ -469,7 +469,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="../index.html">3.14.3 Documentation</a> &#187;
+      <a href="../index.html">3.14.4 Documentation</a> &#187;
     </li>
 
           <li class="nav-item nav-item-1"><a href="index.html" >Python/C API 參考手冊</a> &#187;</li>
@@ -514,7 +514,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 4月 07, 2026 (00:29 UTC)。
+      最後更新於 4月 08, 2026 (00:30 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？