Deploy preview for PR 1193 🛫

Author: mattwang44

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

@@ -2504,6 +2504,19 @@ expression support in the :mod:`re` module).
    done using the specified *fillchar* (default is an ASCII space). The
    original string is returned if *width* is less than or equal to ``len(s)``.
 
+   For example:
+
+   .. doctest::
+
+      >>> 'Python'.rjust(10)
+      '    Python'
+      >>> 'Python'.rjust(10, '.')
+      '....Python'
+      >>> 'Monty Python'.rjust(10, '.')
+      'Monty Python'
+
+   See also :meth:`ljust` and :meth:`zfill`.
+
 
 .. method:: str.rpartition(sep, /)
 
@@ -2820,13 +2833,17 @@ expression support in the :mod:`re` module).
    than before. The original string is returned if *width* is less than
    or equal to ``len(s)``.
 
-   For example::
+   For example:
+
+   .. doctest::
 
       >>> "42".zfill(5)
       '00042'
       >>> "-42".zfill(5)
       '-0042'
 
+   See also :meth:`rjust`.
+
 
 .. index::
    single: ! formatted string literal

pr-preview/pr-1193/_sources/library/typing.rst.txt

@@ -3347,8 +3347,8 @@ Introspection helpers
 
 .. function:: get_type_hints(obj, globalns=None, localns=None, include_extras=False)
 
-   Return a dictionary containing type hints for a function, method, module
-   or class object.
+   Return a dictionary containing type hints for a function, method, module,
+   class object, or other callable object.
 
    This is often the same as ``obj.__annotations__``, but this function makes
    the following changes to the annotations dictionary:
@@ -3389,6 +3389,13 @@ Introspection helpers
       :ref:`type aliases <type-aliases>` that include forward references,
       or with names imported under :data:`if TYPE_CHECKING <TYPE_CHECKING>`.
 
+   .. note::
+
+      Calling :func:`get_type_hints` on an instance is not supported.
+      To retrieve annotations for an instance, call
+      :func:`get_type_hints` on the instance's class instead
+      (for example, ``get_type_hints(type(obj))``).
+
    .. versionchanged:: 3.9
       Added ``include_extras`` parameter as part of :pep:`593`.
       See the documentation on :data:`Annotated` for more information.
@@ -3398,6 +3405,11 @@ Introspection helpers
       if a default value equal to ``None`` was set.
       Now the annotation is returned unchanged.
 
+   .. versionchanged:: 3.14
+      Calling :func:`get_type_hints` on instances is no longer supported.
+      Some instances were accepted in earlier versions as an undocumented
+      implementation detail.
+
 .. function:: get_origin(tp)
 
    Get the unsubscripted version of a type: for a typing object of the form

pr-preview/pr-1193/_static/glossary.json

@@ -124,7 +124,7 @@ <h4>下個主題</h4>
     <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="bugs.html">回報錯誤</a></li>
-      <li><a class="improvepage" href="improve-page-nojs.html">Improve this page</a></li>
+      <li><a class="improvepage" href="improve-page-nojs.html">改進此頁面</a></li>
       <li>
         <a href="https://github.com/python/cpython/blob/main/Doc/about.rst?plain=1"
             rel="nofollow">顯示原始碼
@@ -264,7 +264,7 @@ <h4>下個主題</h4>
     <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="bugs.html">回報錯誤</a></li>
-      <li><a class="improvepage" href="improve-page-nojs.html">Improve this page</a></li>
+      <li><a class="improvepage" href="improve-page-nojs.html">改進此頁面</a></li>
       <li>
         <a href="https://github.com/python/cpython/blob/main/Doc/about.rst?plain=1"
             rel="nofollow">顯示原始碼
