Skip to content

gh-132898: Add a note in multiprocessing.Process docs about creating a process in a REPL session #137118

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
gpshead merged 8 commits into from
Jul 27, 2025
Merged

gh-132898: Add a note in multiprocessing.Process docs about creating a process in a REPL session #137118

Changes from 1 commit
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
c64de22
initial commit
YvesDup Jul 23, 2025
dd2d43e
Merge branch 'main' into Update-doc-process-target-location
YvesDup Jul 26, 2025
607ae4a
Reword, expand, and clarify the limitation, highlighting the REPL case.
gpshead Jul 27, 2025
b9773c7
Move out of a .. note into the main text. mention in the high level …
gpshead Jul 27, 2025
4ad605a
move back to a note, it keeps it clear that this is "special"
gpshead Jul 27, 2025
2a115a3
editing for clarity
gpshead Jul 27, 2025
5f36fbf
formatting
gpshead Jul 27, 2025
4b848a9
add a pointer to the GH issue from the doc note
gpshead Jul 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
initial commit
  • Loading branch information
@YvesDup
YvesDup committed Jul 26, 2025
commit c64de22e76aa621a4e168b21f43b8b8aa10b2940
15 changes: 15 additions & 0 deletions Doc/library/multiprocessing.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -544,6 +544,21 @@ The :mod:`multiprocessing` package mostly replicates the API of the
.. versionchanged:: 3.3
Added the *daemon* parameter.

.. note::

Starting with Python 3.14, ``'fork'`` is no longer the default start
method on any operating system. When creating a new ``Process`` object
in a REPL session, with a start method such as ``'spawn'`` or ``'forkserver'``
(other than ``'fork'``), the *target* argument must be
a callable object **mandatorily** defined in a module.

Using a callable object defined in the current REPL session raises
an :exc:`AttributeError` exception when starting the process,
although this is still possible when the start method is ``'fork'``.

This also applies to the use of the
:class:`concurrent.futures.ProcessPoolExecutor` class.

.. method:: run()

Method representing the process's activity.
Expand Down
Loading