Deploy preview for PR 1199 🛫

Author: josix

pr-preview/pr-1199/.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: f87e8867697d38f9afc2009f0655d1bc
+config: d6751eade72bed0b8f7a3e9e8373c012
 tags: b5e2c454ba7771976391ed0cecdde553

pr-preview/pr-1199/_sources/howto/logging-cookbook.rst.txt

@@ -229,7 +229,7 @@ messages should not. Here's how you can achieve this::
    # tell the handler to use this format
    console.setFormatter(formatter)
    # add the handler to the root logger
-   logging.getLogger('').addHandler(console)
+   logging.getLogger().addHandler(console)
 
    # Now, we can log to the root logger, or any other logger. First the root...
    logging.info('Jackdaws love my big sphinx of quartz.')
@@ -650,7 +650,7 @@ the receiving end. A simple way of doing this is attaching a
 
    import logging, logging.handlers
 
-   rootLogger = logging.getLogger('')
+   rootLogger = logging.getLogger()
    rootLogger.setLevel(logging.DEBUG)
    socketHandler = logging.handlers.SocketHandler('localhost',
                        logging.handlers.DEFAULT_TCP_LOGGING_PORT)

pr-preview/pr-1199/_sources/library/os.path.rst.txt

@@ -97,15 +97,17 @@ the :mod:`glob` module.)
 
 .. function:: commonprefix(list, /)
 
-   Return the longest path prefix (taken character-by-character) that is a
-   prefix of all paths in  *list*.  If *list* is empty, return the empty string
+   Return the longest string prefix (taken character-by-character) that is a
+   prefix of all strings in *list*.  If *list* is empty, return the empty string
    (``''``).
 
-   .. note::
+   .. warning::
 
       This function may return invalid paths because it works a
-      character at a time.  To obtain a valid path, see
-      :func:`commonpath`.
+      character at a time.
+      If you need a **common path prefix**, then the algorithm
+      implemented in this function is not secure. Use
+      :func:`commonpath` for finding a common path prefix.
 
       ::
 

pr-preview/pr-1199/_sources/library/stdtypes.rst.txt

@@ -2163,6 +2163,8 @@ expression support in the :mod:`re` module).
 
    .. doctest::
 
+      >>> 'spam, spam, spam'.index('spam')
+      0
       >>> 'spam, spam, spam'.index('eggs')
       Traceback (most recent call last):
         File "<python-input-0>", line 1, in <module>
@@ -2546,6 +2548,20 @@ expression support in the :mod:`re` module).
 
    Like :meth:`rfind` but raises :exc:`ValueError` when the substring *sub* is not
    found.
+   For example:
+
+   .. doctest::
+
+      >>> 'spam, spam, spam'.rindex('spam')
+      12
+      >>> 'spam, spam, spam'.rindex('eggs')
+      Traceback (most recent call last):
+        File "<stdin-0>", line 1, in <module>
+          'spam, spam, spam'.rindex('eggs')
+          ~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^
+      ValueError: substring not found
+
+   See also :meth:`index` and :meth:`find`.
 
 
 .. method:: str.rjust(width, fillchar=' ', /)

pr-preview/pr-1199/_sources/library/urllib.robotparser.rst.txt

@@ -91,16 +91,16 @@ class::
 
    >>> import urllib.robotparser
    >>> rp = urllib.robotparser.RobotFileParser()
-   >>> rp.set_url("http://www.musi-cal.com/robots.txt")
+   >>> rp.set_url("http://www.pythontest.net/robots.txt")
    >>> rp.read()
    >>> rrate = rp.request_rate("*")
    >>> rrate.requests
-   3
+   1
    >>> rrate.seconds
-   20
+   1
    >>> rp.crawl_delay("*")
    6
-   >>> rp.can_fetch("*", "http://www.musi-cal.com/cgi-bin/search?city=San+Francisco")
-   False
-   >>> rp.can_fetch("*", "http://www.musi-cal.com/")
+   >>> rp.can_fetch("*", "http://www.pythontest.net/")
    True
+   >>> rp.can_fetch("*", "http://www.pythontest.net/no-robots-here/")
+   False

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

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

pr-preview/pr-1199/_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.2 說明文件</Description>
+  <Description>搜尋 Python 3.14.3 說明文件</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.2 說明文件</LongName>
+  <LongName>Python 3.14.3 說明文件</LongName>
 <Image height="16" width="16" type="image/x-icon">https://www.python.org/images/favicon16x16.ico</Image>
 </OpenSearchDescription>

