Add the _interpreters module to the stdlib.

python · ericsnowcurrently · Jan 30, 2018 · Dec 14, 2016 · Dec 29, 2016 · Jan 1, 2017
commit be93a283167187478ba215748f1ebb0d31dcfd14
diff --git a/Doc/library/_interpreters.rst b/Doc/library/_interpreters.rst
@@ -0,0 +1,37 @@
+:mod:`_interpreters` --- Low-level interpreters API
+===================================================
+
+.. module:: _interpreters
+   :synopsis: Low-level interpreters API.
+
+.. versionadded:: 3,7
+
+  :ref:`_sub-interpreter-support`
+
+threading
+
+--------------
+
+This module provides low-level primitives for working with multiple
+Python interpreters in the same process.
+
+.. XXX The :mod:`interpreters` module provides an easier to use and
+   higher-level API built on top of this module.
+
+This module is optional.  It is provided by Python implementations which
+support multiple interpreters.
+
+.. XXX For systems lacking the :mod:`_interpreters` module, the
+   :mod:`_dummy_interpreters` module is available.  It duplicates this
+   module's interface and can be used as a drop-in replacement.
+
+It defines the following functions:
+
+
+.. XXX TBD
+
+
+**Caveats:**
+
+* ...
+
diff --git a/Lib/test/test__interpreters.py b/Lib/test/test__interpreters.py
@@ -0,0 +1,11 @@
+import unittest
+from test import support
+interpreters = support.import_module('_interpreters')
+
+
+class InterpretersTests(unittest.TestCase):
+    pass
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/Modules/_interpretersmodule.c b/Modules/_interpretersmodule.c
@@ -0,0 +1,43 @@
+
+/* interpreters module */
+/* low-level access to interpreter primitives */
+
+#include "Python.h"
+
+
+static PyMethodDef module_functions[] = {
+    {NULL, NULL}           /* sentinel */
+};
+
+
+/* initialization function */
+
+PyDoc_STRVAR(module_doc,
+"This module provides primitive operations to manage Python interpreters.\n\
+The 'interpreters' module provides a more convenient interface.");
+
+static struct PyModuleDef interpretersmodule = {
+    PyModuleDef_HEAD_INIT,
+    "_interpreters",
+    module_doc,
+    -1,
+    module_functions,
+    NULL,
+    NULL,
+    NULL,
+    NULL
+};
+
+
+PyMODINIT_FUNC
+PyInit__interpreters(void)
+{
+    PyObject *module;
+
+    module = PyModule_Create(&interpretersmodule);
+    if (module == NULL)
+        return NULL;
+
+
+    return module;
+}
diff --git a/setup.py b/setup.py
@@ -745,6 +745,9 @@ def detect_modules(self):
             ['_xxtestfuzz/_xxtestfuzz.c', '_xxtestfuzz/fuzzer.c'])
         )
 
+        # Python interface to subinterpreter C-API.
+        exts.append(Extension('_interpreters', ['_interpretersmodule.c']))
+
         #
         # Here ends the simple stuff.  From here on, modules need certain
         # libraries, are platform-specific, or present other surprises.