Deploy preview for PR 1123 🛫

Author: mattwang44

pr-preview/pr-1123/_sources/library/asyncio-eventloop.rst.txt

@@ -595,6 +595,12 @@ Opening network connections
      to bind the socket locally.  The *local_host* and *local_port*
      are looked up using :meth:`getaddrinfo`.
 
+     .. note::
+
+        On Windows, when using the proactor event loop with ``local_addr=None``,
+        an :exc:`OSError` with :attr:`!errno.WSAEINVAL` will be raised
+        when running it.
+
    * *remote_addr*, if given, is a ``(remote_host, remote_port)`` tuple used
      to connect the socket to a remote address.  The *remote_host* and
      *remote_port* are looked up using :meth:`getaddrinfo`.

pr-preview/pr-1123/_sources/library/codecs.rst.txt

@@ -1472,6 +1472,36 @@ to :class:`bytes` mappings. They are not supported by :meth:`bytes.decode`
    Restoration of the aliases for the binary transforms.
 
 
+.. _standalone-codec-functions:
+
+Standalone Codec Functions
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The following functions provide encoding and decoding functionality similar to codecs,
+but are not available as named codecs through :func:`codecs.encode` or :func:`codecs.decode`.
+They are used internally (for example, by :mod:`pickle`) and behave similarly to the
+``string_escape`` codec that was removed in Python 3.
+
+.. function:: codecs.escape_encode(input, errors=None)
+
+   Encode *input* using escape sequences. Similar to how :func:`repr` on bytes
+   produces escaped byte values.
+
+   *input* must be a :class:`bytes` object.
+
+   Returns a tuple ``(output, length)`` where *output* is a :class:`bytes`
+   object and *length* is the number of bytes consumed.
+
+.. function:: codecs.escape_decode(input, errors=None)
+
+   Decode *input* from escape sequences back to the original bytes.
+
+   *input* must be a :term:`bytes-like object`.
+
+   Returns a tuple ``(output, length)`` where *output* is a :class:`bytes`
+   object and *length* is the number of bytes consumed.
+
+
 .. _text-transforms:
 
 Text Transforms

pr-preview/pr-1123/_sources/library/concurrent.futures.rst.txt

@@ -243,6 +243,11 @@ that :class:`ProcessPoolExecutor` will not work in the interactive interpreter.
 Calling :class:`Executor` or :class:`Future` methods from a callable submitted
 to a :class:`ProcessPoolExecutor` will result in deadlock.
 
+Note that the restrictions on functions and arguments needing to picklable as
+per :class:`multiprocessing.Process` apply when using :meth:`~Executor.submit`
+and :meth:`~Executor.map` on a :class:`ProcessPoolExecutor`. A function defined
+in a REPL or a lambda should not be expected to work.
+
 .. class:: ProcessPoolExecutor(max_workers=None, mp_context=None, initializer=None, initargs=(), max_tasks_per_child=None)
 
    An :class:`Executor` subclass that executes calls asynchronously using a pool

pr-preview/pr-1123/_sources/library/http.cookies.rst.txt

@@ -147,9 +147,12 @@ Morsel Objects
    in HTTP requests, and is not accessible through JavaScript. This is intended
    to mitigate some forms of cross-site scripting.
 
-   The attribute :attr:`samesite` specifies that the browser is not allowed to
-   send the cookie along with cross-site requests. This helps to mitigate CSRF
-   attacks. Valid values for this attribute are "Strict" and "Lax".
+   The attribute :attr:`samesite` controls when the browser sends the cookie with
+   cross-site requests. This helps to mitigate CSRF attacks. Valid values are
+   "Strict" (only sent with same-site requests), "Lax" (sent with same-site
+   requests and top-level navigations), and "None" (sent with same-site and
+   cross-site requests). When using "None", the "secure" attribute must also
+   be set, as required by modern browsers.
 
    The keys are case-insensitive and their default value is ``''``.
 

pr-preview/pr-1123/_sources/library/multiprocessing.rst.txt

@@ -97,6 +97,10 @@ To show the individual process IDs involved, here is an expanded example::
 For an explanation of why the ``if __name__ == '__main__'`` part is
 necessary, see :ref:`multiprocessing-programming`.
 
+The arguments to :class:`Process` usually need to be unpickleable from within
+the child process. If you tried typing the above example directly into a REPL it
+could lead to an :exc:`AttributeError` in the child process trying to locate the
+*f* function in the ``__main__`` module.
 
 
 .. _multiprocessing-start-methods:
