interpreters -> concurrent.interpreters

Author: ericsnowcurrently

.github/CODEOWNERS

@@ -281,13 +281,13 @@ Doc/howto/clinic.rst          @erlend-aasland
 # Subinterpreters
 **/*interpreteridobject.*     @ericsnowcurrently
 **/*crossinterp*              @ericsnowcurrently
-Lib/interpreters/             @ericsnowcurrently
 Modules/_interp*module.c      @ericsnowcurrently
-Lib/test/test_interpreters/   @ericsnowcurrently
 Lib/test/test__interp*.py     @ericsnowcurrently
+Lib/concurrent/interpreters/  @ericsnowcurrently
 Lib/test/support/channels.py  @ericsnowcurrently
+Doc/library/concurrent.interpreters.rst  @ericsnowcurrently
+Lib/test/test_interpreters/   @ericsnowcurrently
 Lib/concurrent/futures/interpreter.py  @ericsnowcurrently
-Doc/library/interpreters.rst  @ericsnowcurrently
 
 # Android
 **/*Android*                  @mhsmith @freakboy3742

Doc/library/concurrency.rst

@@ -18,13 +18,12 @@ multitasking). Here's an overview:
    multiprocessing.shared_memory.rst
    concurrent.rst
    concurrent.futures.rst
+   concurrent.interpreters.rst
    subprocess.rst
    sched.rst
    queue.rst
    contextvars.rst
 
-Also see the :mod:`interpreters` module.
-
 
 The following are support modules for some of the above services:
 

Doc/library/interpreters.rst Doc/library/concurrent.interpreters.rstDoc/library/interpreters.rst renamed to Doc/library/concurrent.interpreters.rst

@@ -1,24 +1,24 @@
-:mod:`!interpreters` --- Multiple Interpreters in the Same Process
-==================================================================
+:mod:`concurrent.!interpreters` --- Multiple Interpreters in the Same Process
+=============================================================================
 
-.. module:: interpreters
+.. module:: concurrent.interpreters
    :synopsis: Multiple Interpreters in the Same Process
 
 .. moduleauthor:: Eric Snow <ericsnowcurrently@gmail.com>
 .. sectionauthor:: Eric Snow <ericsnowcurrently@gmail.com>
 
 .. versionadded:: 3.14
 
-**Source code:** :source:`Lib/interpreters/__init__.py`
+**Source code:** :source:`Lib/concurrent/interpreters.py`
 
 --------------
 
 
 Introduction
 ------------
 
-The :mod:`!interpreters` module constructs higher-level interfaces
-on top of the lower level :mod:`!_interpreters` module.
+The :mod:`!concurrent.interpreters` module constructs higher-level
+interfaces on top of the lower level :mod:`!_interpreters` module.
 
 .. XXX Add references to the upcoming HOWTO docs in the seealso block.
 
@@ -167,7 +167,7 @@ Basic Usage
 
 Creating an interpreter and running code in it::
 
-    import interpreters
+    from concurrent import interpreters
 
     interp = interpreters.create()
 

Doc/library/concurrent.rst

@@ -1,6 +1,7 @@
 The :mod:`!concurrent` package
 ==============================
 
-Currently, there is only one module in this package:
+Currently, there are only two modules in this package:
 
 * :mod:`concurrent.futures` -- Launching parallel tasks
+* :mod:`concurrent.interpreters` -- Multiple interpreters in the same process

Doc/library/python.rst

@@ -17,7 +17,6 @@ overview:
    builtins.rst
    __main__.rst
    warnings.rst
-   interpreters.rst
    dataclasses.rst
    contextlib.rst
    abc.rst
@@ -28,3 +27,8 @@ overview:
    inspect.rst
    annotationlib.rst
    site.rst
+
+.. seealso::
+
+   * See the :mod:`concurrent.interpreters` module, which similarly
+     exposes core runtime functionality.

Doc/whatsnew/3.14.rst

@@ -135,7 +135,7 @@ Each of these separate copies is called an "interpreter".
 However, the feature has been available only through the C-API.
 
 That limitation is removed in the 3.14 release,
-with the new :mod:`interpreters` module!
+with the new :mod:`concurrent.interpreters` module!
 
 There are at least two notable reasons why using multiple interpreters
 is worth considering:

Lib/interpreters/__init__.py Lib/concurrent/interpreters/__init__.pyLib/interpreters/__init__.py renamed to Lib/concurrent/interpreters/__init__.py

@@ -2,14 +2,14 @@
 
 import time
 import _interpchannels as _channels
-from interpreters import _crossinterp
+from concurrent.interpreters import _crossinterp
 
 # aliases:
 from _interpchannels import (
     ChannelError, ChannelNotFoundError, ChannelClosedError,  # noqa: F401
     ChannelEmptyError, ChannelNotEmptyError,  # noqa: F401
 )
-from interpreters._crossinterp import (
+from concurrent.interpreters._crossinterp import (
     UNBOUND_ERROR, UNBOUND_REMOVE,
 )