mpyc.__main__
index
github.com/lschoe/mpyc/blob/v0.10/mpyc/__main__.py

Support for natively asynchronous REPL with MPyC preloaded.
 
To launch a natively async REPL with MPyC preloaded, run:
 
    python -m mpyc
 
This causes Python's asyncio to be preloaded as well, allowing code with
top-level await expressions to be evaluated directly (instead of using
calls to mpc.run() or asyncio.run() in top-level code).
 
Besides setting mpc as a handle for the MPyC runtime, also several secure
(secret-shared) types are predefined, effectively executing the following code:
 
    from mpyc.runtime import mpc
    secint = mpc.SecInt()
    secfxp = mpc.SecFxp()
    secflt = mpc.SecFlt()
    secfld127 = mpc.SecFld(127)
    secfld256 = mpc.SecFld(2**8)
    secsym = mpc.SecSymmetricGroup(5)
    secqr = mpc.SecQuadraticResidues(11)
    secsg = mpc.SecSchnorrGroup(l=1024)
    secec = mpc.SecEllipticCurve('Ed25519')
    seccl = mpc.SecClassGroup(-23)
 
Type secint represents secure integers and types secfxp and secflt represent
secure fixed-point/floating-point numbers, all of default bit lengths. Types
secfld127 and secfld256 represent secure prime field GF(127)-elements and
secure binary field GF(2^8)-elements. Types secsym, secqr, secsg, secec, and
seccl represent secure finite group elements for five particular groups.
Other "popular" types etc. can easily be added here in the future.

 
Modules
       
ast
asyncio
code
concurrent
inspect
sys
threading
types
warnings

 
Classes
       
code.InteractiveConsole(code.InteractiveInterpreter)
AsyncIOInteractiveConsole
threading.Thread(builtins.object)
REPLThread

 
class AsyncIOInteractiveConsole(code.InteractiveConsole)
    AsyncIOInteractiveConsole(locals, loop=None)
 
Adapted from asyncio.__main__.AsyncIOInteractiveConsole with minor changes only.
 
 
Method resolution order:
AsyncIOInteractiveConsole
code.InteractiveConsole
code.InteractiveInterpreter
builtins.object

Methods defined here:
__init__(self, locals, loop=None)
Constructor.
 
The optional locals argument will be passed to the
InteractiveInterpreter base class.
 
The optional filename argument should specify the (file)name
of the input stream; it will show up in tracebacks.
runcode(self, code)
Execute a code object.
 
When an exception occurs, self.showtraceback() is called to
display a traceback.  All exceptions are caught except
SystemExit, which is reraised.
 
A note about KeyboardInterrupt: this exception may occur
elsewhere in this code, and may not always be caught.  The
caller should be prepared to deal with it.

Methods inherited from code.InteractiveConsole:
interact(self, banner=None, exitmsg=None)
Closely emulate the interactive Python console.
 
The optional banner argument specifies the banner to print
before the first interaction; by default it prints a banner
similar to the one printed by the real Python interpreter,
followed by the current class name in parentheses (so as not
to confuse this with the real interpreter -- since it's so
close!).
 
The optional exitmsg argument specifies the exit message
printed when exiting. Pass the empty string to suppress
printing an exit message. If exitmsg is not given or None,
a default message is printed.
push(self, line)
Push a line to the interpreter.
 
The line should not have a trailing newline; it may have
internal newlines.  The line is appended to a buffer and the
interpreter's runsource() method is called with the
concatenated contents of the buffer as source.  If this
indicates that the command was executed or invalid, the buffer
is reset; otherwise, the command is incomplete, and the buffer
is left as it was after the line was appended.  The return
value is 1 if more input is required, 0 if the line was dealt
with in some way (this is the same as runsource()).
raw_input(self, prompt='')
Write a prompt and read a line.
 
The returned line does not include the trailing newline.
When the user enters the EOF key sequence, EOFError is raised.
 
The base implementation uses the built-in function
input(); a subclass may replace this with a different
implementation.
resetbuffer(self)
Reset the input buffer.

Methods inherited from code.InteractiveInterpreter:
runsource(self, source, filename='<input>', symbol='single')
Compile and run some source in the interpreter.
 
Arguments are as for compile_command().
 
One of several things can happen:
 
1) The input is incorrect; compile_command() raised an
exception (SyntaxError or OverflowError).  A syntax traceback
will be printed by calling the showsyntaxerror() method.
 
2) The input is incomplete, and more input is required;
compile_command() returned None.  Nothing happens.
 
3) The input is complete; compile_command() returned a code
object.  The code is executed by calling self.runcode() (which
also handles run-time exceptions, except for SystemExit).
 