@@ -107,6 +111,8 @@ Contexts and start methods
 Depending on the platform, :mod:`multiprocessing` supports three ways
 to start a process.  These *start methods* are
 
+  .. _multiprocessing-start-method-spawn:
+
   *spawn*
     The parent process starts a fresh Python interpreter process.  The
     child process will only inherit those resources necessary to run
@@ -117,6 +123,8 @@ to start a process.  These *start methods* are
 
     Available on POSIX and Windows platforms.  The default on Windows and macOS.
 
+  .. _multiprocessing-start-method-fork:
+
   *fork*
     The parent process uses :func:`os.fork` to fork the Python
     interpreter.  The child process, when it begins, is effectively
@@ -137,6 +145,8 @@ to start a process.  These *start methods* are
        raise a :exc:`DeprecationWarning`. Use a different start method.
        See the :func:`os.fork` documentation for further explanation.
 
+  .. _multiprocessing-start-method-forkserver:
+
   *forkserver*
     When the program starts and selects the *forkserver* start method,
     a server process is spawned.  From then on, whenever a new process
@@ -218,9 +228,12 @@ processes for a different context.  In particular, locks created using
 the *fork* context cannot be passed to processes started using the
 *spawn* or *forkserver* start methods.
 
-A library which wants to use a particular start method should probably
-use :func:`get_context` to avoid interfering with the choice of the
-library user.
+Libraries using :mod:`multiprocessing` or
+:class:`~concurrent.futures.ProcessPoolExecutor` should be designed to allow
+their users to provide their own multiprocessing context.  Using a specific
+context of your own within a library can lead to incompatibilities with the
+rest of the library user's application.  Always document if your library
+requires a specific start method.
 
 .. warning::
 
@@ -518,9 +531,42 @@ The :mod:`multiprocessing` package mostly replicates the API of the
    to pass to *target*.
 
    If a subclass overrides the constructor, it must make sure it invokes the
-   base class constructor (:meth:`Process.__init__`) before doing anything else
+   base class constructor (``super().__init__()``) before doing anything else
    to the process.
 
+   .. note::
+
+      In general, all arguments to :class:`Process` must be picklable.  This is
+      frequently observed when trying to create a :class:`Process` or use a
+      :class:`concurrent.futures.ProcessPoolExecutor` from a REPL with a
+      locally defined *target* function.
+
+      Passing a callable object defined in the current REPL session causes the
+      child process to die via an uncaught :exc:`AttributeError` exception when
+      starting as *target* must have been defined within an importable module
+      in order to be loaded during unpickling.
+
+      Example of this uncatchable error from the child::
+
+         >>> import multiprocessing as mp
+         >>> def knigit():
+         ...     print("Ni!")
+         ...
+         >>> process = mp.Process(target=knigit)
+         >>> process.start()
+         >>> Traceback (most recent call last):
+           File ".../multiprocessing/spawn.py", line ..., in spawn_main
+           File ".../multiprocessing/spawn.py", line ..., in _main
+         AttributeError: module '__main__' has no attribute 'knigit'
+         >>> process
+         <SpawnProcess name='SpawnProcess-1' pid=379473 parent=378707 stopped exitcode=1>
+
+      See :ref:`multiprocessing-programming-spawn`.  While this restriction is
+      not true if using the ``"fork"`` start method, as of Python ``3.14`` that
+      is no longer the default on any platform.  See
+      :ref:`multiprocessing-start-methods`.
+      See also :gh:`132898`.
+
    .. versionchanged:: 3.3
       Added the *daemon* parameter.
 
@@ -2985,6 +3031,9 @@ Beware of replacing :data:`sys.stdin` with a "file like object"
 
     For more information, see :issue:`5155`, :issue:`5313` and :issue:`5331`
 
+.. _multiprocessing-programming-spawn:
+.. _multiprocessing-programming-forkserver:
+
 The *spawn* and *forkserver* start methods
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -2993,10 +3042,10 @@ start method.
 
 More picklability
 
-    Ensure that all arguments to :meth:`Process.__init__` are picklable.
-    Also, if you subclass :class:`~multiprocessing.Process` then make sure that
-    instances will be picklable when the :meth:`Process.start
-    <multiprocessing.Process.start>` method is called.
+    Ensure that all arguments to :class:`~multiprocessing.Process` are
+    picklable.  Also, if you subclass ``Process.__init__``, you must make sure
+    that instances will be picklable when the
+    :meth:`Process.start <multiprocessing.Process.start>` method is called.
 
 Global variables
 

pr-preview/pr-1123/about.html

@@ -111,7 +111,7 @@ <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="bugs.html">回報錯誤</a></li>
       <li>
-        <a href="https://github.com/python/cpython/blob/main/Doc/about.rst"
+        <a href="https://github.com/python/cpython/blob/main/Doc/about.rst?plain=1"
             rel="nofollow">顯示原始碼
         </a>
       </li>
@@ -230,7 +230,7 @@ <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="bugs.html">回報錯誤</a></li>
       <li>
-        <a href="https://github.com/python/cpython/blob/main/Doc/about.rst"
+        <a href="https://github.com/python/cpython/blob/main/Doc/about.rst?plain=1"
             rel="nofollow">顯示原始碼
         </a>
       </li>
@@ -320,7 +320,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br>
     <br>
-      最後更新於 7月 26, 2025 (00:22 UTC)。
+      最後更新於 7月 28, 2025 (16:34 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

pr-preview/pr-1123/bugs.html

@@ -113,7 +113,7 @@ <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="#">回報錯誤</a></li>
       <li>
-        <a href="https://github.com/python/cpython/blob/main/Doc/bugs.rst"
+        <a href="https://github.com/python/cpython/blob/main/Doc/bugs.rst?plain=1"
             rel="nofollow">顯示原始碼
         </a>
       </li>
@@ -231,7 +231,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>
 
@@ -269,7 +269,7 @@ <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="#">回報錯誤</a></li>
       <li>
-        <a href="https://github.com/python/cpython/blob/main/Doc/bugs.rst"
+        <a href="https://github.com/python/cpython/blob/main/Doc/bugs.rst?plain=1"
             rel="nofollow">顯示原始碼
         </a>
       </li>
@@ -359,7 +359,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br>
     <br>
-      最後更新於 7月 26, 2025 (00:22 UTC)。
+      最後更新於 7月 28, 2025 (16:34 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

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

@@ -101,7 +101,7 @@ <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
       <li>
-        <a href="https://github.com/python/cpython/blob/main/Doc/c-api/abstract.rst"
+        <a href="https://github.com/python/cpython/blob/main/Doc/c-api/abstract.rst?plain=1"
             rel="nofollow">顯示原始碼
         </a>
       </li>
@@ -238,7 +238,7 @@ <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
       <li>
-        <a href="https://github.com/python/cpython/blob/main/Doc/c-api/abstract.rst"
+        <a href="https://github.com/python/cpython/blob/main/Doc/c-api/abstract.rst?plain=1"
             rel="nofollow">顯示原始碼
         </a>
       </li>
@@ -329,7 +329,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br>
     <br>
-      最後更新於 7月 26, 2025 (00:22 UTC)。
+      最後更新於 7月 28, 2025 (16:34 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

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

@@ -101,7 +101,7 @@ <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
       <li>
-        <a href="https://github.com/python/cpython/blob/main/Doc/c-api/allocation.rst"
+        <a href="https://github.com/python/cpython/blob/main/Doc/c-api/allocation.rst?plain=1"
             rel="nofollow">顯示原始碼
         </a>
       </li>
@@ -254,7 +254,7 @@ <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
       <li>
-        <a href="https://github.com/python/cpython/blob/main/Doc/c-api/allocation.rst"
+        <a href="https://github.com/python/cpython/blob/main/Doc/c-api/allocation.rst?plain=1"
             rel="nofollow">顯示原始碼
         </a>
       </li>
@@ -346,7 +346,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br>
     <br>
-      最後更新於 7月 26, 2025 (00:22 UTC)。
+      最後更新於 7月 28, 2025 (16:34 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

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

@@ -101,7 +101,7 @@ <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
       <li>
-        <a href="https://github.com/python/cpython/blob/main/Doc/c-api/apiabiversion.rst"
+        <a href="https://github.com/python/cpython/blob/main/Doc/c-api/apiabiversion.rst?plain=1"
             rel="nofollow">顯示原始碼
         </a>
       </li>
@@ -285,7 +285,7 @@ <h3>此頁面</h3>
     <ul class="this-page-menu">
       <li><a href="../bugs.html">回報錯誤</a></li>
       <li>
-        <a href="https://github.com/python/cpython/blob/main/Doc/c-api/apiabiversion.rst"
+        <a href="https://github.com/python/cpython/blob/main/Doc/c-api/apiabiversion.rst?plain=1"
             rel="nofollow">顯示原始碼
         </a>
       </li>
@@ -376,7 +376,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br>
     <br>
-      最後更新於 7月 26, 2025 (00:22 UTC)。
+      最後更新於 7月 28, 2025 (16:34 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?