The input object can now be passed to the constructor of ibrowse/igrid.

This makes it possible to use them with objects that implement __or__.

IPython/Extensions/ibrowse.py

@@ -1,1765 +1,1769 b''
 # -*- coding: iso-8859-1 -*-
 
 import curses, fcntl, signal, struct, tty, textwrap, inspect
 
 from IPython import ipapi
 
 import astyle, ipipe
 
 
 # Python 2.3 compatibility
 try:
     set
 except NameError:
     import sets
     set = sets.Set
 
 # Python 2.3 compatibility
 try:
     sorted
 except NameError:
     from ipipe import sorted
 
 
 class UnassignedKeyError(Exception):
     """
     Exception that is used for reporting unassigned keys.
     """
 
 
 class UnknownCommandError(Exception):
     """
     Exception that is used for reporting unknown commands (this should never
     happen).
     """
 
 
 class CommandError(Exception):
     """
     Exception that is used for reporting that a command can't be executed.
     """
 
 
 class Keymap(dict):
     """
     Stores mapping of keys to commands.
     """
     def __init__(self):
         self._keymap = {}
 
     def __setitem__(self, key, command):
         if isinstance(key, str):
             for c in key:
                 dict.__setitem__(self, ord(c), command)
         else:
             dict.__setitem__(self, key, command)
 
     def __getitem__(self, key):
         if isinstance(key, str):
             key = ord(key)
         return dict.__getitem__(self, key)
 
     def __detitem__(self, key):
         if isinstance(key, str):
             key = ord(key)
         dict.__detitem__(self, key)
 
     def register(self, command, *keys):
         for key in keys:
             self[key] = command
 
     def get(self, key, default=None):
         if isinstance(key, str):
             key = ord(key)
         return dict.get(self, key, default)
 
     def findkey(self, command, default=ipipe.noitem):
         for (key, commandcandidate) in self.iteritems():
             if commandcandidate == command:
                 return key
         if default is ipipe.noitem:
             raise KeyError(command)
         return default
 
 
 class _BrowserCachedItem(object):
     # This is used internally by ``ibrowse`` to store a item together with its
     # marked status.
     __slots__ = ("item", "marked")
 
     def __init__(self, item):
         self.item = item
         self.marked = False
 
 
 class _BrowserHelp(object):
     style_header = astyle.Style.fromstr("yellow:black:bold")
     # This is used internally by ``ibrowse`` for displaying the help screen.
     def __init__(self, browser):
         self.browser = browser
 
     def __xrepr__(self, mode):
         yield (-1, True)
         if mode == "header" or mode == "footer":
             yield (astyle.style_default, "ibrowse help screen")
         else:
             yield (astyle.style_default, repr(self))
 
     def __iter__(self):
         # Get reverse key mapping
         allkeys = {}
         for (key, cmd) in self.browser.keymap.iteritems():
             allkeys.setdefault(cmd, []).append(key)
 
         fields = ("key", "description")
 
         commands = []
         for name in dir(self.browser):
             if name.startswith("cmd_"):
                 command = getattr(self.browser, name)
                 commands.append((inspect.getsourcelines(command)[-1], name[4:], command))
         commands.sort()
         commands = [(c[1], c[2]) for c in commands]
         for (i, (name, command)) in enumerate(commands):
             if i:
                 yield ipipe.Fields(fields, key="", description="")
 
             description = command.__doc__
             if description is None:
                 lines = []
             else:
                 lines = [l.strip() for l in description.splitlines() if l.strip()]
                 description = "\n".join(lines)
                 lines = textwrap.wrap(description, 60)
             keys = allkeys.get(name, [])
 
             yield ipipe.Fields(fields, key="", description=astyle.Text((self.style_header, name)))
             for i in xrange(max(len(keys), len(lines))):
                 try:
                     key = self.browser.keylabel(keys[i])
                 except IndexError:
                     key = ""
                 try:
                     line = lines[i]
                 except IndexError:
                     line = ""
                 yield ipipe.Fields(fields, key=key, description=line)
 
 
 class _BrowserLevel(object):
     # This is used internally to store the state (iterator, fetch items,
     # position of cursor and screen, etc.) of one browser level
     # An ``ibrowse`` object keeps multiple ``_BrowserLevel`` objects in
     # a stack.
     def __init__(self, browser, input, mainsizey, *attrs):
         self.browser = browser
         self.input = input
         self.header = [x for x in ipipe.xrepr(input, "header") if not isinstance(x[0], int)]
         # iterator for the input
         self.iterator = ipipe.xiter(input)
 
         # is the iterator exhausted?
         self.exhausted = False
 
         # attributes to be display (autodetected if empty)
         self.attrs = attrs
 
         # fetched items (+ marked flag)
         self.items = ipipe.deque()
 
         # Number of marked objects
         self.marked = 0
 
         # Vertical cursor position
         self.cury = 0
 
         # Horizontal cursor position
         self.curx = 0
 
         # Index of first data column
         self.datastartx = 0
 
         # Index of first data line
         self.datastarty = 0
 
         # height of the data display area
         self.mainsizey = mainsizey
 
         # width of the data display area (changes when scrolling)
         self.mainsizex = 0
 
         # Size of row number (changes when scrolling)
         self.numbersizex = 0
 
         # Attributes to display (in this order)
         self.displayattrs = []
 
         # index and attribute under the cursor
         self.displayattr = (None, ipipe.noitem)
 
         # Maps attributes to column widths
         self.colwidths = {}
 
         # Set of hidden attributes
         self.hiddenattrs = set()
 
         # This takes care of all the caches etc.
         self.moveto(0, 0, refresh=True)
 
     def fetch(self, count):
         # Try to fill ``self.items`` with at least ``count`` objects.
         have = len(self.items)
         while not self.exhausted and have < count:
             try:
                 item = self.iterator.next()
             except StopIteration:
                 self.exhausted = True
                 break
             except (KeyboardInterrupt, SystemExit):
                 raise
             except Exception, exc:
                 have += 1
                 self.items.append(_BrowserCachedItem(exc))
                 self.exhausted = True
                 break
             else:
                 have += 1
                 self.items.append(_BrowserCachedItem(item))
 
     def calcdisplayattrs(self):
         # Calculate which attributes are available from the objects that are
         # currently visible on screen (and store it in ``self.displayattrs``)
 
         attrs = set()
         self.displayattrs = []
         if self.attrs:
             # If the browser object specifies a fixed list of attributes,
             # simply use it (removing hidden attributes).
             for attr in self.attrs:
                 attr = ipipe.upgradexattr(attr)
                 if attr not in attrs and attr not in self.hiddenattrs:
                     self.displayattrs.append(attr)
                     attrs.add(attr)
         else:
             endy = min(self.datastarty+self.mainsizey, len(self.items))
             for i in xrange(self.datastarty, endy):
                 for attr in ipipe.xattrs(self.items[i].item, "default"):
                     if attr not in attrs and attr not in self.hiddenattrs:
                         self.displayattrs.append(attr)
                         attrs.add(attr)
 
     def getrow(self, i):
         # Return a dictionary with the attributes for the object
         # ``self.items[i]``. Attribute names are taken from
         # ``self.displayattrs`` so ``calcdisplayattrs()`` must have been
         # called before.
         row = {}
         item = self.items[i].item
         for attr in self.displayattrs:
             try:
                 value = attr.value(item)
             except (KeyboardInterrupt, SystemExit):
                 raise
             except Exception, exc:
                 value = exc
             # only store attribute if it exists (or we got an exception)
             if value is not ipipe.noitem:
                 # remember alignment, length and colored text
                 row[attr] = ipipe.xformat(value, "cell", self.browser.maxattrlength)
         return row
 
     def calcwidths(self):
         # Recalculate the displayed fields and their widths.
         # ``calcdisplayattrs()'' must have been called and the cache
         # for attributes of the objects on screen (``self.displayrows``)
         # must have been filled. This sets ``self.colwidths`` which maps
         # attribute descriptors to widths.
         self.colwidths = {}
         for row in self.displayrows:
             for attr in self.displayattrs:
                 try:
                     length = row[attr][1]
                 except KeyError:
                     length = 0
                 # always add attribute to colwidths, even if it doesn't exist
                 if attr not in self.colwidths:
                     self.colwidths[attr] = len(attr.name())
                 newwidth = max(self.colwidths[attr], length)
                 self.colwidths[attr] = newwidth
 
         # How many characters do we need to paint the largest item number?
         self.numbersizex = len(str(self.datastarty+self.mainsizey-1))
         # How must space have we got to display data?
         self.mainsizex = self.browser.scrsizex-self.numbersizex-3
         # width of all columns
         self.datasizex = sum(self.colwidths.itervalues()) + len(self.colwidths)
 
     def calcdisplayattr(self):
         # Find out which attribute the cursor is on and store this
         # information in ``self.displayattr``.
         pos = 0
         for (i, attr) in enumerate(self.displayattrs):
             if pos+self.colwidths[attr] >= self.curx:
                 self.displayattr = (i, attr)
                 break
             pos += self.colwidths[attr]+1
         else:
             self.displayattr = (None, ipipe.noitem)
 
     def moveto(self, x, y, refresh=False):
         # Move the cursor to the position ``(x,y)`` (in data coordinates,
         # not in screen coordinates). If ``refresh`` is true, all cached
         # values will be recalculated (e.g. because the list has been
         # resorted, so screen positions etc. are no longer valid).
         olddatastarty = self.datastarty
         oldx = self.curx
         oldy = self.cury
         x = int(x+0.5)
         y = int(y+0.5)
         newx = x # remember where we wanted to move
         newy = y # remember where we wanted to move
 
         scrollbordery = min(self.browser.scrollbordery, self.mainsizey//2)
         scrollborderx = min(self.browser.scrollborderx, self.mainsizex//2)
 
         # Make sure that the cursor didn't leave the main area vertically
         if y < 0:
             y = 0
         # try to get enough items to fill the screen
         self.fetch(max(y+scrollbordery+1, self.mainsizey))
         if y >= len(self.items):
             y = max(0, len(self.items)-1)
 
         # Make sure that the cursor stays on screen vertically
         if y < self.datastarty+scrollbordery:
             self.datastarty = max(0, y-scrollbordery)
         elif y >= self.datastarty+self.mainsizey-scrollbordery:
             self.datastarty = max(0, min(y-self.mainsizey+scrollbordery+1,
                                          len(self.items)-self.mainsizey))
 
         if refresh: # Do we need to refresh the complete display?
             self.calcdisplayattrs()
             endy = min(self.datastarty+self.mainsizey, len(self.items))
             self.displayrows = map(self.getrow, xrange(self.datastarty, endy))
             self.calcwidths()
         # Did we scroll vertically => update displayrows
         # and various other attributes
         elif self.datastarty != olddatastarty:
             # Recalculate which attributes we have to display
             olddisplayattrs = self.displayattrs
             self.calcdisplayattrs()
             # If there are new attributes, recreate the cache
             if self.displayattrs != olddisplayattrs:
                 endy = min(self.datastarty+self.mainsizey, len(self.items))
                 self.displayrows = map(self.getrow, xrange(self.datastarty, endy))
             elif self.datastarty<olddatastarty: # we did scroll up
                 # drop rows from the end
                 del self.displayrows[self.datastarty-olddatastarty:]
                 # fetch new items
                 for i in xrange(min(olddatastarty, self.datastarty+self.mainsizey)-1,
                                 self.datastarty-1, -1):
                     try:
                         row = self.getrow(i)
                     except IndexError:
                         # we didn't have enough objects to fill the screen
                         break
                     self.displayrows.insert(0, row)
             else: # we did scroll down
                 # drop rows from the start
                 del self.displayrows[:self.datastarty-olddatastarty]
                 # fetch new items
                 for i in xrange(max(olddatastarty+self.mainsizey, self.datastarty),
                                 self.datastarty+self.mainsizey):
                     try:
                         row = self.getrow(i)
                     except IndexError:
                         # we didn't have enough objects to fill the screen
                         break
                     self.displayrows.append(row)
             self.calcwidths()
 
         # Make sure that the cursor didn't leave the data area horizontally
         if x < 0:
             x = 0
         elif x >= self.datasizex:
             x = max(0, self.datasizex-1)
 
         # Make sure that the cursor stays on screen horizontally
         if x < self.datastartx+scrollborderx:
             self.datastartx = max(0, x-scrollborderx)
         elif x >= self.datastartx+self.mainsizex-scrollborderx:
             self.datastartx = max(0, min(x-self.mainsizex+scrollborderx+1,
                                          self.datasizex-self.mainsizex))
 
         if x == oldx and y == oldy and (x != newx or y != newy): # couldn't move
             self.browser.beep()
         else:
             self.curx = x
             self.cury = y
             self.calcdisplayattr()
 
     def sort(self, key, reverse=False):
         """
         Sort the currently list of items using the key function ``key``. If
         ``reverse`` is true the sort order is reversed.
         """
         curitem = self.items[self.cury] # Remember where the cursor is now
 
         # Sort items
         def realkey(item):
             return key(item.item)
         self.items = ipipe.deque(sorted(self.items, key=realkey, reverse=reverse))
 
         # Find out where the object under the cursor went
         cury = self.cury
         for (i, item) in enumerate(self.items):
             if item is curitem:
                 cury = i
                 break
 
         self.moveto(self.curx, cury, refresh=True)
 
     def refresh(self):
         """
         Restart iterating the input.
         """
         self.iterator = ipipe.xiter(self.input)
         self.items.clear()
         self.exhausted = False
         self.datastartx = self.datastarty = 0
         self.moveto(0, 0, refresh=True)
 
     def refreshfind(self):
         """
         Restart iterating the input and go back to the same object as before
         (if it can be found in the new iterator).
         """
         try:
             oldobject = self.items[self.cury].item
         except IndexError:
             oldobject = ipipe.noitem
         self.iterator = ipipe.xiter(self.input)
         self.items.clear()
         self.exhausted = False
         while True:
             self.fetch(len(self.items)+1)
             if self.exhausted:
                 curses.beep()
                 self.datastartx = self.datastarty = 0
                 self.moveto(self.curx, 0, refresh=True)
                 break
             if self.items[-1].item == oldobject:
                 self.datastartx = self.datastarty = 0
                 self.moveto(self.curx, len(self.items)-1, refresh=True)
                 break
 
 
 class _CommandInput(object):
     keymap = Keymap()
     keymap.register("left", curses.KEY_LEFT)
     keymap.register("right", curses.KEY_RIGHT)
     keymap.register("home", curses.KEY_HOME, "\x01") # Ctrl-A
     keymap.register("end", curses.KEY_END, "\x05") # Ctrl-E
     # FIXME: What's happening here?
     keymap.register("backspace", curses.KEY_BACKSPACE, "\x08\x7f")
     keymap.register("delete", curses.KEY_DC)
     keymap.register("delend", 0x0b) # Ctrl-K
     keymap.register("execute", "\r\n")
     keymap.register("up", curses.KEY_UP)
     keymap.register("down", curses.KEY_DOWN)
     keymap.register("incsearchup", curses.KEY_PPAGE)
     keymap.register("incsearchdown", curses.KEY_NPAGE)
     keymap.register("exit", "\x18"), # Ctrl-X
 
     def __init__(self, prompt):
         self.prompt = prompt
         self.history = []
         self.maxhistory = 100
         self.input = ""
         self.curx = 0
         self.cury = -1 # blank line
 
     def start(self):
         self.input = ""
         self.curx = 0
         self.cury = -1 # blank line
 
     def handlekey(self, browser, key):
         cmdname = self.keymap.get(key, None)
         if cmdname is not None:
             cmdfunc = getattr(self, "cmd_%s" % cmdname, None)
             if cmdfunc is not None:
                 return cmdfunc(browser)
             curses.beep()
         elif key != -1:
             try:
                 char = chr(key)
             except ValueError:
                 curses.beep()
             else:
                 return self.handlechar(browser, char)
 
     def handlechar(self, browser, char):
         self.input = self.input[:self.curx] + char + self.input[self.curx:]
         self.curx += 1
         return True
 
     def dohistory(self):
         self.history.insert(0, self.input)
         del self.history[:-self.maxhistory]
 
     def cmd_backspace(self, browser):
         if self.curx:
             self.input = self.input[:self.curx-1] + self.input[self.curx:]
             self.curx -= 1
             return True
         else:
             curses.beep()
 
     def cmd_delete(self, browser):
         if self.curx<len(self.input):
             self.input = self.input[:self.curx] + self.input[self.curx+1:]
             return True
         else:
             curses.beep()
 
     def cmd_delend(self, browser):
         if self.curx<len(self.input):
             self.input = self.input[:self.curx]
             return True
 
     def cmd_left(self, browser):
         if self.curx:
             self.curx -= 1
             return True
         else:
             curses.beep()
 
     def cmd_right(self, browser):
         if self.curx < len(self.input):
             self.curx += 1
             return True
         else:
             curses.beep()
 
     def cmd_home(self, browser):
         if self.curx:
             self.curx = 0
             return True
         else:
             curses.beep()
 
     def cmd_end(self, browser):
         if self.curx < len(self.input):
             self.curx = len(self.input)
             return True
         else:
             curses.beep()
 
     def cmd_up(self, browser):
         if self.cury < len(self.history)-1:
             self.cury += 1
             self.input = self.history[self.cury]
             self.curx = len(self.input)
             return True
         else:
             curses.beep()
 
     def cmd_down(self, browser):
         if self.cury >= 0:
             self.cury -= 1
             if self.cury>=0:
                 self.input = self.history[self.cury]
             else:
                 self.input = ""
             self.curx = len(self.input)
             return True
         else:
             curses.beep()
 
     def cmd_incsearchup(self, browser):
         prefix = self.input[:self.curx]
         cury = self.cury
         while True:
             cury += 1
             if cury >= len(self.history):
                 break
             if self.history[cury].startswith(prefix):
                 self.input = self.history[cury]
                 self.cury = cury
                 return True
         curses.beep()
 
     def cmd_incsearchdown(self, browser):
         prefix = self.input[:self.curx]
         cury = self.cury
         while True:
             cury -= 1
             if cury <= 0:
                 break
             if self.history[cury].startswith(prefix):
                 self.input = self.history[self.cury]
                 self.cury = cury
                 return True
         curses.beep()
 
     def cmd_exit(self, browser):
         browser.mode = "default"
         return True
 
     def cmd_execute(self, browser):
         raise NotImplementedError
 
 
 class _CommandGoto(_CommandInput):
     def __init__(self):
         _CommandInput.__init__(self, "goto object #")
 
     def handlechar(self, browser, char):
         # Only accept digits
         if not "0" <= char <= "9":
             curses.beep()
         else:
             return _CommandInput.handlechar(self, browser, char)
 
     def cmd_execute(self, browser):
         level = browser.levels[-1]
         if self.input:
             self.dohistory()
             level.moveto(level.curx, int(self.input))
         browser.mode = "default"
         return True
 
 
 class _CommandFind(_CommandInput):
     def __init__(self):
         _CommandInput.__init__(self, "find expression")
 
     def cmd_execute(self, browser):
         level = browser.levels[-1]
         if self.input:
             self.dohistory()
             while True:
                 cury = level.cury
                 level.moveto(level.curx, cury+1)
                 if cury == level.cury:
                     curses.beep()
                     break # hit end
                 item = level.items[level.cury].item
                 try:
                     globals = ipipe.getglobals(None)
                     if eval(self.input, globals, ipipe.AttrNamespace(item)):
                         break # found something
                 except (KeyboardInterrupt, SystemExit):
                     raise
                 except Exception, exc:
                     browser.report(exc)
                     curses.beep()
                     break  # break on error
         browser.mode = "default"
         return True
 
 
 class _CommandFindBackwards(_CommandInput):
     def __init__(self):
         _CommandInput.__init__(self, "find backwards expression")
 
     def cmd_execute(self, browser):
         level = browser.levels[-1]
         if self.input:
             self.dohistory()
             while level.cury:
                 level.moveto(level.curx, level.cury-1)
                 item = level.items[level.cury].item
                 try:
                     globals = ipipe.getglobals(None)
                     if eval(self.input, globals, ipipe.AttrNamespace(item)):
                         break # found something
                 except (KeyboardInterrupt, SystemExit):
                     raise
                 except Exception, exc:
                     browser.report(exc)
                     curses.beep()
                     break # break on error
             else:
                 curses.beep()
         browser.mode = "default"
         return True
 
 
 class ibrowse(ipipe.Display):
     # Show this many lines from the previous screen when paging horizontally
     pageoverlapx = 1
 
     # Show this many lines from the previous screen when paging vertically
     pageoverlapy = 1
 
     # Start scrolling when the cursor is less than this number of columns
     # away from the left or right screen edge
     scrollborderx = 10
 
     # Start scrolling when the cursor is less than this number of lines
     # away from the top or bottom screen edge
     scrollbordery = 5
 
     # Accelerate by this factor when scrolling horizontally
     acceleratex = 1.05
 
     # Accelerate by this factor when scrolling vertically
     acceleratey = 1.05
 
     # The maximum horizontal scroll speed
     # (as a factor of the screen width (i.e. 0.5 == half a screen width)
     maxspeedx = 0.5
 
     # The maximum vertical scroll speed
     # (as a factor of the screen height (i.e. 0.5 == half a screen height)
     maxspeedy = 0.5
 
     # The maximum number of header lines for browser level
     # if the nesting is deeper, only the innermost levels are displayed
     maxheaders = 5
 
     # The approximate maximum length of a column entry
     maxattrlength = 200
 
     # Styles for various parts of the GUI
     style_objheadertext = astyle.Style.fromstr("white:black:bold|reverse")
     style_objheadernumber = astyle.Style.fromstr("white:blue:bold|reverse")
     style_objheaderobject = astyle.Style.fromstr("white:black:reverse")
     style_colheader = astyle.Style.fromstr("blue:white:reverse")
     style_colheaderhere = astyle.Style.fromstr("green:black:bold|reverse")
     style_colheadersep = astyle.Style.fromstr("blue:black:reverse")
     style_number = astyle.Style.fromstr("blue:white:reverse")
     style_numberhere = astyle.Style.fromstr("green:black:bold|reverse")
     style_sep = astyle.Style.fromstr("blue:black")
     style_data = astyle.Style.fromstr("white:black")
     style_datapad = astyle.Style.fromstr("blue:black:bold")
     style_footer = astyle.Style.fromstr("black:white")
     style_report = astyle.Style.fromstr("white:black")
 
     # Column separator in header
     headersepchar = "|"
 
     # Character for padding data cell entries
     datapadchar = "."
 
     # Column separator in data area
     datasepchar = "|"
 
     # Character to use for "empty" cell (i.e. for non-existing attributes)
     nodatachar = "-"
 
     # Prompts for modes that require keyboard input
     prompts = {
         "goto": _CommandGoto(),
         "find": _CommandFind(),
         "findbackwards": _CommandFindBackwards()
     }
 
     # Maps curses key codes to "function" names
     keymap = Keymap()
     keymap.register("quit", "q")
     keymap.register("up", curses.KEY_UP)
     keymap.register("down", curses.KEY_DOWN)
     keymap.register("pageup", curses.KEY_PPAGE)
     keymap.register("pagedown", curses.KEY_NPAGE)
     keymap.register("left", curses.KEY_LEFT)
     keymap.register("right", curses.KEY_RIGHT)
     keymap.register("home", curses.KEY_HOME, "\x01")
     keymap.register("end", curses.KEY_END, "\x05")
     keymap.register("prevattr", "<\x1b")
     keymap.register("nextattr", ">\t")
     keymap.register("pick", "p")
     keymap.register("pickattr", "P")
     keymap.register("pickallattrs", "C")
     keymap.register("pickmarked", "m")
     keymap.register("pickmarkedattr", "M")
     keymap.register("pickinput", "i")
     keymap.register("pickinputattr", "I")
     keymap.register("hideattr", "h")
     keymap.register("unhideattrs", "H")
     keymap.register("help", "?")
     keymap.register("enter", "\r\n")
     keymap.register("enterattr", "E")
     # FIXME: What's happening here?
     keymap.register("leave", curses.KEY_BACKSPACE, "x\x08\x7f")
     keymap.register("detail", "d")
     keymap.register("detailattr", "D")
     keymap.register("tooglemark", " ")
     keymap.register("markrange", "%")
     keymap.register("sortattrasc", "v")
     keymap.register("sortattrdesc", "V")
     keymap.register("goto", "g")
     keymap.register("find", "f")
     keymap.register("findbackwards", "b")
     keymap.register("refresh", "r")
     keymap.register("refreshfind", "R")
 
-    def __init__(self, *attrs):
+    def __init__(self, input=None, attrs=None):
         """
         Create a new browser. If ``attrs`` is not empty, it is the list
         of attributes that will be displayed in the browser, otherwise
         these will be determined by the objects on screen.
         """
+        self.input = input
+
+        if attrs is None:
+            attrs = ()
         self.attrs = attrs
 
         # Stack of browser levels
         self.levels = []
         # how many colums to scroll (Changes when accelerating)
         self.stepx = 1.
 
         # how many rows to scroll (Changes when accelerating)
         self.stepy = 1.
 
         # Beep on the edges of the data area? (Will be set to ``False``
         # once the cursor hits the edge of the screen, so we don't get
         # multiple beeps).
         self._dobeep = True
 
         # Cache for registered ``curses`` colors and styles.
         self._styles = {}
         self._colors = {}
         self._maxcolor = 1
 
         # How many header lines do we want to paint (the numbers of levels
         # we have, but with an upper bound)
         self._headerlines = 1
 
         # Index of first header line
         self._firstheaderline = 0
 
         # curses window
         self.scr = None
         # report in the footer line (error, executed command etc.)
         self._report = None
 
         # value to be returned to the caller (set by commands)
         self.returnvalue = None
 
         # The mode the browser is in
         # e.g. normal browsing or entering an argument for a command
         self.mode = "default"
 
         # set by the SIGWINCH signal handler
         self.resized = False
 
     def nextstepx(self, step):
         """
         Accelerate horizontally.
         """
         return max(1., min(step*self.acceleratex,
                            self.maxspeedx*self.levels[-1].mainsizex))
 
     def nextstepy(self, step):
         """
         Accelerate vertically.
         """
         return max(1., min(step*self.acceleratey,
                            self.maxspeedy*self.levels[-1].mainsizey))
 
     def getstyle(self, style):
         """
         Register the ``style`` with ``curses`` or get it from the cache,
         if it has been registered before.
         """
         try:
             return self._styles[style.fg, style.bg, style.attrs]
         except KeyError:
             attrs = 0
             for b in astyle.A2CURSES:
                 if style.attrs & b:
                     attrs |= astyle.A2CURSES[b]
             try:
                 color = self._colors[style.fg, style.bg]
             except KeyError:
                 curses.init_pair(
                     self._maxcolor,
                     astyle.COLOR2CURSES[style.fg],
                     astyle.COLOR2CURSES[style.bg]
                 )
                 color = curses.color_pair(self._maxcolor)
                 self._colors[style.fg, style.bg] = color
                 self._maxcolor += 1
             c = color | attrs
             self._styles[style.fg, style.bg, style.attrs] = c
             return c
 
     def addstr(self, y, x, begx, endx, text, style):
         """
         A version of ``curses.addstr()`` that can handle ``x`` coordinates
         that are outside the screen.
         """
         text2 = text[max(0, begx-x):max(0, endx-x)]
         if text2:
             self.scr.addstr(y, max(x, begx), text2, self.getstyle(style))
         return len(text)
 
     def addchr(self, y, x, begx, endx, c, l, style):
         x0 = max(x, begx)
         x1 = min(x+l, endx)
         if x1>x0:
             self.scr.addstr(y, x0, c*(x1-x0), self.getstyle(style))
         return l
 
     def _calcheaderlines(self, levels):
         # Calculate how many headerlines do we have to display, if we have
         # ``levels`` browser levels
         if levels is None:
             levels = len(self.levels)
         self._headerlines = min(self.maxheaders, levels)
         self._firstheaderline = levels-self._headerlines
 
     def getstylehere(self, style):
         """
         Return a style for displaying the original style ``style``
         in the row the cursor is on.
         """
         return astyle.Style(style.fg, astyle.COLOR_BLUE, style.attrs | astyle.A_BOLD)
 
     def report(self, msg):
         """
         Store the message ``msg`` for display below the footer line. This
         will be displayed as soon as the screen is redrawn.
         """
         self._report = msg
 
     def enter(self, item, *attrs):
         """
         Enter the object ``item``. If ``attrs`` is specified, it will be used
         as a fixed list of attributes to display.
         """
         if self.levels and item is self.levels[-1].input:
             curses.beep()
             self.report(CommandError("Recursion on input object"))
         else:
             oldlevels = len(self.levels)
             self._calcheaderlines(oldlevels+1)
             try:
                 level = _BrowserLevel(
                     self,
                     item,
                     self.scrsizey-1-self._headerlines-2,
                     *attrs
                 )
             except (KeyboardInterrupt, SystemExit):
                 raise
             except Exception, exc:
                 if not self.levels:
                     raise
                 self._calcheaderlines(oldlevels)
                 curses.beep()
                 self.report(exc)
             else:
                 self.levels.append(level)
 
     def startkeyboardinput(self, mode):
         """
         Enter mode ``mode``, which requires keyboard input.
         """
         self.mode = mode
         self.prompts[mode].start()
 
     def keylabel(self, keycode):
         """
         Return a pretty name for the ``curses`` key ``keycode`` (used in the
         help screen and in reports about unassigned keys).
         """
         if keycode <= 0xff:
             specialsnames = {
                 ord("\n"): "RETURN",
                 ord(" "): "SPACE",
                 ord("\t"): "TAB",
                 ord("\x7f"): "DELETE",
                 ord("\x08"): "BACKSPACE",
             }
             if keycode in specialsnames:
                 return specialsnames[keycode]
             elif 0x00 < keycode < 0x20:
                 return "CTRL-%s" % chr(keycode + 64)
             return repr(chr(keycode))
         for name in dir(curses):
             if name.startswith("KEY_") and getattr(curses, name) == keycode:
                 return name
         return str(keycode)
 
     def beep(self, force=False):
         if force or self._dobeep:
             curses.beep()
             # don't beep again (as long as the same key is pressed)
             self._dobeep = False
 
     def cmd_up(self):
         """
         Move the cursor to the previous row.
         """
         level = self.levels[-1]
         self.report("up")
         level.moveto(level.curx, level.cury-self.stepy)
 
     def cmd_down(self):
         """
         Move the cursor to the next row.
         """
         level = self.levels[-1]
         self.report("down")
         level.moveto(level.curx, level.cury+self.stepy)
 
     def cmd_pageup(self):
         """
         Move the cursor up one page.
         """
         level = self.levels[-1]
         self.report("page up")
         level.moveto(level.curx, level.cury-level.mainsizey+self.pageoverlapy)
 
     def cmd_pagedown(self):
         """
         Move the cursor down one page.
         """
         level = self.levels[-1]
         self.report("page down")
         level.moveto(level.curx, level.cury+level.mainsizey-self.pageoverlapy)
 
     def cmd_left(self):
         """
         Move the cursor left.
         """
         level = self.levels[-1]
         self.report("left")
         level.moveto(level.curx-self.stepx, level.cury)
 
     def cmd_right(self):
         """
         Move the cursor right.
         """
         level = self.levels[-1]
         self.report("right")
         level.moveto(level.curx+self.stepx, level.cury)
 
     def cmd_home(self):
         """
         Move the cursor to the first column.
         """
         level = self.levels[-1]
         self.report("home")
         level.moveto(0, level.cury)
 
     def cmd_end(self):
         """
         Move the cursor to the last column.
         """
         level = self.levels[-1]
         self.report("end")
         level.moveto(level.datasizex+level.mainsizey-self.pageoverlapx, level.cury)
 
     def cmd_prevattr(self):
         """
         Move the cursor one attribute column to the left.
         """
         level = self.levels[-1]
         if level.displayattr[0] is None or level.displayattr[0] == 0:
             self.beep()
         else:
             self.report("prevattr")
             pos = 0
             for (i, attrname) in enumerate(level.displayattrs):
                 if i == level.displayattr[0]-1:
                     break
                 pos += level.colwidths[attrname] + 1
             level.moveto(pos, level.cury)
 
     def cmd_nextattr(self):
         """
         Move the cursor one attribute column to the right.
         """
         level = self.levels[-1]
         if level.displayattr[0] is None or level.displayattr[0] == len(level.displayattrs)-1:
             self.beep()
         else:
             self.report("nextattr")
             pos = 0
             for (i, attrname) in enumerate(level.displayattrs):
                 if i == level.displayattr[0]+1:
                     break
                 pos += level.colwidths[attrname] + 1
             level.moveto(pos, level.cury)
 
     def cmd_pick(self):
         """
         'Pick' the object under the cursor (i.e. the row the cursor is on).
         This leaves the browser and returns the picked object to the caller.
         (In IPython this object will be available as the ``_`` variable.)
         """
         level = self.levels[-1]
         self.returnvalue = level.items[level.cury].item
         return True
 
     def cmd_pickattr(self):
         """
         'Pick' the attribute under the cursor (i.e. the row/column the
         cursor is on).
         """
         level = self.levels[-1]
         attr = level.displayattr[1]
         if attr is ipipe.noitem:
             curses.beep()
             self.report(CommandError("no column under cursor"))
             return
         value = attr.value(level.items[level.cury].item)
         if value is ipipe.noitem:
             curses.beep()
             self.report(AttributeError(attr.name()))
         else:
             self.returnvalue = value
             return True
 
     def cmd_pickallattrs(self):
         """
         Pick' the complete column under the cursor (i.e. the attribute under
         the cursor) from all currently fetched objects. These attributes
         will be returned as a list.
         """
         level = self.levels[-1]
         attr = level.displayattr[1]
         if attr is ipipe.noitem:
             curses.beep()
             self.report(CommandError("no column under cursor"))
             return
         result = []
         for cache in level.items:
             value = attr.value(cache.item)
             if value is not ipipe.noitem:
                 result.append(value)
         self.returnvalue = result
         return True
 
     def cmd_pickmarked(self):
         """
         'Pick' marked objects. Marked objects will be returned as a list.
         """
         level = self.levels[-1]
         self.returnvalue = [cache.item for cache in level.items if cache.marked]
         return True
 
     def cmd_pickmarkedattr(self):
         """
         'Pick' the attribute under the cursor from all marked objects
         (This returns a list).
         """
 
         level = self.levels[-1]
         attr = level.displayattr[1]
         if attr is ipipe.noitem:
             curses.beep()
             self.report(CommandError("no column under cursor"))
             return
         result = []
         for cache in level.items:
             if cache.marked:
                 value = attr.value(cache.item)
                 if value is not ipipe.noitem:
                     result.append(value)
         self.returnvalue = result
         return True
 
     def cmd_pickinput(self):
         """
         Use the object under the cursor (i.e. the row the cursor is on) as
         the next input line. This leaves the browser and puts the picked object
         in the input.
         """
         level = self.levels[-1]
         value = level.items[level.cury].item
         self.returnvalue = None
         api = ipapi.get()
         api.set_next_input(str(value))
         return True
 
     def cmd_pickinputattr(self):
         """
         Use the attribute under the cursor i.e. the row/column the cursor is on)
         as the next input line. This leaves the browser and puts the picked
         object in the input.
         """
         level = self.levels[-1]
         attr = level.displayattr[1]
         if attr is ipipe.noitem:
             curses.beep()
             self.report(CommandError("no column under cursor"))
             return
         value = attr.value(level.items[level.cury].item)
         if value is ipipe.noitem:
             curses.beep()
             self.report(AttributeError(attr.name()))
         self.returnvalue = None
         api = ipapi.get()
         api.set_next_input(str(value))
         return True
 
     def cmd_markrange(self):
         """
         Mark all objects from the last marked object before the current cursor
         position to the cursor position.
         """
         level = self.levels[-1]
         self.report("markrange")
         start = None
         if level.items:
             for i in xrange(level.cury, -1, -1):
                 if level.items[i].marked:
                     start = i
                     break
         if start is None:
             self.report(CommandError("no mark before cursor"))
             curses.beep()
         else:
             for i in xrange(start, level.cury+1):
                 cache = level.items[i]
                 if not cache.marked:
                     cache.marked = True
                     level.marked += 1
 
     def cmd_enter(self):
         """
         Enter the object under the cursor. (what this mean depends on the object
         itself (i.e. how it implements iteration). This opens a new browser 'level'.
         """
         level = self.levels[-1]
         try:
             item = level.items[level.cury].item
         except IndexError:
             self.report(CommandError("No object"))
             curses.beep()
         else:
             self.report("entering object...")
             self.enter(item)
 
     def cmd_leave(self):
         """
         Leave the current browser level and go back to the previous one.
         """
         self.report("leave")
         if len(self.levels) > 1:
             self._calcheaderlines(len(self.levels)-1)
             self.levels.pop(-1)
         else:
             self.report(CommandError("This is the last level"))
             curses.beep()
 
     def cmd_enterattr(self):
         """
         Enter the attribute under the cursor.
         """
         level = self.levels[-1]
         attr = level.displayattr[1]
         if attr is ipipe.noitem:
             curses.beep()
             self.report(CommandError("no column under cursor"))
             return
         try:
             item = level.items[level.cury].item
         except IndexError:
             self.report(CommandError("No object"))
             curses.beep()
         else:
             value = attr.value(item)
             name = attr.name()
             if value is ipipe.noitem:
                 self.report(AttributeError(name))
             else:
                 self.report("entering object attribute %s..." % name)
                 self.enter(value)
 
     def cmd_detail(self):
         """
         Show a detail view of the object under the cursor. This shows the
         name, type, doc string and value of the object attributes (and it
         might show more attributes than in the list view, depending on
         the object).
         """
         level = self.levels[-1]
         try:
             item = level.items[level.cury].item
         except IndexError:
             self.report(CommandError("No object"))
             curses.beep()
         else:
             self.report("entering detail view for object...")
             attrs = [ipipe.AttributeDetail(item, attr) for attr in ipipe.xattrs(item, "detail")]
             self.enter(attrs)
 
     def cmd_detailattr(self):
         """
         Show a detail view of the attribute under the cursor.
         """
         level = self.levels[-1]
         attr = level.displayattr[1]
         if attr is ipipe.noitem:
             curses.beep()
             self.report(CommandError("no attribute"))
             return
         try:
             item = level.items[level.cury].item
         except IndexError:
             self.report(CommandError("No object"))
             curses.beep()
         else:
             try:
                 item = attr.value(item)
             except (KeyboardInterrupt, SystemExit):
                 raise
             except Exception, exc:
                 self.report(exc)
             else:
                 self.report("entering detail view for attribute %s..." % attr.name())
                 attrs = [ipipe.AttributeDetail(item, attr) for attr in ipipe.xattrs(item, "detail")]
                 self.enter(attrs)
 
     def cmd_tooglemark(self):
         """
         Mark/unmark the object under the cursor. Marked objects have a '!'
         after the row number).
         """
         level = self.levels[-1]
         self.report("toggle mark")
         try:
             item = level.items[level.cury]
         except IndexError: # no items?
             pass
         else:
             if item.marked:
                 item.marked = False
                 level.marked -= 1
             else:
                 item.marked = True
                 level.marked += 1
 
     def cmd_sortattrasc(self):
         """
         Sort the objects (in ascending order) using the attribute under
         the cursor as the sort key.
         """
         level = self.levels[-1]
         attr = level.displayattr[1]
         if attr is ipipe.noitem:
             curses.beep()
             self.report(CommandError("no column under cursor"))
             return
         self.report("sort by %s (ascending)" % attr.name())
         def key(item):
             try:
                 return attr.value(item)
             except (KeyboardInterrupt, SystemExit):
                 raise
             except Exception:
                 return None
         level.sort(key)
 
     def cmd_sortattrdesc(self):
         """
         Sort the objects (in descending order) using the attribute under
         the cursor as the sort key.
         """
         level = self.levels[-1]
         attr = level.displayattr[1]
         if attr is ipipe.noitem:
             curses.beep()
             self.report(CommandError("no column under cursor"))
             return
         self.report("sort by %s (descending)" % attr.name())
         def key(item):
             try:
                 return attr.value(item)
             except (KeyboardInterrupt, SystemExit):
                 raise
             except Exception:
                 return None
         level.sort(key, reverse=True)
 
     def cmd_hideattr(self):
         """
         Hide the attribute under the cursor.
         """
         level = self.levels[-1]
         if level.displayattr[0] is None:
             self.beep()
         else:
             self.report("hideattr")
             level.hiddenattrs.add(level.displayattr[1])
             level.moveto(level.curx, level.cury, refresh=True)
 
     def cmd_unhideattrs(self):
         """
         Make all attributes visible again.
         """
         level = self.levels[-1]
         self.report("unhideattrs")
         level.hiddenattrs.clear()
         level.moveto(level.curx, level.cury, refresh=True)
 
     def cmd_goto(self):
         """
         Jump to a row. The row number can be entered at the
         bottom of the screen.
         """
         self.startkeyboardinput("goto")
 
     def cmd_find(self):
         """
         Search forward for a row. The search condition can be entered at the
         bottom of the screen.
         """
         self.startkeyboardinput("find")
 
     def cmd_findbackwards(self):
         """
         Search backward for a row. The search condition can be entered at the
         bottom of the screen.
         """
         self.startkeyboardinput("findbackwards")
 
     def cmd_refresh(self):
         """
         Refreshes the display by restarting the iterator.
         """
         level = self.levels[-1]
         self.report("refresh")
         level.refresh()
 
     def cmd_refreshfind(self):
         """
         Refreshes the display by restarting the iterator and goes back to the
         same object the cursor was on before restarting (if this object can't be
         found the cursor jumps back to the first object).
         """
         level = self.levels[-1]
         self.report("refreshfind")
         level.refreshfind()
 
     def cmd_help(self):
         """
         Opens the help screen as a new browser level, describing keyboard
         shortcuts.
         """
         for level in self.levels:
             if isinstance(level.input, _BrowserHelp):
                 curses.beep()
                 self.report(CommandError("help already active"))
                 return
 
         self.enter(_BrowserHelp(self))
 
     def cmd_quit(self):
         """
         Quit the browser and return to the IPython prompt.
         """
         self.returnvalue = None
         return True
 
     def sigwinchhandler(self, signal, frame):
         self.resized = True
 
     def _dodisplay(self, scr):
         """
         This method is the workhorse of the browser. It handles screen
         drawing and the keyboard.
         """
         self.scr = scr
         curses.halfdelay(1)
         footery = 2
 
         keys = []
         for cmd in ("quit", "help"):
             key = self.keymap.findkey(cmd, None)
             if key is not None:
                 keys.append("%s=%s" % (self.keylabel(key), cmd))
         helpmsg = " | %s" % " ".join(keys)
 
         scr.clear()
         msg = "Fetching first batch of objects..."
         (self.scrsizey, self.scrsizex) = scr.getmaxyx()
         scr.addstr(self.scrsizey//2, (self.scrsizex-len(msg))//2, msg)
         scr.refresh()
 
         lastc = -1
 
         self.levels = []
         # enter the first level
         self.enter(self.input, *self.attrs)
 
         self._calcheaderlines(None)
 
         while True:
             level = self.levels[-1]
             (self.scrsizey, self.scrsizex) = scr.getmaxyx()
             level.mainsizey = self.scrsizey-1-self._headerlines-footery
 
             # Paint object header
             for i in xrange(self._firstheaderline, self._firstheaderline+self._headerlines):
                 lv = self.levels[i]
                 posx = 0
                 posy = i-self._firstheaderline
                 endx = self.scrsizex
                 if i: # not the first level
                     msg = " (%d/%d" % (self.levels[i-1].cury, len(self.levels[i-1].items))
                     if not self.levels[i-1].exhausted:
                         msg += "+"
                     msg += ") "
                     endx -= len(msg)+1
                 posx += self.addstr(posy, posx, 0, endx, " ibrowse #%d: " % i, self.style_objheadertext)
                 for (style, text) in lv.header:
                     posx += self.addstr(posy, posx, 0, endx, text, self.style_objheaderobject)
                     if posx >= endx:
                         break
                 if i:
                     posx += self.addstr(posy, posx, 0, self.scrsizex, msg, self.style_objheadernumber)
                 posx += self.addchr(posy, posx, 0, self.scrsizex, " ", self.scrsizex-posx, self.style_objheadernumber)
 
             if not level.items:
                 self.addchr(self._headerlines, 0, 0, self.scrsizex, " ", self.scrsizex, self.style_colheader)
                 self.addstr(self._headerlines+1, 0, 0, self.scrsizex, " <empty>", astyle.style_error)
                 scr.clrtobot()
             else:
                 # Paint column headers
                 scr.move(self._headerlines, 0)
                 scr.addstr(" %*s " % (level.numbersizex, "#"), self.getstyle(self.style_colheader))
                 scr.addstr(self.headersepchar, self.getstyle(self.style_colheadersep))
                 begx = level.numbersizex+3
                 posx = begx-level.datastartx
                 for attr in level.displayattrs:
                     attrname = attr.name()
                     cwidth = level.colwidths[attr]
                     header = attrname.ljust(cwidth)
                     if attr is level.displayattr[1]:
                         style = self.style_colheaderhere
                     else:
                         style = self.style_colheader
                     posx += self.addstr(self._headerlines, posx, begx, self.scrsizex, header, style)
                     posx += self.addstr(self._headerlines, posx, begx, self.scrsizex, self.headersepchar, self.style_colheadersep)
                     if posx >= self.scrsizex:
                         break
                 else:
                     scr.addstr(" "*(self.scrsizex-posx), self.getstyle(self.style_colheader))
 
                 # Paint rows
                 posy = self._headerlines+1+level.datastarty
                 for i in xrange(level.datastarty, min(level.datastarty+level.mainsizey, len(level.items))):
                     cache = level.items[i]
                     if i == level.cury:
                         style = self.style_numberhere
                     else:
                         style = self.style_number
 
                     posy = self._headerlines+1+i-level.datastarty
                     posx = begx-level.datastartx
 
                     scr.move(posy, 0)
                     scr.addstr(" %*d%s" % (level.numbersizex, i, " !"[cache.marked]), self.getstyle(style))
                     scr.addstr(self.headersepchar, self.getstyle(self.style_sep))
 
                     for attrname in level.displayattrs:
                         cwidth = level.colwidths[attrname]
                         try:
                             (align, length, parts) = level.displayrows[i-level.datastarty][attrname]
                         except KeyError:
                             align = 2
                             style = astyle.style_nodata
                             if i == level.cury:
                                 style = self.getstylehere(style)
                         padstyle = self.style_datapad
                         sepstyle = self.style_sep
                         if i == level.cury:
                             padstyle = self.getstylehere(padstyle)
                             sepstyle = self.getstylehere(sepstyle)
                         if align == 2:
                             posx += self.addchr(posy, posx, begx, self.scrsizex, self.nodatachar, cwidth, style)
                         else:
                             if align == 1:
                                 posx += self.addchr(posy, posx, begx, self.scrsizex, self.datapadchar, cwidth-length, padstyle)
                             elif align == 0:
                                 pad1 = (cwidth-length)//2
                                 pad2 = cwidth-length-len(pad1)
                                 posx += self.addchr(posy, posx, begx, self.scrsizex, self.datapadchar, pad1, padstyle)
                             for (style, text) in parts:
                                 if i == level.cury:
                                     style = self.getstylehere(style)
                                 posx += self.addstr(posy, posx, begx, self.scrsizex, text, style)
                                 if posx >= self.scrsizex:
                                     break
                             if align == -1:
                                 posx += self.addchr(posy, posx, begx, self.scrsizex, self.datapadchar, cwidth-length, padstyle)
                             elif align == 0:
                                 posx += self.addchr(posy, posx, begx, self.scrsizex, self.datapadchar, pad2, padstyle)
                         posx += self.addstr(posy, posx, begx, self.scrsizex, self.datasepchar, sepstyle)
                     else:
                         scr.clrtoeol()
 
                 # Add blank row headers for the rest of the screen
                 for posy in xrange(posy+1, self.scrsizey-2):
                     scr.addstr(posy, 0, " " * (level.numbersizex+2), self.getstyle(self.style_colheader))
                     scr.clrtoeol()
 
             posy = self.scrsizey-footery
             # Display footer
             scr.addstr(posy, 0, " "*self.scrsizex, self.getstyle(self.style_footer))
 
             if level.exhausted:
                 flag = ""
             else:
                 flag = "+"
 
             endx = self.scrsizex-len(helpmsg)-1
             scr.addstr(posy, endx, helpmsg, self.getstyle(self.style_footer))
 
             posx = 0
             msg = " %d%s objects (%d marked): " % (len(level.items), flag, level.marked)
             posx += self.addstr(posy, posx, 0, endx, msg, self.style_footer)
             try:
                 item = level.items[level.cury].item
             except IndexError: # empty
                 pass
             else:
                 for (nostyle, text) in ipipe.xrepr(item, "footer"):
                     if not isinstance(nostyle, int):
                         posx += self.addstr(posy, posx, 0, endx, text, self.style_footer)
                         if posx >= endx:
                             break
 
                 attrstyle = [(astyle.style_default, "no attribute")]
                 attr = level.displayattr[1]
                 if attr is not ipipe.noitem and not isinstance(attr, ipipe.SelfDescriptor):
                     posx += self.addstr(posy, posx, 0, endx, " | ", self.style_footer)
                     posx += self.addstr(posy, posx, 0, endx, attr.name(), self.style_footer)
                     posx += self.addstr(posy, posx, 0, endx, ": ", self.style_footer)
                     try:
                         value = attr.value(item)
                     except (SystemExit, KeyboardInterrupt):
                         raise
                     except Exception, exc:
                         value = exc
                     if value is not ipipe.noitem:
                         attrstyle = ipipe.xrepr(value, "footer")
                     for (nostyle, text) in attrstyle:
                         if not isinstance(nostyle, int):
                             posx += self.addstr(posy, posx, 0, endx, text, self.style_footer)
                             if posx >= endx:
                                 break
 
             try:
                 # Display input prompt
                 if self.mode in self.prompts:
                     history = self.prompts[self.mode]
                     posx = 0
                     posy = self.scrsizey-1
                     posx += self.addstr(posy, posx, 0, endx, history.prompt, astyle.style_default)
                     posx += self.addstr(posy, posx, 0, endx, " [", astyle.style_default)
                     if history.cury==-1:
                         text = "new"
                     else:
                         text = str(history.cury+1)
                     posx += self.addstr(posy, posx, 0, endx, text, astyle.style_type_number)
                     if history.history:
                         posx += self.addstr(posy, posx, 0, endx, "/", astyle.style_default)
                         posx += self.addstr(posy, posx, 0, endx, str(len(history.history)), astyle.style_type_number)
                     posx += self.addstr(posy, posx, 0, endx, "]: ", astyle.style_default)
                     inputstartx = posx
                     posx += self.addstr(posy, posx, 0, endx, history.input, astyle.style_default)
                 # Display report
                 else:
                     if self._report is not None:
                         if isinstance(self._report, Exception):
                             style = self.getstyle(astyle.style_error)
                             if self._report.__class__.__module__ == "exceptions":
                                 msg = "%s: %s" % \
                                       (self._report.__class__.__name__, self._report)
                             else:
                                 msg = "%s.%s: %s" % \
                                       (self._report.__class__.__module__,
                                        self._report.__class__.__name__, self._report)
                         else:
                             style = self.getstyle(self.style_report)
                             msg = self._report
                         scr.addstr(self.scrsizey-1, 0, msg[:self.scrsizex], style)
                         self._report = None
                     else:
                         scr.move(self.scrsizey-1, 0)
             except curses.error:
                 # Protect against errors from writing to the last line
                 pass
             scr.clrtoeol()
 
             # Position cursor
             if self.mode in self.prompts:
                 history = self.prompts[self.mode]
                 scr.move(self.scrsizey-1, inputstartx+history.curx)
             else:
                 scr.move(
                     1+self._headerlines+level.cury-level.datastarty,
                     level.numbersizex+3+level.curx-level.datastartx
                 )
             scr.refresh()
 
             # Check keyboard
             while True:
                 c = scr.getch()
                 if self.resized:
                     size = fcntl.ioctl(0, tty.TIOCGWINSZ, "12345678")
                     size = struct.unpack("4H", size)
                     oldsize = scr.getmaxyx()
                     scr.erase()
                     curses.resize_term(size[0], size[1])
                     newsize = scr.getmaxyx()
                     scr.erase()
                     for l in self.levels:
                         l.mainsizey += newsize[0]-oldsize[0]
                         l.moveto(l.curx, l.cury, refresh=True)
                     scr.refresh()
                     self.resized = False
                     break # Redisplay
                 if self.mode in self.prompts:
                     if self.prompts[self.mode].handlekey(self, c):
                        break # Redisplay
                 else:
                     # if no key is pressed slow down and beep again
                     if c == -1:
                         self.stepx = 1.
                         self.stepy = 1.
                         self._dobeep = True
                     else:
                         # if a different key was pressed slow down and beep too
                         if c != lastc:
                             lastc = c
                             self.stepx = 1.
                             self.stepy = 1.
                             self._dobeep = True
                         cmdname = self.keymap.get(c, None)
                         if cmdname is None:
                             self.report(
                                 UnassignedKeyError("Unassigned key %s" %
                                                    self.keylabel(c)))
                         else:
                             cmdfunc = getattr(self, "cmd_%s" % cmdname, None)
                             if cmdfunc is None:
                                 self.report(
                                     UnknownCommandError("Unknown command %r" %
                                                         (cmdname,)))
                             elif cmdfunc():
                                 returnvalue = self.returnvalue
                                 self.returnvalue = None
                                 return returnvalue
                         self.stepx = self.nextstepx(self.stepx)
                         self.stepy = self.nextstepy(self.stepy)
                         curses.flushinp() # get rid of type ahead
                         break # Redisplay
         self.scr = None
 
     def display(self):
         if hasattr(curses, "resize_term"):
             oldhandler = signal.signal(signal.SIGWINCH, self.sigwinchhandler)
             try:
                 return curses.wrapper(self._dodisplay)
             finally:
                 signal.signal(signal.SIGWINCH, oldhandler)
         else:
             return curses.wrapper(self._dodisplay)

IPython/Extensions/igrid.py

@@ -1,1125 +1,1129 b''
 # -*- coding: iso-8859-1 -*-
 
 import ipipe, os, webbrowser, urllib
 from IPython import ipapi
 import wx
 import wx.grid, wx.html
 
 try:
     sorted
 except NameError:
     from ipipe import sorted
 try:
     set
 except:
     from sets import Set as set
 
 
 __all__ = ["igrid"]
 
 
 help = """
 <?xml version='1.0' encoding='iso-8859-1'?>
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
 <link rel="stylesheet" href="igrid_help.css" type="text/css" />
 <title>igrid help</title>
 </head>
 <body>
 <h1>igrid help</h1>
 
 
 <h2>Commands</h2>
 
 
 <h3>pick (P)</h3>
 <p>Pick the whole row (object is available as "_")</p>
 
 <h3>pickattr (Shift-P)</h3>
 <p>Pick the attribute under the cursor</p>
 
 <h3>pickallattrs (Shift-C)</h3>
 <p>Pick the complete column under the cursor (i.e. the attribute under the
 cursor) from all currently fetched objects. These attributes will be returned
 as a list.</p>
 
 <h3>pickinput (I)</h3>
 <p>Pick the current row as next input line in IPython. Additionally the row is stored as "_"</p>
 
 <h3>pickinputattr (Shift-I)</h3>
 <p>Pick the attribute under the cursor as next input line in IPython. Additionally the row is stored as "_"</p>
 
 <h3>enter (E)</h3>
 <p>Enter the object under the cursor. (what this mean depends on the object
 itself, i.e. how it implements iteration). This opens a new browser 'level'.</p>
 
 <h3>enterattr (Shift-E)</h3>
 <p>Enter the attribute under the cursor.</p>
 
 <h3>detail (D)</h3>
 <p>Show a detail view of the object under the cursor. This shows the name,
 type, doc string and value of the object attributes (and it might show more
 attributes than in the list view, depending on the object).</p>
 
 <h3>detailattr (Shift-D)</h3>
 <p>Show a detail view of the attribute under the cursor.</p>
 
 <h3>pickrows (M)</h3>
 <p>Pick multiple selected rows (M)</p>
 
 <h3>pickrowsattr (CTRL-M)</h3>
 <p>From multiple selected rows pick the cells matching the attribute the cursor is in (CTRL-M)</p>
 
 <h3>find (CTRL-F)</h3>
 <p>Find text</p>
 
 <h3>find_expression (CTRL-Shift-F)</h3>
 <p>Find entries matching an expression</p>
 
 <h3>find_next (F3)</h3>
 <p>Find next occurrence</p>
 
 <h3>find_previous (Shift-F3)</h3>
 <p>Find previous occurrence</p>
 
 <h3>sortattrasc (V)</h3>
 <p>Sort the objects (in ascending order) using the attribute under the cursor as the sort key.</p>
 
 <h3>sortattrdesc (Shift-V)</h3>
 <p>Sort the objects (in descending order) using the attribute under the cursor as the sort key.</p>
 
 <h3>refresh_once (R, F5)</h3>
 <p>Refreshes the display by restarting the iterator</p>
 
 <h3>refresh_every_second</h3>
 <p>Refreshes the display by restarting the iterator every second until stopped by stop_refresh.</p>
 
 <h3>refresh_interval</h3>
 <p>Refreshes the display by restarting the iterator every X ms (X is a custom interval set by the user) until stopped by stop_refresh.</p>
 
 <h3>stop_refresh</h3>
 <p>Stops all refresh timers.</p>
 
 <h3>leave (Backspace, DEL, X)</h3>
 <p>Close current tab (and all the tabs to the right of the current one).</h3>
 
 <h3>quit (ESC,Q)</h3>
 <p>Quit igrid and return to the IPython prompt.</p>
 
 
 <h2>Navigation</h2>
 
 
 <h3>Jump to the last column of the current row (END, CTRL-E, CTRL-Right)</h3>
 
 <h3>Jump to the first column of the current row (HOME, CTRL-A, CTRL-Left)</h3>
 
 <h3>Move the cursor one column to the left (&lt;)</h3>
 
 <h3>Move the cursor one column to the right (&gt;)</h3>
 
 <h3>Jump to the first row in the current column (CTRL-Up)</h3>
 
 <h3>Jump to the last row in the current column (CTRL-Down)</h3>
 
 </body>
 </html>
 
 """
 
 
 class IGridRenderer(wx.grid.PyGridCellRenderer):
     """
     This is a custom renderer for our IGridGrid
     """
     def __init__(self, table):
         self.maxchars = 200
         self.table = table
         self.colormap = (
             (  0,   0,   0),
             (174,   0,   0),
             (  0, 174,   0),
             (174, 174,   0),
             (  0,   0, 174),
             (174,   0, 174),
             (  0, 174, 174),
             ( 64,  64,  64)
         )
 
         wx.grid.PyGridCellRenderer.__init__(self)
 
     def _getvalue(self, row, col):
         try:
             value = self.table._displayattrs[col].value(self.table.items[row])
             (align, width, text) = ipipe.xformat(value, "cell", self.maxchars)
         except Exception, exc:
             (align, width, text) = ipipe.xformat(exc, "cell", self.maxchars)
         return (align, text)
 
     def GetBestSize(self, grid, attr, dc, row, col):
         text = grid.GetCellValue(row, col)
         (align, text) = self._getvalue(row, col)
         dc.SetFont(attr.GetFont())
         (w, h) = dc.GetTextExtent(str(text))
         return wx.Size(min(w+2, 600), h+2) # add border
 
     def Draw(self, grid, attr, dc, rect, row, col, isSelected):
         """
         Takes care of drawing everything in the cell; aligns the text
         """
         text = grid.GetCellValue(row, col)
         (align, text) = self._getvalue(row, col)
         if isSelected:
             bg = grid.GetSelectionBackground()
         else:
             bg = ["white", (240, 240, 240)][row%2]
         dc.SetTextBackground(bg)
         dc.SetBrush(wx.Brush(bg, wx.SOLID))
         dc.SetPen(wx.TRANSPARENT_PEN)
         dc.SetFont(attr.GetFont())
         dc.DrawRectangleRect(rect)
         dc.SetClippingRect(rect)
         # Format the text
         if align == -1: # left alignment
             (width, height) = dc.GetTextExtent(str(text))
             x = rect[0]+1
             y = rect[1]+0.5*(rect[3]-height)
 
             for (style, part) in text:
                 if isSelected:
                     fg = grid.GetSelectionForeground()
                 else:
                     fg = self.colormap[style.fg]
                 dc.SetTextForeground(fg)
                 (w, h) = dc.GetTextExtent(part)
                 dc.DrawText(part, x, y)
                 x += w
         elif align == 0: # center alignment
             (width, height) = dc.GetTextExtent(str(text))
             x = rect[0]+0.5*(rect[2]-width)
             y = rect[1]+0.5*(rect[3]-height)
             for (style, part) in text:
                 if isSelected:
                     fg = grid.GetSelectionForeground()
                 else:
                     fg = self.colormap[style.fg]
                 dc.SetTextForeground(fg)
                 (w, h) = dc.GetTextExtent(part)
                 dc.DrawText(part, x, y)
                 x += w
         else:  # right alignment
             (width, height) = dc.GetTextExtent(str(text))
             x = rect[0]+rect[2]-1
             y = rect[1]+0.5*(rect[3]-height)
             for (style, part) in reversed(text):
                 (w, h) = dc.GetTextExtent(part)
                 x -= w
                 if isSelected:
                     fg = grid.GetSelectionForeground()
                 else:
                     fg = self.colormap[style.fg]
                 dc.SetTextForeground(fg)
                 dc.DrawText(part, x, y)
         dc.DestroyClippingRegion()
 
     def Clone(self):
         return IGridRenderer(self.table)
 
 
 class IGridTable(wx.grid.PyGridTableBase):
     # The data table for the ``IGridGrid``. Some dirty tricks were used here:
     # ``GetValue()`` does not get any values (or at least it does not return
     # anything, accessing the values is done by the renderer)
     # but rather tries to fetch the objects which were requested into the table.
     # General behaviour is: Fetch the first X objects. If the user scrolls down
     # to the last object another bunch of X objects is fetched (if possible)
     def __init__(self, input, fontsize, *attrs):
         wx.grid.PyGridTableBase.__init__(self)
         self.input = input
         self.iterator = ipipe.xiter(input)
         self.items = []
         self.attrs = [ipipe.upgradexattr(attr) for attr in attrs]
         self._displayattrs = self.attrs[:]
         self._displayattrset = set(self.attrs)
         self.fontsize = fontsize
         self._fetch(1)
         self.timer = wx.Timer()
         self.timer.Bind(wx.EVT_TIMER, self.refresh_content)
 
     def GetAttr(self, *args):
         attr = wx.grid.GridCellAttr()
         attr.SetFont(wx.Font(self.fontsize, wx.TELETYPE, wx.NORMAL, wx.NORMAL))
         return attr
 
     def GetNumberRows(self):
         return len(self.items)
 
     def GetNumberCols(self):
         return len(self._displayattrs)
 
     def GetColLabelValue(self, col):
         if col < len(self._displayattrs):
             return self._displayattrs[col].name()
         else:
             return ""
 
     def GetRowLabelValue(self, row):
         return str(row)
 
     def IsEmptyCell(self, row, col):
         return False
 
     def _append(self, item):
         self.items.append(item)
         # Nothing to do if the set of attributes has been fixed by the user
         if not self.attrs:
             for attr in ipipe.xattrs(item):
                 attr = ipipe.upgradexattr(attr)
                 if attr not in self._displayattrset:
                     self._displayattrs.append(attr)
                     self._displayattrset.add(attr)
 
     def _fetch(self, count):
         # Try to fill ``self.items`` with at least ``count`` objects.
         have = len(self.items)
         while self.iterator is not None and have < count:
             try:
                 item = self.iterator.next()
             except StopIteration:
                 self.iterator = None
                 break
             except (KeyboardInterrupt, SystemExit):
                 raise
             except Exception, exc:
                 have += 1
                 self._append(exc)
                 self.iterator = None
                 break
             else:
                 have += 1
                 self._append(item)
 
     def GetValue(self, row, col):
         # some kind of dummy-function: does not return anything but "";
         # (The value isn't use anyway)
         # its main task is to trigger the fetch of new objects
         sizing_needed = False
         had_cols = len(self._displayattrs)
         had_rows = len(self.items)
         if row == had_rows - 1 and self.iterator is not None:
             self._fetch(row + 20)
             sizing_needed = True
         have_rows = len(self.items)
         have_cols = len(self._displayattrs)
         if have_rows > had_rows:
             msg = wx.grid.GridTableMessage(self, wx.grid.GRIDTABLE_NOTIFY_ROWS_APPENDED, have_rows - had_rows)
             self.GetView().ProcessTableMessage(msg)
             sizing_needed = True
         if row >= have_rows:
             return ""
         if have_cols != had_cols:
             msg = wx.grid.GridTableMessage(self, wx.grid.GRIDTABLE_NOTIFY_COLS_APPENDED, have_cols - had_cols)
             self.GetView().ProcessTableMessage(msg)
             sizing_needed = True
         if sizing_needed:
             self.GetView().AutoSizeColumns(False)
         return ""
 
     def SetValue(self, row, col, value):
         pass
 
     def refresh_content(self, event):
         msg = wx.grid.GridTableMessage(self, wx.grid.GRIDTABLE_NOTIFY_ROWS_DELETED, 0, self.GetNumberRows())
         self.GetView().ProcessTableMessage(msg)
         self.iterator = ipipe.xiter(self.input)
         self.items = []
         self.attrs = [] # _append will calculate new displayattrs
         self._fetch(1) # fetch one...
         if self.items:
             msg = wx.grid.GridTableMessage(self, wx.grid.GRIDTABLE_NOTIFY_ROWS_APPENDED, 1)
             self.GetView().ProcessTableMessage(msg)
             self.GetValue(0, 0) # and trigger "fetch next 20"
             item = self.items[0]
             self.GetView().AutoSizeColumns(False)
             panel = self.GetView().GetParent()
             nb = panel.GetParent()
             current = nb.GetSelection()
             if nb.GetPage(current) == panel:
                 self.GetView().set_footer(item)
 
 class IGridGrid(wx.grid.Grid):
     # The actual grid
     # all methods for selecting/sorting/picking/... data are implemented here
     def __init__(self, panel, input, *attrs):
         wx.grid.Grid.__init__(self, panel)
         fontsize = 9
         self.input = input
         self.table = IGridTable(self.input, fontsize, *attrs)
         self.SetTable(self.table, True)
         self.SetSelectionMode(wx.grid.Grid.wxGridSelectRows)
         self.SetDefaultRenderer(IGridRenderer(self.table))
         self.EnableEditing(False)
         self.Bind(wx.EVT_KEY_DOWN, self.key_pressed)
         self.Bind(wx.grid.EVT_GRID_CELL_LEFT_DCLICK, self.cell_doubleclicked)
         self.Bind(wx.grid.EVT_GRID_CELL_LEFT_CLICK, self.cell_leftclicked)
         self.Bind(wx.grid.EVT_GRID_LABEL_LEFT_DCLICK, self.label_doubleclicked)
         self.Bind(wx.grid.EVT_GRID_LABEL_LEFT_CLICK, self.on_label_leftclick)
         self.Bind(wx.grid.EVT_GRID_RANGE_SELECT, self._on_selected_range)
         self.Bind(wx.grid.EVT_GRID_SELECT_CELL, self._on_selected_cell)
         self.current_selection = set()
         self.maxchars = 200
 
     def on_label_leftclick(self, event):
         event.Skip()
 
     def error_output(self, text):
         wx.Bell()
         frame = self.GetParent().GetParent().GetParent()
         frame.SetStatusText(str(text))
 
     def _on_selected_range(self, event):
         # Internal update to the selection tracking lists
         if event.Selecting():
             # adding to the list...
             self.current_selection.update(xrange(event.GetTopRow(), event.GetBottomRow()+1))
         else:
             # removal from list
             for index in xrange(event.GetTopRow(), event.GetBottomRow()+1):
                 self.current_selection.discard(index)
         event.Skip()
 
     def _on_selected_cell(self, event):
         # Internal update to the selection tracking list
         self.current_selection = set([event.GetRow()])
         event.Skip()
 
     def sort(self, key, reverse=False):
         """
         Sort the current list of items using the key function ``key``. If
         ``reverse`` is true the sort order is reversed.
         """
         row = self.GetGridCursorRow()
         col = self.GetGridCursorCol()
         curitem = self.table.items[row] # Remember where the cursor is now
         # Sort items
         def realkey(item):
             try:
                 return key(item)
             except (KeyboardInterrupt, SystemExit):
                 raise
             except Exception:
                 return None
         try:
             self.table.items = ipipe.deque(sorted(self.table.items, key=realkey, reverse=reverse))
         except TypeError, exc:
             self.error_output("Exception encountered: %s" % exc)
             return
         # Find out where the object under the cursor went
         for (i, item) in enumerate(self.table.items):
             if item is curitem:
                 self.SetGridCursor(i,col)
                 self.MakeCellVisible(i,col)
                 self.Refresh()
 
     def sortattrasc(self):
         """
         Sort in ascending order; sorting criteria is the current attribute
         """
         col = self.GetGridCursorCol()
         attr = self.table._displayattrs[col]
         frame = self.GetParent().GetParent().GetParent()
         if attr is ipipe.noitem:
             self.error_output("no column under cursor")
             return
         frame.SetStatusText("sort by %s (ascending)" % attr.name())
         def key(item):
             try:
                 return attr.value(item)
             except (KeyboardInterrupt, SystemExit):
                 raise
             except Exception:
                 return None
         self.sort(key)
 
     def sortattrdesc(self):
         """
         Sort in descending order; sorting criteria is the current attribute
         """
         col = self.GetGridCursorCol()
         attr = self.table._displayattrs[col]
         frame = self.GetParent().GetParent().GetParent()
         if attr is ipipe.noitem:
             self.error_output("no column under cursor")
             return
         frame.SetStatusText("sort by %s (descending)" % attr.name())
         def key(item):
             try:
                 return attr.value(item)
             except (KeyboardInterrupt, SystemExit):
                 raise
             except Exception:
                 return None
         self.sort(key, reverse=True)
 
     def label_doubleclicked(self, event):
         row = event.GetRow()
         col = event.GetCol()
         if col == -1:
             self.enter(row)
 
     def _getvalue(self, row, col):
         """
         Gets the text which is displayed at ``(row, col)``
         """
         try:
             value = self.table._displayattrs[col].value(self.table.items[row])
             (align, width, text) = ipipe.xformat(value, "cell", self.maxchars)
         except IndexError:
             raise IndexError
         except Exception, exc:
             (align, width, text) = ipipe.xformat(exc, "cell", self.maxchars)
         return text
 
     def searchexpression(self, searchexp, startrow=None, search_forward=True ):
         """
         Find by expression
         """
         frame = self.GetParent().GetParent().GetParent()
         if searchexp:
             if search_forward:
                 if not startrow:
                     row = self.GetGridCursorRow()+1
                 else:
                     row = startrow + 1
                 while True:
                     try:
                         foo = self.table.GetValue(row, 0)
                         item = self.table.items[row]
                         try:
                             globals = ipipe.getglobals(None)
                             if eval(searchexp, globals, ipipe.AttrNamespace(item)):
                                 self.SetGridCursor(row, 0) # found something
                                 self.MakeCellVisible(row, 0)
                                 break
                         except (KeyboardInterrupt, SystemExit):
                             raise
                         except Exception, exc:
                             frame.SetStatusText(str(exc))
                             wx.Bell()
                             break  # break on error
                     except IndexError:
                         return
                     row += 1
             else:
                 if not startrow:
                     row = self.GetGridCursorRow() - 1
                 else:
                     row = startrow - 1
                 while True:
                     try:
                         foo = self.table.GetValue(row, 0)
                         item = self.table.items[row]
                         try:
                             globals = ipipe.getglobals(None)
                             if eval(searchexp, globals, ipipe.AttrNamespace(item)):
                                 self.SetGridCursor(row, 0) # found something
                                 self.MakeCellVisible(row, 0)
                                 break
                         except (KeyboardInterrupt, SystemExit):
                             raise
                         except Exception, exc:
                             frame.SetStatusText(str(exc))
                             wx.Bell()
                             break  # break on error
                     except IndexError:
                         return
                     row -= 1
 
 
     def search(self, searchtext, startrow=None, startcol=None, search_forward=True):
         """
         search for ``searchtext``, starting in ``(startrow, startcol)``;
         if ``search_forward`` is true the direction is "forward"
         """
         searchtext = searchtext.lower()
         if search_forward:
             if startrow is not None and startcol is not None:
                 row = startrow
             else:
                 startcol = self.GetGridCursorCol() + 1
                 row = self.GetGridCursorRow()
                 if startcol >= self.GetNumberCols():
                     startcol = 0
                     row += 1
             while True:
                 for col in xrange(startcol, self.table.GetNumberCols()):
                     try:
                         foo = self.table.GetValue(row, col)
                         text = self._getvalue(row, col)
                         if searchtext in text.string().lower():
                             self.SetGridCursor(row, col)
                             self.MakeCellVisible(row, col)
                             return
                     except IndexError:
                         return
                 startcol = 0
                 row += 1
         else:
             if startrow is not None and startcol is not None:
                 row = startrow
             else:
                 startcol = self.GetGridCursorCol() - 1
                 row = self.GetGridCursorRow()
                 if startcol < 0:
                     startcol = self.GetNumberCols() - 1
                     row -= 1
             while True:
                 for col in xrange(startcol, -1, -1):
                     try:
                         foo = self.table.GetValue(row, col)
                         text = self._getvalue(row, col)
                         if searchtext in text.string().lower():
                             self.SetGridCursor(row, col)
                             self.MakeCellVisible(row, col)
                             return
                     except IndexError:
                         return
                 startcol = self.table.GetNumberCols()-1
                 row -= 1
 
     def key_pressed(self, event):
         """
         Maps pressed keys to functions
         """
         frame = self.GetParent().GetParent().GetParent()
         frame.SetStatusText("")
         sh = event.ShiftDown()
         ctrl = event.ControlDown()
 
         keycode = event.GetKeyCode()
         if keycode == ord("P"):
             row = self.GetGridCursorRow()
             if sh:
                 col = self.GetGridCursorCol()
                 self.pickattr(row, col)
             else:
                 self.pick(row)
         elif keycode == ord("M"):
             if ctrl:
                 col = self.GetGridCursorCol()
                 self.pickrowsattr(sorted(self.current_selection), col)
             else:
                 self.pickrows(sorted(self.current_selection))
         elif keycode in (wx.WXK_BACK, wx.WXK_DELETE, ord("X")) and not (ctrl or sh):
             self.delete_current_notebook()
         elif keycode in (ord("E"), ord("\r")):
             row = self.GetGridCursorRow()
             if sh:
                 col = self.GetGridCursorCol()
                 self.enterattr(row, col)
             else:
                 self.enter(row)
         elif keycode == ord("E") and ctrl:
             row = self.GetGridCursorRow()
             self.SetGridCursor(row, self.GetNumberCols()-1)
         elif keycode == wx.WXK_HOME or (keycode == ord("A") and ctrl):
             row = self.GetGridCursorRow()
             self.SetGridCursor(row, 0)
         elif keycode == ord("C") and sh:
             col = self.GetGridCursorCol()
             attr = self.table._displayattrs[col]
             result = []
             for i in xrange(self.GetNumberRows()):
                 result.append(self.table._displayattrs[col].value(self.table.items[i]))
             self.quit(result)
         elif keycode in (wx.WXK_ESCAPE, ord("Q")) and not (ctrl or sh):
             self.quit()
         elif keycode == ord("<"):
             row = self.GetGridCursorRow()
             col = self.GetGridCursorCol()
             if not event.ShiftDown():
                 newcol = col - 1
                 if newcol >= 0:
                     self.SetGridCursor(row, col - 1)
             else:
                 newcol = col + 1
                 if newcol < self.GetNumberCols():
                     self.SetGridCursor(row, col + 1)
         elif keycode == ord("D"):
             col = self.GetGridCursorCol()
             row = self.GetGridCursorRow()
             if not sh:
                 self.detail(row, col)
             else:
                 self.detail_attr(row, col)
         elif keycode == ord("F") and ctrl:
             if sh:
                 frame.enter_searchexpression(event)
             else:
                 frame.enter_searchtext(event)
         elif keycode == wx.WXK_F3:
             if sh:
                 frame.find_previous(event)
             else:
                 frame.find_next(event)
         elif keycode == ord("V"):
             if sh:
                 self.sortattrdesc()
             else:
                 self.sortattrasc()
         elif keycode == wx.WXK_DOWN:
             row = self.GetGridCursorRow()
             try:
                 item = self.table.items[row+1]
             except IndexError:
                 item = self.table.items[row]
             self.set_footer(item)
             event.Skip()
         elif keycode == wx.WXK_UP:
             row = self.GetGridCursorRow()
             if row >= 1:
                 item = self.table.items[row-1]
             else:
                 item = self.table.items[row]
             self.set_footer(item)
             event.Skip()
         elif keycode == wx.WXK_RIGHT:
             row = self.GetGridCursorRow()
             item = self.table.items[row]
             self.set_footer(item)
             event.Skip()
         elif keycode == wx.WXK_LEFT:
             row = self.GetGridCursorRow()
             item = self.table.items[row]
             self.set_footer(item)
             event.Skip()
         elif keycode == ord("R") or keycode == wx.WXK_F5:
             self.table.refresh_content(event)
         elif keycode == ord("I"):
             row = self.GetGridCursorRow()
             if not sh:
                 self.pickinput(row)
             else:
                 col = self.GetGridCursorCol()
                 self.pickinputattr(row, col)
         else:
             event.Skip()
 
     def delete_current_notebook(self):
         """
         deletes the current notebook tab
         """
         panel = self.GetParent()
         nb = panel.GetParent()
         current = nb.GetSelection()
         count = nb.GetPageCount()
         if count > 1:
             for i in xrange(count-1, current-1, -1):
                 nb.DeletePage(i)
             nb.GetCurrentPage().grid.SetFocus()
         else:
             frame = nb.GetParent()
             frame.SetStatusText("This is the last level!")
 
     def _doenter(self, value, *attrs):
         """
         "enter" a special item resulting in a new notebook tab
         """
         panel = self.GetParent()
         nb = panel.GetParent()
         frame = nb.GetParent()
         current = nb.GetSelection()
         count = nb.GetPageCount()
         try: # if we want to enter something non-iterable, e.g. a function
             if current + 1 == count and value is not self.input: # we have an event in the last tab
                 frame._add_notebook(value, *attrs)
             elif value != self.input: # we have to delete all tabs newer than [panel] first
                 for i in xrange(count-1, current, -1): # some tabs don't close if we don't close in *reverse* order
                     nb.DeletePage(i)
                 frame._add_notebook(value)
         except TypeError, exc:
             if exc.__class__.__module__ == "exceptions":
                 msg = "%s: %s" % (exc.__class__.__name__, exc)
             else:
                 msg = "%s.%s: %s" % (exc.__class__.__module__, exc.__class__.__name__, exc)
             frame.SetStatusText(msg)
 
     def enterattr(self, row, col):
         try:
             attr = self.table._displayattrs[col]
             value = attr.value(self.table.items[row])
         except Exception, exc:
             self.error_output(str(exc))
         else:
             self._doenter(value)
 
     def set_footer(self, item):
         frame = self.GetParent().GetParent().GetParent()
         frame.SetStatusText(" ".join([str(text) for (style, text) in ipipe.xformat(item, "footer", 20)[2]]), 0)
 
     def enter(self, row):
         try:
             value = self.table.items[row]
         except Exception, exc:
             self.error_output(str(exc))
         else:
             self._doenter(value)
 
     def detail(self, row, col):
         """
         shows a detail-view of the current cell
         """
         try:
             attr = self.table._displayattrs[col]
             item = self.table.items[row]
         except Exception, exc:
             self.error_output(str(exc))
         else:
             attrs = [ipipe.AttributeDetail(item, attr) for attr in ipipe.xattrs(item, "detail")]
             self._doenter(attrs)
 
     def detail_attr(self, row, col):
         try:
             attr = self.table._displayattrs[col]
             item = attr.value(self.table.items[row])
         except Exception, exc:
             self.error_output(str(exc))
         else:
             attrs = [ipipe.AttributeDetail(item, attr) for attr in ipipe.xattrs(item, "detail")]
             self._doenter(attrs)
 
     def quit(self, result=None):
         """
         quit
         """
         frame = self.GetParent().GetParent().GetParent()
         if frame.helpdialog:
             frame.helpdialog.Destroy()
         app = frame.parent
         if app is not None:
             app.result = result
         frame.Close()
         frame.Destroy()
 
     def cell_doubleclicked(self, event):
         self.enterattr(event.GetRow(), event.GetCol())
         event.Skip()
 
     def cell_leftclicked(self, event):
         row = event.GetRow()
         item = self.table.items[row]
         self.set_footer(item)
         event.Skip()
 
     def pick(self, row):
         """
         pick a single row and return to the IPython prompt
         """
         try:
             value = self.table.items[row]
         except Exception, exc:
             self.error_output(str(exc))
         else:
             self.quit(value)
 
     def pickinput(self, row):
         try:
             value = self.table.items[row]
         except Exception, exc:
             self.error_output(str(exc))
         else:
             api = ipapi.get()
             api.set_next_input(str(value))
             self.quit(value)
 
     def pickinputattr(self, row, col):
         try:
             attr = self.table._displayattrs[col]
             value = attr.value(self.table.items[row])
         except Exception, exc:
             self.error_output(str(exc))
         else:
             api = ipapi.get()
             api.set_next_input(str(value))
             self.quit(value)
 
     def pickrows(self, rows):
         """
         pick multiple rows and return to the IPython prompt
         """
         try:
             value = [self.table.items[row] for row in rows]
         except Exception, exc:
             self.error_output(str(exc))
         else:
             self.quit(value)
 
     def pickrowsattr(self, rows, col):
         """"
         pick one column from multiple rows
         """
         values = []
         try:
             attr = self.table._displayattrs[col]
             for row in rows:
                 try:
                     values.append(attr.value(self.table.items[row]))
                 except (SystemExit, KeyboardInterrupt):
                     raise
                 except Exception:
                     raise #pass
         except Exception, exc:
             self.error_output(str(exc))
         else:
             self.quit(values)
 
     def pickattr(self, row, col):
         try:
             attr = self.table._displayattrs[col]
             value = attr.value(self.table.items[row])
         except Exception, exc:
             self.error_output(str(exc))
         else:
             self.quit(value)
 
 
 class IGridPanel(wx.Panel):
     # Each IGridPanel contains an IGridGrid
     def __init__(self, parent, input, *attrs):
         wx.Panel.__init__(self, parent, -1)
         self.grid = IGridGrid(self, input, *attrs)
         self.grid.FitInside()
         sizer = wx.BoxSizer(wx.VERTICAL)
         sizer.Add(self.grid, proportion=1, flag=wx.EXPAND | wx.ALL, border=10)
         self.SetSizer(sizer)
         sizer.Fit(self)
         sizer.SetSizeHints(self)
 
 
 class IGridHTMLHelp(wx.Frame):
     def __init__(self, parent, title, size):
         wx.Frame.__init__(self, parent, -1, title, size=size)
         html = wx.html.HtmlWindow(self)
         if "gtk2" in wx.PlatformInfo:
             html.SetStandardFonts()
         html.SetPage(help)
 
 
 class IGridFrame(wx.Frame):
     maxtitlelen = 30
 
     def __init__(self, parent, input):
         title =  " ".join([str(text) for (style, text) in ipipe.xformat(input, "header", 20)[2]])
         wx.Frame.__init__(self, None, title=title, size=(640, 480))
         self.menubar = wx.MenuBar()
         self.menucounter = 100
         self.m_help = wx.Menu()
         self.m_search = wx.Menu()
         self.m_sort = wx.Menu()
         self.m_refresh = wx.Menu()
         self.notebook = wx.Notebook(self, -1, style=0)
         self.statusbar = self.CreateStatusBar(1, wx.ST_SIZEGRIP)
         self.statusbar.SetFieldsCount(2)
         self.SetStatusWidths([-1, 200])
         self.parent = parent
         self._add_notebook(input)
         self.Bind(wx.EVT_CLOSE, self.OnCloseWindow)
         self.makemenu(self.m_sort, "&Sort (asc)\tV", "Sort ascending", self.sortasc)
         self.makemenu(self.m_sort, "Sort (&desc)\tShift-V", "Sort descending", self.sortdesc)
         self.makemenu(self.m_help, "&Help\tF1", "Help", self.display_help)
 #        self.makemenu(self.m_help, "&Show help in browser", "Show help in browser", self.display_help_in_browser)
         self.makemenu(self.m_search, "&Find text\tCTRL-F", "Find text", self.enter_searchtext)
         self.makemenu(self.m_search, "Find by &expression\tCTRL-Shift-F", "Find by expression", self.enter_searchexpression)
         self.makemenu(self.m_search, "Find &next\tF3", "Find next", self.find_next)
         self.makemenu(self.m_search, "Find &previous\tShift-F3", "Find previous", self.find_previous)
         self.makemenu(self.m_refresh, "&Refresh once \tF5", "Refresh once", self.refresh_once)
         self.makemenu(self.m_refresh, "Refresh every &1s", "Refresh every second", self.refresh_every_second)
         self.makemenu(self.m_refresh, "Refresh every &X seconds", "Refresh every X seconds", self.refresh_interval)
         self.makemenu(self.m_refresh, "&Stop all refresh timers", "Stop refresh timers", self.stop_refresh)
         self.menubar.Append(self.m_search, "&Find")
         self.menubar.Append(self.m_sort, "&Sort")
         self.menubar.Append(self.m_refresh, "&Refresh")
         self.menubar.Append(self.m_help, "&Help")
         self.SetMenuBar(self.menubar)
         self.searchtext = ""
         self.searchexpression = ""
         self.helpdialog = None
         self.refresh_interval = 1000
         self.SetStatusText("Refreshing inactive", 1)
 
     def refresh_once(self, event):
         table = self.notebook.GetPage(self.notebook.GetSelection()).grid.table
         table.refresh_content(event)
 
     def refresh_interval(self, event):
         table = self.notebook.GetPage(self.notebook.GetSelection()).grid.table
         dlg = wx.TextEntryDialog(self, "Enter refresh interval (milliseconds):", "Refresh timer:", defaultValue=str(self.refresh_interval))
         if dlg.ShowModal() == wx.ID_OK:
             try:
                 milliseconds = int(dlg.GetValue())
             except ValueError, exc:
                 self.SetStatusText(str(exc))
             else:
                 table.timer.Start(milliseconds=milliseconds, oneShot=False)
                 self.SetStatusText("Refresh timer set to %s ms" % milliseconds)
                 self.SetStatusText("Refresh interval: %s ms" % milliseconds, 1)
                 self.refresh_interval = milliseconds
         dlg.Destroy()
 
     def stop_refresh(self, event):
         for i in xrange(self.notebook.GetPageCount()):
             nb = self.notebook.GetPage(i)
             nb.grid.table.timer.Stop()
             self.SetStatusText("Refreshing inactive", 1)
 
     def refresh_every_second(self, event):
         table = self.notebook.GetPage(self.notebook.GetSelection()).grid.table
         table.timer.Start(milliseconds=1000, oneShot=False)
         self.SetStatusText("Refresh interval: 1000 ms", 1)
 
     def sortasc(self, event):
         grid = self.notebook.GetPage(self.notebook.GetSelection()).grid
         grid.sortattrasc()
 
     def sortdesc(self, event):
         grid = self.notebook.GetPage(self.notebook.GetSelection()).grid
         grid.sortattrdesc()
 
     def find_previous(self, event):
         """
         find previous occurrences
         """
         grid = self.notebook.GetPage(self.notebook.GetSelection()).grid
         if self.searchtext:
             row = grid.GetGridCursorRow()
             col = grid.GetGridCursorCol()
             self.SetStatusText('Search mode: text; looking for %s' % self.searchtext)
             if col-1 >= 0:
                 grid.search(self.searchtext, row, col-1, False)
             else:
                 grid.search(self.searchtext, row-1, grid.table.GetNumberCols()-1, False)
         elif self.searchexpression:
             self.SetStatusText("Search mode: expression; looking for %s" % repr(self.searchexpression)[2:-1])
             grid.searchexpression(searchexp=self.searchexpression, search_forward=False)
         else:
             self.SetStatusText("No search yet: please enter search-text or -expression")
 
     def find_next(self, event):
         """
         find the next occurrence
         """
         grid = self.notebook.GetPage(self.notebook.GetSelection()).grid
         if self.searchtext != "":
             row = grid.GetGridCursorRow()
             col = grid.GetGridCursorCol()
             self.SetStatusText('Search mode: text; looking for %s' % self.searchtext)
             if col+1 < grid.table.GetNumberCols():
                 grid.search(self.searchtext, row, col+1)
             else:
                 grid.search(self.searchtext, row+1, 0)
         elif self.searchexpression != "":
             self.SetStatusText('Search mode: expression; looking for %s' % repr(self.searchexpression)[2:-1])
             grid.searchexpression(searchexp=self.searchexpression)
         else:
             self.SetStatusText("No search yet: please enter search-text or -expression")
 
     def display_help(self, event):
         """
         Display a help dialog
         """
         if self.helpdialog:
             self.helpdialog.Destroy()
         self.helpdialog = IGridHTMLHelp(None, title="Help", size=wx.Size(600,400))
         self.helpdialog.Show()
 
     def display_help_in_browser(self, event):
         """
         Show the help-HTML in a browser (as a ``HtmlWindow`` does not understand
         CSS this looks better)
         """
         filename = urllib.pathname2url(os.path.abspath(os.path.join(os.path.dirname(__file__), "igrid_help.html")))
         if not filename.startswith("file"):
             filename = "file:" + filename
         webbrowser.open(filename, new=1, autoraise=True)
 
     def enter_searchexpression(self, event):
         dlg = wx.TextEntryDialog(self, "Find:", "Find matching expression:", defaultValue=self.searchexpression)
         if dlg.ShowModal() == wx.ID_OK:
             self.searchexpression = dlg.GetValue()
             self.searchtext = ""
             self.SetStatusText('Search mode: expression; looking for %s' % repr(self.searchexpression)[2:-1])
             self.notebook.GetPage(self.notebook.GetSelection()).grid.searchexpression(self.searchexpression)
         dlg.Destroy()
 
     def makemenu(self, menu, label, help, cmd):
         menu.Append(self.menucounter, label, help)
         self.Bind(wx.EVT_MENU, cmd, id=self.menucounter)
         self.menucounter += 1
 
     def _add_notebook(self, input, *attrs):
         # Adds another notebook which has the starting object ``input``
         panel = IGridPanel(self.notebook, input, *attrs)
         text = str(ipipe.xformat(input, "header", self.maxtitlelen)[2])
         if len(text) >= self.maxtitlelen:
             text = text[:self.maxtitlelen].rstrip(".") + "..."
         self.notebook.AddPage(panel, text, True)
         panel.grid.SetFocus()
         self.Layout()
 
     def OnCloseWindow(self, event):
         self.Destroy()
 
     def enter_searchtext(self, event):
         # Displays a dialog asking for the searchtext
         dlg = wx.TextEntryDialog(self, "Find:", "Find in list", defaultValue=self.searchtext)
         if dlg.ShowModal() == wx.ID_OK:
             self.searchtext = dlg.GetValue()
             self.searchexpression = ""
             self.SetStatusText('Search mode: text; looking for %s' % self.searchtext)
             self.notebook.GetPage(self.notebook.GetSelection()).grid.search(self.searchtext)
         dlg.Destroy()
 
 
 class App(wx.App):
     def __init__(self, input):
         self.input = input
         self.result = None # Result to be returned to IPython. Set by quit().
         wx.App.__init__(self)
 
     def OnInit(self):
         frame = IGridFrame(self, self.input)
         frame.Show()
         self.SetTopWindow(frame)
         frame.Raise()
         return True
 
 
 class igrid(ipipe.Display):
     """
     This is a wx-based display object that can be used instead of ``ibrowse``
     (which is curses-based) or ``idump`` (which simply does a print).
     """
+
+    def __init__(self, input=None):
+        self.input = input
+
     if wx.VERSION < (2, 7):
         def display(self):
             try:
                 # Try to create a "standalone" from. If this works we're probably
                 # running with -wthread.
                 # Note that this sets the parent of the frame to None, but we can't
                 # pass a result object back to the shell anyway.
                 frame = IGridFrame(None, self.input)
                 frame.Show()
                 frame.Raise()
             except wx.PyNoAppError:
                 # There's no wx application yet => create one.
                 app = App(self.input)
                 app.MainLoop()
                 return app.result
     else:
         # With wx 2.7 it gets simpler.
         def display(self):
             app = App(self.input)
             app.MainLoop()
             return app.result