Skip to content

bpo-30439: Add a basic high-level interpreters module. #1803

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

Closed
ericsnowcurrently wants to merge 20 commits into from
Closed

bpo-30439: Add a basic high-level interpreters module. #1803

Changes from 1 commit
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
7cc14ad
Add the _interpreters module to the stdlib.
ericsnowcurrently Dec 14, 2016
84920ad
Add create() and destroy().
ericsnowcurrently Dec 29, 2016
89f16ee
Finish nearly all the create/destroy tests.
ericsnowcurrently Jan 1, 2017
189a2fd
Add run_string().
ericsnowcurrently Dec 29, 2016
e144c96
Get tricky tests working.
ericsnowcurrently Jan 2, 2017
f3c7194
Add a test for a still running interpreter when main exits.
ericsnowcurrently Jan 2, 2017
2b7b6c7
Add run_string_unrestricted().
ericsnowcurrently Jan 4, 2017
8368582
Exit out of the child process.
ericsnowcurrently Jan 4, 2017
9669ca7
Resolve several TODOs.
ericsnowcurrently Jan 4, 2017
79edd9c
Set up the execution namespace before switching threads.
ericsnowcurrently Jan 4, 2017
17b0e28
Run in a copy of __main__.
ericsnowcurrently Jan 4, 2017
7d8f744
Close stdin and stdout after the proc finishes.
ericsnowcurrently Jan 4, 2017
80ab76a
Clean up a test.
ericsnowcurrently Jan 4, 2017
7afda96
Chain exceptions during cleanup.
ericsnowcurrently Jan 4, 2017
4e07f7a
Finish the module docs.
ericsnowcurrently Jan 4, 2017
060a720
Fix docs.
ericsnowcurrently May 23, 2017
a85df93
Add get_current() and enumerate().
ericsnowcurrently Dec 29, 2016
f605ae7
Add is_running().
ericsnowcurrently Dec 29, 2016
9704487
Add get_main().
ericsnowcurrently Jan 4, 2017
7dadbe5
Add the interpreters module.
ericsnowcurrently Jan 5, 2017
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
Prev Previous commit
Next Next commit
Finish the module docs.
  • Loading branch information
@ericsnowcurrently
ericsnowcurrently committed May 23, 2017
commit 4e07f7ab07b3667f429aa6b3fb18941030a489ed
36 changes: 20 additions & 16 deletions Doc/library/_interpreters.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,21 +6,30 @@

.. versionadded:: 3,7

:ref:`_sub-interpreter-support`

threading

--------------

This module provides low-level primitives for working with multiple
Python interpreters in the same process.

Python interpreters in the same runtime in the current process.
.. XXX The :mod:`interpreters` module provides an easier to use and
higher-level API built on top of this module.

More information about (sub)interpreters is found at
:ref:`_sub-interpreter-support`, including what data is shared between
interpreters and what is unique. Note particularly that interpreters
aren't inherently threaded, even though they track and manage Python
threads. To run code in an interpreter in a different OS thread, call
:func:`run_string` in a function that you run in a new Python thread.
For example::

id = _interpreters.create()
def f():
_interpreters.run_string(id, 'print("in a thread")')

t = threading.Thread(target=f)
t.start()

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.
Expand All @@ -42,9 +51,10 @@ It defines the following functions:
.. function:: run_string(id, command)

A wrapper around :c:func:`PyRun_SimpleString` which runs the provided
Python program using the identified interpreter. Providing an
invalid or unknown ID results in a RuntimeError, likewise if the main
interpreter or any other running interpreter is used.
Python program in the main thread of the identified interpreter.
Providing an invalid or unknown ID results in a RuntimeError,
likewise if the main interpreter or any other running interpreter
is used.

Any value returned from the code is thrown away, similar to what
threads do. If the code results in an exception then that exception
Expand All @@ -62,9 +72,3 @@ It defines the following functions:
merged into the execution namespace before execution. Note that
this allows objects to leak between interpreters, which may not
be desirable.


**Caveats:**

* ...