@@ -356,7 +356,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 2月 26, 2026 (00:24 UTC)。
+      最後更新於 2月 26, 2026 (18:25 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1193/about.html

@@ -126,7 +126,7 @@ <h4>下個主題</h4>
     <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="#">回報錯誤</a></li>
-      <li><a class="improvepage" href="improve-page-nojs.html">Improve this page</a></li>
+      <li><a class="improvepage" href="improve-page-nojs.html">改進此頁面</a></li>
       <li>
         <a href="https://github.com/python/cpython/blob/main/Doc/bugs.rst?plain=1"
             rel="nofollow">顯示原始碼
@@ -207,9 +207,7 @@ <h3>導航</h3>
   <section id="dealing-with-bugs">
 <span id="reporting-bugs"></span><h1>處理錯誤 (Bug)<a class="headerlink" href="#dealing-with-bugs" title="連結到這個標頭">¶</a></h1>
 <p>Python 已經是一個以穩定著稱的成熟程式語言。為了維持「穩定」的信譽，開發者們想知道任何你在 Python 中發現的缺失。</p>
-<p>It can be sometimes faster to fix bugs yourself and contribute patches to
-Python as it streamlines the process and involves fewer people. Learn how to
-<a class="reference internal" href="#contributing-to-python"><span class="std std-ref">contribute</span></a>.</p>
+<p>有時候自己直接修復錯誤並且送出一個修正給 Python 會比較快，因為這樣會加速流程而且不會困擾到太多人。學習如何<a class="reference internal" href="#contributing-to-python"><span class="std std-ref">貢獻給 Python</span></a>。</p>
 <section id="documentation-bugs">
 <h2>說明文件的錯誤<a class="headerlink" href="#documentation-bugs" title="連結到這個標頭">¶</a></h2>
 <p>如果你在這份說明文件中發現了錯誤並想要提出改進方案，請將錯誤報告提交到<a class="reference internal" href="#using-the-tracker"><span class="std std-ref">錯誤追蹤系統 (issue tracker)</span></a>。如果你有相應的修正建議，請一併提交。（譯者註：如果是繁體中文說明文件翻譯相關的錯誤，請提交到 <a class="reference external" href="https://github.com/python/python-docs-zh-tw/issues">https://github.com/python/python-docs-zh-tw/issues</a>。）</p>
@@ -252,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>
 
@@ -303,7 +301,7 @@ <h4>下個主題</h4>
     <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="#">回報錯誤</a></li>
-      <li><a class="improvepage" href="improve-page-nojs.html">Improve this page</a></li>
+      <li><a class="improvepage" href="improve-page-nojs.html">改進此頁面</a></li>
       <li>
         <a href="https://github.com/python/cpython/blob/main/Doc/bugs.rst?plain=1"
             rel="nofollow">顯示原始碼
@@ -395,7 +393,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 2月 26, 2026 (00:24 UTC)。
+      最後更新於 2月 26, 2026 (18:25 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1193/bugs.html

@@ -114,7 +114,7 @@ <h4>下個主題</h4>
     <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
-      <li><a class="improvepage" href="../improve-page-nojs.html">Improve this page</a></li>
+      <li><a class="improvepage" href="../improve-page-nojs.html">改進此頁面</a></li>
       <li>
         <a href="https://github.com/python/cpython/blob/main/Doc/c-api/abstract.rst?plain=1"
             rel="nofollow">顯示原始碼
@@ -162,7 +162,7 @@ <h3>導航</h3>
       <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 reference manual</a> &#187;</li>
+          <li class="nav-item nav-item-1"><a href="index.html" accesskey="U">Python/C API 參考手冊</a> &#187;</li>
         <li class="nav-item nav-item-this"><a href="">抽象物件層 (Abstract Objects Layer)</a></li>
                 <li class="right">
 
@@ -272,7 +272,7 @@ <h4>下個主題</h4>
     <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
-      <li><a class="improvepage" href="../improve-page-nojs.html">Improve this page</a></li>
+      <li><a class="improvepage" href="../improve-page-nojs.html">改進此頁面</a></li>
       <li>
         <a href="https://github.com/python/cpython/blob/main/Doc/c-api/abstract.rst?plain=1"
             rel="nofollow">顯示原始碼
@@ -323,7 +323,7 @@ <h3>導航</h3>
       <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 reference manual</a> &#187;</li>
+          <li class="nav-item nav-item-1"><a href="index.html" >Python/C API 參考手冊</a> &#187;</li>
         <li class="nav-item nav-item-this"><a href="">抽象物件層 (Abstract Objects Layer)</a></li>
                 <li class="right">
 
@@ -365,7 +365,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 2月 26, 2026 (00:24 UTC)。
+      最後更新於 2月 26, 2026 (18:25 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

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

@@ -124,7 +124,7 @@ <h4>下個主題</h4>
     <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
-      <li><a class="improvepage" href="../improve-page-nojs.html">Improve this page</a></li>
+      <li><a class="improvepage" href="../improve-page-nojs.html">改進此頁面</a></li>
       <li>
         <a href="https://github.com/python/cpython/blob/main/Doc/c-api/allocation.rst?plain=1"
             rel="nofollow">顯示原始碼
@@ -172,7 +172,7 @@ <h3>導航</h3>
       <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 reference manual</a> &#187;</li>
+          <li class="nav-item nav-item-1"><a href="index.html" >Python/C API 參考手冊</a> &#187;</li>
           <li class="nav-item nav-item-2"><a href="objimpl.html" accesskey="U">物件實作支援</a> &#187;</li>
         <li class="nav-item nav-item-this"><a href="">在 heap 上分配物件</a></li>
                 <li class="right">
@@ -480,7 +480,7 @@ <h4>下個主題</h4>
     <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
-      <li><a class="improvepage" href="../improve-page-nojs.html">Improve this page</a></li>
+      <li><a class="improvepage" href="../improve-page-nojs.html">改進此頁面</a></li>
       <li>
         <a href="https://github.com/python/cpython/blob/main/Doc/c-api/allocation.rst?plain=1"
             rel="nofollow">顯示原始碼
@@ -531,7 +531,7 @@ <h3>導航</h3>
       <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 reference manual</a> &#187;</li>
+          <li class="nav-item nav-item-1"><a href="index.html" >Python/C API 參考手冊</a> &#187;</li>
           <li class="nav-item nav-item-2"><a href="objimpl.html" >物件實作支援</a> &#187;</li>
         <li class="nav-item nav-item-this"><a href="">在 heap 上分配物件</a></li>
                 <li class="right">
@@ -574,7 +574,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 2月 26, 2026 (00:24 UTC)。
+      最後更新於 2月 26, 2026 (18:25 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

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

@@ -126,7 +126,7 @@ <h4>下個主題</h4>
     <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
-      <li><a class="improvepage" href="../improve-page-nojs.html">Improve this page</a></li>
+      <li><a class="improvepage" href="../improve-page-nojs.html">改進此頁面</a></li>
       <li>
         <a href="https://github.com/python/cpython/blob/main/Doc/c-api/apiabiversion.rst?plain=1"
             rel="nofollow">顯示原始碼
@@ -174,7 +174,7 @@ <h3>導航</h3>
       <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 reference manual</a> &#187;</li>
+          <li class="nav-item nav-item-1"><a href="index.html" accesskey="U">Python/C API 參考手冊</a> &#187;</li>
         <li class="nav-item nav-item-this"><a href="">API 和 ABI 版本管理</a></li>
                 <li class="right">
 
@@ -421,7 +421,7 @@ <h4>下個主題</h4>
     <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
-      <li><a class="improvepage" href="../improve-page-nojs.html">Improve this page</a></li>
+      <li><a class="improvepage" href="../improve-page-nojs.html">改進此頁面</a></li>
       <li>
         <a href="https://github.com/python/cpython/blob/main/Doc/c-api/apiabiversion.rst?plain=1"
             rel="nofollow">顯示原始碼
@@ -472,7 +472,7 @@ <h3>導航</h3>
       <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 reference manual</a> &#187;</li>
+          <li class="nav-item nav-item-1"><a href="index.html" >Python/C API 參考手冊</a> &#187;</li>
         <li class="nav-item nav-item-this"><a href="">API 和 ABI 版本管理</a></li>
                 <li class="right">
 
@@ -514,7 +514,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 2月 26, 2026 (00:24 UTC)。
+      最後更新於 2月 26, 2026 (18:25 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

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

@@ -131,7 +131,7 @@ <h4>下個主題</h4>
     <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
-      <li><a class="improvepage" href="../improve-page-nojs.html">Improve this page</a></li>
+      <li><a class="improvepage" href="../improve-page-nojs.html">改進此頁面</a></li>
       <li>
         <a href="https://github.com/python/cpython/blob/main/Doc/c-api/arg.rst?plain=1"
             rel="nofollow">顯示原始碼
@@ -179,7 +179,7 @@ <h3>導航</h3>
       <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 reference manual</a> &#187;</li>
+          <li class="nav-item nav-item-1"><a href="index.html" >Python/C API 參考手冊</a> &#187;</li>
           <li class="nav-item nav-item-2"><a href="utilities.html" accesskey="U">工具</a> &#187;</li>
         <li class="nav-item nav-item-this"><a href="">剖析引數與建置數值</a></li>
                 <li class="right">
@@ -902,7 +902,7 @@ <h4>下個主題</h4>
     <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
-      <li><a class="improvepage" href="../improve-page-nojs.html">Improve this page</a></li>
+      <li><a class="improvepage" href="../improve-page-nojs.html">改進此頁面</a></li>
       <li>
         <a href="https://github.com/python/cpython/blob/main/Doc/c-api/arg.rst?plain=1"
             rel="nofollow">顯示原始碼
@@ -953,7 +953,7 @@ <h3>導航</h3>
       <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 reference manual</a> &#187;</li>
+          <li class="nav-item nav-item-1"><a href="index.html" >Python/C API 參考手冊</a> &#187;</li>
           <li class="nav-item nav-item-2"><a href="utilities.html" >工具</a> &#187;</li>
         <li class="nav-item nav-item-this"><a href="">剖析引數與建置數值</a></li>
                 <li class="right">
@@ -996,7 +996,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 2月 26, 2026 (00:24 UTC)。
+      最後更新於 2月 26, 2026 (18:25 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1193/c-api/arg.html

@@ -114,7 +114,7 @@ <h4>下個主題</h4>
     <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
-      <li><a class="improvepage" href="../improve-page-nojs.html">Improve this page</a></li>
+      <li><a class="improvepage" href="../improve-page-nojs.html">改進此頁面</a></li>
       <li>
         <a href="https://github.com/python/cpython/blob/main/Doc/c-api/bool.rst?plain=1"
             rel="nofollow">顯示原始碼
@@ -162,7 +162,7 @@ <h3>導航</h3>
       <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 reference manual</a> &#187;</li>
+          <li class="nav-item nav-item-1"><a href="index.html" >Python/C API 參考手冊</a> &#187;</li>
           <li class="nav-item nav-item-2"><a href="concrete.html" accesskey="U">具體物件層</a> &#187;</li>
         <li class="nav-item nav-item-this"><a href="">Boolean（布林）物件</a></li>
                 <li class="right">
@@ -282,7 +282,7 @@ <h4>下個主題</h4>
     <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
-      <li><a class="improvepage" href="../improve-page-nojs.html">Improve this page</a></li>
+      <li><a class="improvepage" href="../improve-page-nojs.html">改進此頁面</a></li>
       <li>
         <a href="https://github.com/python/cpython/blob/main/Doc/c-api/bool.rst?plain=1"
             rel="nofollow">顯示原始碼
@@ -333,7 +333,7 @@ <h3>導航</h3>
       <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 reference manual</a> &#187;</li>
+          <li class="nav-item nav-item-1"><a href="index.html" >Python/C API 參考手冊</a> &#187;</li>
           <li class="nav-item nav-item-2"><a href="concrete.html" >具體物件層</a> &#187;</li>
         <li class="nav-item nav-item-this"><a href="">Boolean（布林）物件</a></li>
                 <li class="right">
@@ -376,7 +376,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 2月 26, 2026 (00:24 UTC)。
+      最後更新於 2月 26, 2026 (18:25 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？