gajim-plural/src/ipython_view.py

628 lines
23 KiB
Python
Raw Normal View History

2008-04-14 17:19:09 +02:00
#!/usr/bin/python
# -*- coding:utf-8 -*-
## src/ipython_view.py
##
2014-01-02 09:33:54 +01:00
## Copyright (C) 2008-2014 Yann Leboulanger <asterix AT lagaule.org>
##
## This file is part of Gajim.
##
## Gajim is free software; you can redistribute it and/or modify
## it under the terms of the GNU General Public License as published
## by the Free Software Foundation; version 3 only.
##
## Gajim is distributed in the hope that it will be useful,
## but WITHOUT ANY WARRANTY; without even the implied warranty of
## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
## GNU General Public License for more details.
##
## You should have received a copy of the GNU General Public License
## along with Gajim. If not, see <http://www.gnu.org/licenses/>.
##
## Copyright (c) 2007, IBM Corporation
## All rights reserved.
## Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
## * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
## * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
## * Neither the name of the IBM Corporation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
## THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
2009-11-25 21:59:43 +01:00
"""
Provides IPython console widget
2008-04-14 17:19:09 +02:00
@author: Eitan Isaacson
@organization: IBM Corporation
@copyright: Copyright (c) 2007 IBM Corporation
@license: BSD
2008-12-03 22:56:12 +01:00
All rights reserved. This program and the accompanying materials are made
available under the terms of the BSD which accompanies this distribution, and
2008-04-14 17:19:09 +02:00
is available at U{http://www.opensource.org/licenses/bsd-license.php}
2009-11-25 21:59:43 +01:00
"""
2008-04-14 17:19:09 +02:00
from gi.repository import Gtk
from gi.repository import Gdk
from gi.repository import GObject
2013-07-29 18:35:49 +02:00
from gi.repository import GLib
2008-04-14 17:19:09 +02:00
import re
import sys
import os
from gi.repository import Pango
2008-04-14 17:19:09 +02:00
from StringIO import StringIO
try:
import IPython
2008-04-14 17:19:09 +02:00
except ImportError:
IPython = None
2008-04-14 17:19:09 +02:00
class IterableIPShell:
2009-11-25 21:59:43 +01:00
"""
Create an IPython instance. Does not start a blocking event loop,
instead allow single iterations. This allows embedding in GTK+
without blockage
@ivar IP: IPython instance.
@type IP: IPython.iplib.InteractiveShell
@ivar iter_more: Indicates if the line executed was a complete command,
or we should wait for more.
@type iter_more: integer
@ivar history_level: The place in history where we currently are
when pressing up/down.
@type history_level: integer
@ivar complete_sep: Seperation delimeters for completion function.
@type complete_sep: _sre.SRE_Pattern
"""
def __init__(self,argv=[],user_ns=None,user_global_ns=None, cin=None,
cout=None,cerr=None, input_func=None):
"""
@param argv: Command line options for IPython
@type argv: list
@param user_ns: User namespace.
@type user_ns: dictionary
@param user_global_ns: User global namespace.
@type user_global_ns: dictionary.
@param cin: Console standard input.
@type cin: IO stream
@param cout: Console standard output.
@type cout: IO stream
@param cerr: Console standard error.
@type cerr: IO stream
@param input_func: Replacement for builtin raw_input()
@type input_func: function
"""
2015-07-19 00:03:32 +02:00
io = IPython.utils.io
if input_func:
if IPython.version_info[0] >= 1:
IPython.terminal.interactiveshell.raw_input_original = input_func
else:
IPython.frontend.terminal.interactiveshell.raw_input_original = input_func
if cin:
2015-07-19 00:03:32 +02:00
io.stdin = io.IOStream(cin)
if cout:
2015-07-19 00:03:32 +02:00
io.stdout = io.IOStream(cout)
if cerr:
2015-07-19 00:03:32 +02:00
io.stderr = io.IOStream(cerr)
# This is to get rid of the blockage that accurs during
# IPython.Shell.InteractiveShell.user_setup()
2015-07-19 00:03:32 +02:00
io.raw_input = lambda x: None
os.environ['TERM'] = 'dumb'
excepthook = sys.excepthook
2012-03-17 19:28:48 +01:00
from IPython.config.loader import Config
cfg = Config()
cfg.InteractiveShell.colors = "Linux"
2015-07-19 00:03:32 +02:00
# InteractiveShell's __init__ overwrites io.stdout,io.stderr with
# sys.stdout, sys.stderr, this makes sure they are right
old_stdout, old_stderr = sys.stdout, sys.stderr
sys.stdout, sys.stderr = io.stdout.stream, io.stderr.stream
# InteractiveShell inherits from SingletonConfigurable so use instance()
if IPython.version_info[0] >= 1:
2015-07-19 00:03:32 +02:00
self.IP = IPython.terminal.embed.InteractiveShellEmbed.instance(config=cfg, user_ns=user_ns)
else:
2015-07-19 00:03:32 +02:00
self.IP = IPython.frontend.terminal.embed.InteractiveShellEmbed.instance(config=cfg, user_ns=user_ns)
sys.stdout, sys.stderr = old_stdout, old_stderr
self.IP.system = lambda cmd: self.shell(self.IP.var_expand(cmd),
header='IPython system call: ',
2012-03-17 19:28:48 +01:00
local_ns=user_ns)
#global_ns=user_global_ns)
#verbose=self.IP.rc.system_verbose)
self.IP.raw_input = input_func
sys.excepthook = excepthook
self.iter_more = 0
self.history_level = 0
self.complete_sep = re.compile('[\s\{\}\[\]\(\)]')
2012-03-17 19:28:48 +01:00
self.updateNamespace({'exit':lambda:None})
self.updateNamespace({'quit':lambda:None})
self.IP.readline_startup_hook(self.IP.pre_readline)
# Workaround for updating namespace with sys.modules
#
self.__update_namespace()
2012-03-17 19:28:48 +01:00
def __update_namespace(self):
'''
Update self.IP namespace for autocompletion with sys.modules
'''
for k,v in sys.modules.items():
if not '.' in k:
self.IP.user_ns.update({k:v})
def execute(self):
"""
Execute the current line provided by the shell object
"""
self.history_level = 0
orig_stdout = sys.stdout
2015-07-19 00:03:32 +02:00
sys.stdout = IPython.utils.io.stdout
2012-03-17 19:28:48 +01:00
orig_stdin = sys.stdin
sys.stdin = IPython.utils.io.stdin;
self.prompt = self.generatePrompt(self.iter_more)
self.IP.hooks.pre_prompt_hook()
if self.iter_more:
try:
self.prompt = self.generatePrompt(True)
except:
self.IP.showtraceback()
if self.IP.autoindent:
2012-03-17 19:28:48 +01:00
self.IP.rl_do_indent = True
try:
line = self.IP.raw_input(self.prompt)
except KeyboardInterrupt:
self.IP.write('\nKeyboardInterrupt\n')
2012-03-17 19:28:48 +01:00
self.IP.input_splitter.reset()
except:
self.IP.showtraceback()
else:
2012-03-17 19:28:48 +01:00
self.IP.input_splitter.push(line)
self.iter_more = self.IP.input_splitter.push_accepts_more()
self.prompt = self.generatePrompt(self.iter_more)
if (self.IP.SyntaxTB.last_syntax_error and
2012-03-17 19:28:48 +01:00
self.IP.autoedit_syntax):
self.IP.edit_syntax_error()
2012-03-17 19:28:48 +01:00
if not self.iter_more:
2015-07-19 00:03:32 +02:00
if IPython.version_info[0] >= 2:
source_raw = self.IP.input_splitter.raw_reset()
else:
source_raw = self.IP.input_splitter.source_raw_reset()[1]
2012-03-17 19:28:48 +01:00
self.IP.run_cell(source_raw, store_history=True)
2015-07-19 00:03:32 +02:00
self.IP.rl_do_indent = False
2012-03-17 19:28:48 +01:00
else:
# TODO: Auto-indent
#
2015-07-19 00:03:32 +02:00
self.IP.rl_do_indent = True
2012-03-17 19:28:48 +01:00
sys.stdout = orig_stdout
2012-03-17 19:28:48 +01:00
sys.stdin = orig_stdin
def generatePrompt(self, is_continuation):
'''
Generate prompt depending on is_continuation value
@param is_continuation
@type is_continuation: boolean
2012-03-17 19:28:48 +01:00
@return: The prompt string representation
@rtype: string
'''
# Backwards compatibility with ipyton-0.11
#
ver = IPython.__version__
if '0.11' in ver:
prompt = self.IP.hooks.generate_prompt(is_continuation)
else:
if is_continuation:
prompt = self.IP.prompt_manager.render('in2')
else:
prompt = self.IP.prompt_manager.render('in')
return prompt
def historyBack(self):
"""
Provide one history command back
2008-12-03 22:56:12 +01:00
@return: The command string.
@rtype: string
"""
self.history_level -= 1
return self._getHistory()
2008-12-03 22:56:12 +01:00
def historyForward(self):
"""
Provide one history command forward
2008-12-03 22:56:12 +01:00
@return: The command string.
@rtype: string
"""
self.history_level += 1
return self._getHistory()
2008-04-14 17:19:09 +02:00
def _getHistory(self):
"""
Get the command string of the current history level
2008-12-03 22:56:12 +01:00
@return: Historic command string.
@rtype: string
"""
try:
rv = self.IP.user_ns['In'][self.history_level].strip('\n')
except IndexError:
self.history_level = 0
rv = ''
return rv
def updateNamespace(self, ns_dict):
"""
Add the current dictionary to the shell namespace
2008-12-03 22:56:12 +01:00
@param ns_dict: A dictionary of symbol-values.
@type ns_dict: dictionary
"""
self.IP.user_ns.update(ns_dict)
2008-10-11 11:49:30 +02:00
def complete(self, line):
2009-11-25 21:59:43 +01:00
"""
Returns an auto completed line and/or posibilities for completion
2008-12-03 22:56:12 +01:00
@param line: Given line so far.
@type line: string
2008-04-14 17:19:09 +02:00
@return: Line completed as for as possible,
and possible further completions.
@rtype: tuple
"""
split_line = self.complete_sep.split(line)
2012-03-17 19:28:48 +01:00
if split_line[-1]:
possibilities = self.IP.complete(split_line[-1])
else:
completed = line
possibilities = ['',[]]
if possibilities:
2012-03-17 19:28:48 +01:00
def _commonPrefix(str1, str2):
'''
Reduction function. returns common prefix of two given strings.
@param str1: First string.
@type str1: string
@param str2: Second string
@type str2: string
@return: Common prefix to both strings.
@rtype: string
'''
for i in range(len(str1)):
if not str2.startswith(str1[:i+1]):
return str1[:i]
return str1
if possibilities[1]:
common_prefix = reduce(_commonPrefix, possibilities[1]) or line[-1]
completed = line[:-len(split_line[-1])]+common_prefix
else:
completed = line
else:
completed = line
2012-03-17 19:28:48 +01:00
return completed, possibilities[1]
def shell(self, cmd,verbose=0,debug=0,header=''):
"""
Replacement method to allow shell commands without them blocking
@param cmd: Shell command to execute.
@type cmd: string
@param verbose: Verbosity
@type verbose: integer
@param debug: Debug level
@type debug: integer
@param header: Header to be printed before output
@type header: string
"""
2013-01-01 19:36:56 +01:00
if verbose or debug: print(header+cmd)
# flush stdout so we don't mangle python's buffering
if not debug:
input_, output = os.popen4(cmd)
2013-01-01 19:36:56 +01:00
print(output.read())
output.close()
input_.close()
2008-04-14 17:19:09 +02:00
class ConsoleView(Gtk.TextView):
2009-11-25 21:59:43 +01:00
"""
Specialized text view for console-like workflow
2008-12-03 22:56:12 +01:00
@cvar ANSI_COLORS: Mapping of terminal colors to X11 names.
@type ANSI_COLORS: dictionary
2008-12-03 22:56:12 +01:00
@ivar text_buffer: Widget's text buffer.
@type text_buffer: Gtk.TextBuffer
@ivar color_pat: Regex of terminal color pattern
@type color_pat: _sre.SRE_Pattern
@ivar mark: Scroll mark for automatic scrolling on input.
@type mark: Gtk.TextMark
@ivar line_start: Start of command line mark.
@type line_start: Gtk.TextMark
2009-11-25 21:59:43 +01:00
"""
2008-04-14 17:19:09 +02:00
ANSI_COLORS = {'0;30': 'Black', '0;31': 'Red',
'0;32': 'Green', '0;33': 'Brown',
'0;34': 'Blue', '0;35': 'Purple',
'0;36': 'Cyan', '0;37': 'LightGray',
'1;30': 'DarkGray', '1;31': 'DarkRed',
'1;32': 'SeaGreen', '1;33': 'Yellow',
'1;34': 'LightBlue', '1;35': 'MediumPurple',
'1;36': 'LightCyan', '1;37': 'White'}
2008-04-14 17:19:09 +02:00
def __init__(self):
"""
Initialize console view
"""
GObject.GObject.__init__(self)
2013-07-31 16:40:33 +02:00
self.override_font(Pango.FontDescription('Mono'))
self.set_cursor_visible(True)
self.text_buffer = self.get_buffer()
self.mark = self.text_buffer.create_mark('scroll_mark',
self.text_buffer.get_end_iter(),
False)
for code in self.ANSI_COLORS:
self.text_buffer.create_tag(code,
foreground=self.ANSI_COLORS[code],
weight=700)
self.text_buffer.create_tag('0')
self.text_buffer.create_tag('notouch', editable=False)
self.color_pat = re.compile('\x01?\x1b\[(.*?)m\x02?')
self.line_start = \
self.text_buffer.create_mark('line_start',
self.text_buffer.get_end_iter(), True)
self.connect('key-press-event', self.onKeyPress)
def write(self, text, editable=False):
2013-07-29 18:35:49 +02:00
GLib.idle_add(self._write, text, editable)
def _write(self, text, editable=False):
"""
Write given text to buffer
2008-12-03 22:56:12 +01:00
@param text: Text to append.
@type text: string
@param editable: If true, added text is editable.
@type editable: boolean
"""
segments = self.color_pat.split(text)
segment = segments.pop(0)
start_mark = self.text_buffer.create_mark(None,
self.text_buffer.get_end_iter(),
True)
self.text_buffer.insert(self.text_buffer.get_end_iter(), segment)
if segments:
ansi_tags = self.color_pat.findall(text)
for tag in ansi_tags:
i = segments.index(tag)
self.text_buffer.insert_with_tags_by_name(self.text_buffer.get_end_iter(),
2012-03-17 19:28:48 +01:00
segments[i+1], str(tag))
segments.pop(i)
if not editable:
self.text_buffer.apply_tag_by_name('notouch',
self.text_buffer.get_iter_at_mark(start_mark),
self.text_buffer.get_end_iter())
self.text_buffer.delete_mark(start_mark)
self.scroll_mark_onscreen(self.mark)
def showPrompt(self, prompt):
2013-07-29 18:35:49 +02:00
GLib.idle_add(self._showPrompt, prompt)
def _showPrompt(self, prompt):
"""
Print prompt at start of line
2008-04-14 17:19:09 +02:00
@param prompt: Prompt to print.
@type prompt: string
"""
self._write(prompt)
self.text_buffer.move_mark(self.line_start,
self.text_buffer.get_end_iter())
2008-12-03 22:56:12 +01:00
def changeLine(self, text):
2013-07-29 18:35:49 +02:00
GLib.idle_add(self._changeLine, text)
2008-04-14 17:19:09 +02:00
def _changeLine(self, text):
"""
Replace currently entered command line with given text
2008-04-14 17:19:09 +02:00
@param text: Text to use as replacement.
@type text: string
"""
iter_ = self.text_buffer.get_iter_at_mark(self.line_start)
iter_.forward_to_line_end()
self.text_buffer.delete(self.text_buffer.get_iter_at_mark(self.line_start), iter_)
self._write(text, True)
2009-06-15 21:00:14 +02:00
def getCurrentLine(self):
"""
Get text in current command line
2008-12-03 22:56:12 +01:00
@return: Text of current command line.
@rtype: string
"""
rv = self.text_buffer.get_slice(
self.text_buffer.get_iter_at_mark(self.line_start),
self.text_buffer.get_end_iter(), False)
return rv
2008-12-03 22:56:12 +01:00
def showReturned(self, text):
2013-07-29 18:35:49 +02:00
GLib.idle_add(self._showReturned, text)
def _showReturned(self, text):
"""
Show returned text from last command and print new prompt
@param text: Text to show.
@type text: string
"""
iter_ = self.text_buffer.get_iter_at_mark(self.line_start)
iter_.forward_to_line_end()
self.text_buffer.apply_tag_by_name(
'notouch',
self.text_buffer.get_iter_at_mark(self.line_start),
iter_)
self._write('\n'+text)
if text:
self._write('\n')
self._showPrompt(self.prompt)
self.text_buffer.move_mark(self.line_start, self.text_buffer.get_end_iter())
self.text_buffer.place_cursor(self.text_buffer.get_end_iter())
2015-07-19 00:03:32 +02:00
if self.IP.rl_do_indent:
indentation = self.IP.input_splitter.indent_spaces * ' '
self.text_buffer.insert_at_cursor(indentation)
def onKeyPress(self, widget, event):
"""
Key press callback used for correcting behavior for console-like
interfaces. For example 'home' should go to prompt, not to begining of
line
@param widget: Widget that key press accored in.
@type widget: Gtk.Widget
@param event: Event object
@type event: Gdk.Event
@return: Return True if event should not trickle.
@rtype: boolean
"""
insert_mark = self.text_buffer.get_insert()
insert_iter = self.text_buffer.get_iter_at_mark(insert_mark)
selection_mark = self.text_buffer.get_selection_bound()
selection_iter = self.text_buffer.get_iter_at_mark(selection_mark)
start_iter = self.text_buffer.get_iter_at_mark(self.line_start)
if event.keyval == Gdk.KEY_Home:
if event.get_state() == 0:
self.text_buffer.place_cursor(start_iter)
return True
elif event.get_state() == Gdk.ModifierType.SHIFT_MASK:
self.text_buffer.move_mark(insert_mark, start_iter)
return True
elif event.keyval == Gdk.KEY_Left:
insert_iter.backward_cursor_position()
if not insert_iter.editable(True):
return True
elif not event.string:
pass
elif start_iter.compare(insert_iter) <= 0 and \
start_iter.compare(selection_iter) <= 0:
pass
elif start_iter.compare(insert_iter) > 0 and \
start_iter.compare(selection_iter) > 0:
self.text_buffer.place_cursor(start_iter)
elif insert_iter.compare(selection_iter) < 0:
self.text_buffer.move_mark(insert_mark, start_iter)
elif insert_iter.compare(selection_iter) > 0:
self.text_buffer.move_mark(selection_mark, start_iter)
return self.onKeyPressExtend(event)
def onKeyPressExtend(self, event):
"""
For some reason we can't extend onKeyPress directly (bug #500900)
"""
pass
2008-04-14 17:19:09 +02:00
class IPythonView(ConsoleView, IterableIPShell):
'''
Sub-class of both modified IPython shell and L{ConsoleView} this makes
a GTK+ IPython console.
'''
def __init__(self):
"""
Initialize. Redirect I/O to console
"""
ConsoleView.__init__(self)
self.cout = StringIO()
IterableIPShell.__init__(self, cout=self.cout, cerr=self.cout,
input_func=self.raw_input)
2008-04-14 17:19:09 +02:00
# self.connect('key_press_event', self.keyPress)
2015-07-19 00:03:32 +02:00
self.interrupt = False
self.execute()
2012-03-17 19:28:48 +01:00
self.prompt = self.generatePrompt(False)
self.cout.truncate(0)
self.showPrompt(self.prompt)
2008-04-14 17:19:09 +02:00
def raw_input(self, prompt=''):
"""
Custom raw_input() replacement. Get's current line from console buffer
2008-12-03 22:56:12 +01:00
@param prompt: Prompt to print. Here for compatability as replacement.
@type prompt: string
2008-12-03 22:56:12 +01:00
@return: The current command line text.
@rtype: string
"""
if self.interrupt:
self.interrupt = False
raise KeyboardInterrupt
return self.getCurrentLine()
2008-04-14 17:19:09 +02:00
def onKeyPressExtend(self, event):
"""
Key press callback with plenty of shell goodness, like history,
autocompletions, etc
2008-12-03 22:56:12 +01:00
@param widget: Widget that key press occured in.
@type widget: Gtk.Widget
@param event: Event object.
@type event: Gdk.Event
2008-12-03 22:56:12 +01:00
@return: True if event should not trickle.
@rtype: boolean
"""
if event.get_state() & Gdk.ModifierType.CONTROL_MASK and event.keyval == 99:
self.interrupt = True
self._processLine()
return True
elif event.keyval == Gdk.KEY_Return:
self._processLine()
return True
elif event.keyval == Gdk.KEY_Up:
self.changeLine(self.historyBack())
return True
elif event.keyval == Gdk.KEY_Down:
self.changeLine(self.historyForward())
return True
elif event.keyval == Gdk.KEY_Tab:
if not self.getCurrentLine().strip():
return False
completed, possibilities = self.complete(self.getCurrentLine())
if len(possibilities) > 1:
slice_ = self.getCurrentLine()
self.write('\n')
for symbol in possibilities:
self.write(symbol+'\n')
self.showPrompt(self.prompt)
self.changeLine(completed or slice_)
return True
2008-12-03 22:56:12 +01:00
def _processLine(self):
"""
Process current command line
"""
self.history_pos = 0
self.execute()
rv = self.cout.getvalue()
if rv: rv = rv.strip('\n')
self.showReturned(rv)
self.cout.truncate(0)
2015-07-19 00:03:32 +02:00
self.cout.seek(0)