The return value is True in case 2, False in the other cases (unless
an exception is raised).  The return value can be used to
decide whether to use sys.ps1 or sys.ps2 to prompt the next
line.
showsyntaxerror(self, filename=None)
Display the syntax error that just occurred.
 
This doesn't display a stack trace because there isn't one.
 
If a filename is given, it is stuffed in the exception instead
of what was there before (because Python's parser always uses
"<string>" when reading from a string).
 
The output is written by self.write(), below.
showtraceback(self)
Display the exception that just occurred.
 
We remove the first stack item because it is our own code.
 
The output is written by self.write(), below.
write(self, data)
Write a string.
 
The base implementation writes to sys.stderr; a subclass may
replace this with a different implementation.

Data descriptors inherited from code.InteractiveInterpreter:
__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)

 
class REPLThread(threading.Thread)
    REPLThread(console, preamble=(), loop=None)
 
Adapted from asyncio.__main__.REPLThread, introducing a preamble for the asyncio REPL.
 
 
Method resolution order:
REPLThread
threading.Thread
builtins.object

Methods defined here:
__init__(self, console, preamble=(), loop=None)
This constructor should always be called with keyword arguments. Arguments are:
 
*group* should be None; reserved for future extension when a ThreadGroup
class is implemented.
 
*target* is the callable object to be invoked by the run()
method. Defaults to None, meaning nothing is called.
 
*name* is the thread name. By default, a unique name is constructed of
the form "Thread-N" where N is a small decimal number.
 
*args* is the argument tuple for the target invocation. Defaults to ().
 
*kwargs* is a dictionary of keyword arguments for the target
invocation. Defaults to {}.
 
If a subclass overrides the constructor, it must make sure to invoke
the base class constructor (Thread.__init__()) before doing anything
else to the thread.
run(self)
Method representing the thread's activity.
 
You may override this method in a subclass. The standard run() method
invokes the callable object passed to the object's constructor as the
target argument, if any, with sequential and keyword arguments taken
from the args and kwargs arguments, respectively.

Methods inherited from threading.Thread:
__repr__(self)
Return repr(self).
getName(self)
Return a string used for identification purposes only.
 
This method is deprecated, use the name attribute instead.
isDaemon(self)
Return whether this thread is a daemon.
 
This method is deprecated, use the daemon attribute instead.
is_alive(self)
Return whether the thread is alive.
 
This method returns True just before the run() method starts until just
after the run() method terminates. See also the module function
enumerate().
join(self, timeout=None)
Wait until the thread terminates.
 
This blocks the calling thread until the thread whose join() method is
called terminates -- either normally or through an unhandled exception
or until the optional timeout occurs.
 
When the timeout argument is present and not None, it should be a
floating point number specifying a timeout for the operation in seconds
(or fractions thereof). As join() always returns None, you must call
is_alive() after join() to decide whether a timeout happened -- if the
thread is still alive, the join() call timed out.
 
When the timeout argument is not present or None, the operation will
block until the thread terminates.
 
A thread can be join()ed many times.
 
join() raises a RuntimeError if an attempt is made to join the current
thread as that would cause a deadlock. It is also an error to join() a
thread before it has been started and attempts to do so raises the same
exception.
setDaemon(self, daemonic)
Set whether this thread is a daemon.
 
This method is deprecated, use the .daemon property instead.
setName(self, name)
Set the name string for this thread.
 
This method is deprecated, use the name attribute instead.
start(self)
Start the thread's activity.
 
It must be called at most once per thread object. It arranges for the
object's run() method to be invoked in a separate thread of control.
 
This method will raise a RuntimeError if called more than once on the
same thread object.

Readonly properties inherited from threading.Thread:
ident
Thread identifier of this thread or None if it has not been started.
 
This is a nonzero integer. See the get_ident() function. Thread
identifiers may be recycled when a thread exits and another thread is
created. The identifier is available even after the thread has exited.
native_id
Native integral thread ID of this thread, or None if it has not been started.
 
This is a non-negative integer. See the get_native_id() function.
This represents the Thread ID as reported by the kernel.

Data descriptors inherited from threading.Thread:
__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)
daemon
A boolean value indicating whether this thread is a daemon thread.
 
This must be set before start() is called, otherwise RuntimeError is
raised. Its initial value is inherited from the creating thread; the
main thread is not a daemon thread and therefore all threads created in
the main thread default to daemon = False.
 
The entire Python program exits when only daemon threads are left.
name
A string used for identification purposes only.
 
It has no semantics. Multiple threads may be given the same name. The
initial name is set by the constructor.

 
Functions
       
main(preamble=())
Adapted from the top-level code of the asyncio.__main__  module, no essential changes.