pr-preview/pr-1199/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.2 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>關於這份說明文件 &#8212; Python 3.14.3 說明文件</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=4eb63a40" />
     <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=f006b4cd"></script>
+    <script src="_static/documentation_options.js?v=e2c088d7"></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.2 說明文件 中搜尋"
+          title="在 Python 3.14.3 說明文件 中搜尋"
           href="_static/opensearch.xml"/>
     <link rel="author" title="關於這些文件" href="#" />
     <link rel="index" title="索引" href="genindex.html" />
@@ -154,7 +154,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="index.html">3.14.2 Documentation</a> &#187;
+      <a href="index.html">3.14.3 Documentation</a> &#187;
     </li>
 
         <li class="nav-item nav-item-this"><a href="">關於這份說明文件</a></li>
@@ -282,7 +282,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="index.html">3.14.2 Documentation</a> &#187;
+      <a href="index.html">3.14.3 Documentation</a> &#187;
     </li>
 
         <li class="nav-item nav-item-this"><a href="">關於這份說明文件</a></li>
@@ -326,7 +326,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 2月 02, 2026 (14:22 UTC)。
+      最後更新於 2月 04, 2026 (15:57 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1199/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.2 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>處理錯誤 (Bug) &#8212; Python 3.14.3 說明文件</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=4eb63a40" />
     <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=f006b4cd"></script>
+    <script src="_static/documentation_options.js?v=e2c088d7"></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.2 說明文件 中搜尋"
+          title="在 Python 3.14.3 說明文件 中搜尋"
           href="_static/opensearch.xml"/>
     <link rel="author" title="關於這些文件" href="about.html" />
     <link rel="index" title="索引" href="genindex.html" />
@@ -156,7 +156,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="index.html">3.14.2 Documentation</a> &#187;
+      <a href="index.html">3.14.3 Documentation</a> &#187;
     </li>
 
         <li class="nav-item nav-item-this"><a href="">處理錯誤 (Bug)</a></li>
@@ -235,7 +235,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://devguide.python.org/">Python 開發者指南</a>中找到如何開始修補 Python 的更多資訊。如果你有任何問題，<a class="reference external" href="https://mail.python.org/mailman3/lists/core-mentorship.python.org/">核心導師郵寄清單</a>是一個友善的地方，你可以在那裡得到，關於 Python 修正錯誤的過程中，所有問題的答案。</p>
+<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>
 </section>
 </section>
 
@@ -319,7 +319,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="index.html">3.14.2 Documentation</a> &#187;
+      <a href="index.html">3.14.3 Documentation</a> &#187;
     </li>
 
         <li class="nav-item nav-item-this"><a href="">處理錯誤 (Bug)</a></li>
@@ -363,7 +363,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 2月 02, 2026 (14:22 UTC)。
+      最後更新於 2月 04, 2026 (15:57 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1199/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.2 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>抽象物件層 (Abstract Objects Layer) &#8212; Python 3.14.3 說明文件</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=4eb63a40" />
     <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=f006b4cd"></script>
+    <script src="../_static/documentation_options.js?v=e2c088d7"></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.2 說明文件 中搜尋"
+          title="在 Python 3.14.3 說明文件 中搜尋"
           href="../_static/opensearch.xml"/>
     <link rel="author" title="關於這些文件" href="../about.html" />
     <link rel="index" title="索引" href="../genindex.html" />
@@ -144,7 +144,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="../index.html">3.14.2 Documentation</a> &#187;
+      <a href="../index.html">3.14.3 Documentation</a> &#187;
     </li>
 
           <li class="nav-item nav-item-1"><a href="index.html" accesskey="U">Python/C API 參考手冊</a> &#187;</li>
@@ -290,7 +290,7 @@ <h3>導航</h3>
 
           </li>
     <li id="cpython-language-and-version">
-      <a href="../index.html">3.14.2 Documentation</a> &#187;
+      <a href="../index.html">3.14.3 Documentation</a> &#187;
     </li>
 
           <li class="nav-item nav-item-1"><a href="index.html" >Python/C API 參考手冊</a> &#187;</li>
@@ -335,7 +335,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 2月 02, 2026 (14:22 UTC)。
+      最後更新於 2月 04, 2026 (15:57 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？