Commit a93b848e authored by Guido van Rossum's avatar Guido van Rossum

Subsume the interact() function in a class. This should make it

possible to use this in PythonWin, and to replace Fredrik Lundh's
PythonInterpreter class.  Fredrik is credited with the class' API.
parent d9d2625d
"""Utilities dealing with code objects.""" """Utilities dealing with code objects."""
import sys
import string
import traceback
def compile_command(source, filename="<input>", symbol="single"): def compile_command(source, filename="<input>", symbol="single"):
r"""Compile a command and determine whether it is incomplete. r"""Compile a command and determine whether it is incomplete.
...@@ -60,51 +64,202 @@ def compile_command(source, filename="<input>", symbol="single"): ...@@ -60,51 +64,202 @@ def compile_command(source, filename="<input>", symbol="single"):
raise SyntaxError, err1 raise SyntaxError, err1
def interact(banner=None, readfunc=raw_input, local=None): class InteractiveConsole:
# Due to Jeff Epler, with changes by Guido: """Closely emulate the behavior of the interactive Python interpreter.
"""Closely emulate the interactive Python console."""
try: import readline # Enable GNU readline if available After code by Jeff Epler and Fredrik Lundh.
except: pass """
local = local or {}
import sys, string, traceback def __init__(self, filename="<console>", locals=None):
sys.ps1 = '>>> ' """Constructor.
sys.ps2 = '... '
if banner: The optional filename argument specifies the (file)name of the
print banner input stream; it will show up in tracebacks. It defaults to
else: '<console>'.
print "Python Interactive Console", sys.version
print sys.copyright """
buf = [] self.filename = filename
while 1: if locals is None:
if buf: prompt = sys.ps2 locals = {}
else: prompt = sys.ps1 self.locals = locals
try: line = readfunc(prompt) self.resetbuffer()
except KeyboardInterrupt:
print "\nKeyboardInterrupt" def resetbuffer(self):
buf = [] """Reset the input buffer (but not the variables!)."""
continue self.buffer = []
except EOFError: break
buf.append(line) def interact(self, banner=None):
try: x = compile_command(string.join(buf, "\n")) """Closely emulate the interactive Python console."""
try:
sys.ps1
except AttributeError:
sys.ps1 = ">>> "
try:
sys.ps2
except AttributeError:
sys.ps2 = "... "
if banner is None:
self.write("Python %s on %s\n%s\n(%s)\n" %
(sys.version, sys.platform, sys.copyright,
self.__class__.__name__))
else:
self.write("%s\n" % str(banner))
more = 0
while 1:
try:
if more:
prompt = sys.ps2
else:
prompt = sys.ps1
try:
line = self.raw_input(prompt)
except EOFError:
self.write("\n")
break
else:
more = self.push(line)
except KeyboardInterrupt:
self.write("\nKeyboardInterrupt\n")
self.resetbuffer()
more = 0
def push(self, line):
"""Push a line to the interpreter.
The line should not have a trailing newline.
One of three things will happen:
1) The input is incorrect; compile_command() raised
SyntaxError. A syntax traceback will be printed.
2) The input is incomplete, and more input is required;
compile_command() returned None.
3) The input is complete; compile_command() returned a code
object. The code is executed. When an exception occurs, a
traceback is printed. All exceptions are caught except
SystemExit, which is reraised.
The return value is 1 in case 2, 0 in the other cases. (The
return value can be used to decide whether to use sys.ps1 or
sys.ps2 to prompt the next line.)
A note about KeyboardInterrupt: this exception may occur
elsewhere in this code, and will not always be caught. The
caller should be prepared to deal with it.
"""
self.buffer.append(line)
try:
x = compile_command(string.join(self.buffer, "\n"),
filename=self.filename)
except SyntaxError: except SyntaxError:
traceback.print_exc(0) # Case 1
buf = [] self.showsyntaxerror()
continue self.resetbuffer()
if x == None: continue return 0
if x is None:
# Case 2
return 1
# Case 3
try:
exec x in self.locals
except SystemExit:
raise
except:
self.showtraceback()
self.resetbuffer()
return 0
def showsyntaxerror(self):
"""Display the syntax error that just occurred.
This doesn't display a stack trace because there isn't one.
The output is written by self.write(), below.
"""
type, value = sys.exc_info()[:2]
# Work hard to stuff the correct filename in the exception
try:
msg, (filename, lineno, offset, line) = value
except:
pass
else: else:
try: exec x in local try:
value = SyntaxError(msg, (self.filename, lineno, offset, line))
except: except:
exc_type, exc_value, exc_traceback = \ value = msg, (self.filename, lineno, offset, line)
sys.exc_type, sys.exc_value, \ list = traceback.format_exception_only(type, value)
sys.exc_traceback map(self.write, list)
l = len(traceback.extract_tb(sys.exc_traceback))
try: 1/0 def showtraceback(self):
except: """Display the exception that just occurred.
m = len(traceback.extract_tb(
sys.exc_traceback)) We remove the first stack item because it is our own code.
traceback.print_exception(exc_type,
exc_value, exc_traceback, l-m) The output is written by self.write(), below.
buf = []
"""
try:
type, value, tb = sys.exc_info()
tblist = traceback.extract_tb(tb)
del tblist[0]
list = traceback.format_list(tblist)
list[len(list):] = traceback.format_exception_only(type, value)
finally:
tblist = tb = None
map(self.write, list)
def write(self, data):
"""Write a string.
The base implementation writes to sys.stderr; a subclass may
replace this with a different implementation.
"""
sys.stderr.write(data)
def 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
raw_input(); a subclass may replace this with a different
implementation.
"""
return raw_input(prompt)
def interact(banner=None, readfunc=None, locals=None):
"""Closely emulate the interactive Python interpreter.
This is a backwards compatible interface to the InteractiveConsole
class. It attempts to import the readline module to enable GNU
readline if it is available.
Arguments (all optional, all default to None):
banner -- passed to InteractiveConsole.interact()
readfunc -- if not None, replaces InteractiveConsole.raw_input()
locals -- passed to InteractiveConsole.__init__()
"""
try:
import readline
except:
pass
console = InteractiveConsole(locals=locals)
if readfunc is not None:
console.raw_input = readfunc
console.interact(banner)
if __name__ == '__main__': if __name__ == '__main__':
interact() interact()
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment