#!/usr/bin/env python # -* coding: utf-8 -*- """ curses_misc.py: Module for various widgets that are used throughout wicd-curses. """ # Copyright (C) 2008-2009 Andrew Psaltis # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, # MA 02110-1301, USA. import urwid # My savior. :-) # Although I could have made this myself pretty easily, just want to give credit where # its due. # http://excess.org/urwid/browser/contrib/trunk/rbreu_filechooser.py class SelText(urwid.Text): """A selectable text widget. See urwid.Text.""" def selectable(self): """Make widget selectable.""" return True def keypress(self, size, key): """Don't handle any keys.""" return key # This class is annoying. ^_^ class DynWrap(urwid.AttrWrap): """ Makes an object have mutable selectivity. Attributes will change like those in an AttrWrap w = widget to wrap sensitive = current selectable state attrs = tuple of (attr_sens,attr_not_sens) attrfoc = attributes when in focus, defaults to nothing """ def __init__(self,w,sensitive=True,attrs=('editbx','editnfc'),focus_attr='editfc'): self._attrs=attrs self._sensitive = sensitive cur_attr = attrs[0] if sensitive else attrs[1] self.__super.__init__(w,cur_attr,focus_attr) def get_sensitive(self): return self._sensitive def set_sensitive(self,state): if state: self.set_attr(self._attrs[0]) else: self.set_attr(self._attrs[1]) self._sensitive = state property(get_sensitive,set_sensitive) def get_attrs(self): return self._attrs def set_attrs(self,attrs): self._attrs = attrs property(get_attrs,set_attrs) def selectable(self): return self._sensitive class MaskingEditException(Exception): pass # Password-style edit class MaskingEdit(urwid.Edit): """ mask_mode = one of: "always" : everything is a '*' all of the time "on_focus" : everything is a '*' only when not in focus "off" : everything is always unmasked mask_char = the single character that masks all other characters in the field """ def __init__(self, caption = "", edit_text = "", multiline = False, align = 'left', wrap = 'space', allow_tab = False, edit_pos = None, layout=None, mask_mode="masked",mask_char='*'): self.mask_mode = mask_mode if len(mask_char) > 1: raise MaskingEditException('Masks of more than one character are not supported!') self.mask_char = mask_char self.__super.__init__(caption,edit_text,multiline,align,wrap,allow_tab,edit_pos,layout) def get_mask_mode(self): return self.mask_mode def set_mask_mode(self,mode): self.mask_mode = mode def get_masked_text(self): return self.mask_char*len(self.get_edit_text()) def render(self,(maxcol,), focus=False): """ Render edit widget and return canvas. Include cursor when in focus. """ # If we aren't masking anything ATM, then act like an Edit. No problems. if self.mask_mode == "off" or (self.mask_mode == 'on_focus' and focus == True): canv = self.__super.render((maxcol,),focus) # The cache messes this thing up, because I am totally changing what is # displayed. self._invalidate() return canv # Else, we have a slight mess to deal with... self._shift_view_to_cursor = not not focus # force bool text, attr = self.get_text() text = text[:len(self.caption)]+self.get_masked_text() trans = self.get_line_translation( maxcol, (text,attr) ) canv = urwid.canvas.apply_text_layout(text, attr, trans, maxcol) if focus: canv = urwid.CompositeCanvas(canv) canv.cursor = self.get_cursor_coords((maxcol,)) return canv # Tabbed interface, mostly for use in the Preferences Dialog class TabColumns(urwid.WidgetWrap): """ titles_dict = dictionary of tab_contents (a SelText) : tab_widget (box) attr = normal attributes attrsel = attribute when active """ def __init__(self,tab_str,tab_wid,title,bottom_part,attr=('body','focus'), attrsel='tab active', attrtitle='header'): self.bottom_part = bottom_part #title_wid = urwid.Text((attrtitle,title),align='right') column_list = [] for w in tab_str: text,trash = w.get_text() column_list.append(('fixed',len(text),w)) column_list.append(urwid.Text((attrtitle,title),align='right')) self.tab_map = dict(zip(tab_str,tab_wid)) self.active_tab = tab_str[0] self.columns = urwid.Columns(column_list,dividechars=1) #walker = urwid.SimpleListWalker([self.columns,tab_wid[0]]) #self.listbox = urwid.ListBox(walker) self.gen_pile(tab_wid[0],True) self.frame = urwid.Frame(self.pile) self.__super.__init__(self.frame) # Make the pile in the middle def gen_pile(self,lbox,firstrun=False): self.pile = urwid.Pile([ ('fixed',1,urwid.Filler(self.columns,'top')), urwid.Filler(lbox,'top',height=('relative',99)), ('fixed',1,urwid.Filler(self.bottom_part,'bottom')) ]) if not firstrun: self.frame.set_body(self.pile) self.set_w(self.frame) def selectable(self): return True def keypress(self,size,key): self._w.keypress(size,key) if key == "meta left" or key == "meta right": self._w.get_body().set_focus(0) self.keypress(size,key[5:]) self._w.get_body().set_focus(1) else: wid = self.pile.get_focus().get_body() if wid == self.columns: # lw = self.listbox.body # lw.pop(1) self.active_tab.set_attr('body') self.columns.get_focus().set_attr('tab active') self.active_tab = self.columns.get_focus() self.gen_pile(self.tab_map[self.active_tab]) return key # self.listbox.body = lw ### Combo box code begins here class ComboBoxException(Exception): pass # A "combo box" of SelTexts # I based this off of the code found here: # http://excess.org/urwid/browser/contrib/trunk/rbreu_menus.py # This is a hack. It isn't without quirks, but it more or less works. # We need to wait for changes in urwid's Canvas controls before we can actually # make a real ComboBox. class ComboBox(urwid.WidgetWrap): """A ComboBox of text objects""" class ComboSpace(urwid.WidgetWrap): """The actual menu-like space that comes down from the ComboBox""" def __init__(self,list,body,ui,show_first,pos=(0,0),attr=('body','focus')): """ body : parent widget list : stuff to include in the combobox ui : the screen show_first: index of the element in the list to pick first pos : a tuple of (row,col) where to put the list attr : a tuple of (attr_no_focus,attr_focus) """ #Calculate width and height of the menu widget: height = len(list) width = 0 for entry in list: if len(entry) > width: width = len(entry) content = [urwid.AttrWrap(SelText(w), attr[0], attr[1]) for w in list] self._listbox = urwid.ListBox(content) self._listbox.set_focus(show_first) overlay = urwid.Overlay(self._listbox, body, ('fixed left', pos[0]), width + 2, ('fixed top', pos[1]), height) self.__super.__init__(overlay) def show(self,ui,display): dim = ui.get_cols_rows() keys = True #Event loop: while True: if keys: ui.draw_screen(dim, self.render(dim, True)) keys = ui.get_input() if "window resize" in keys: dim = ui.get_cols_rows() if "esc" in keys: return None if "enter" in keys: (wid,pos) = self._listbox.get_focus() (text,attr) = wid.get_text() return text for k in keys: #Send key to underlying widget: self._w.keypress(dim, k) #def get_size(self): def __init__(self,label='',list=[],attrs=('body','editnfc'),focus_attr='focus',use_enter=True,focus=0,callback=None,user_args=None): """ label : bit of text that preceeds the combobox. If it is "", then ignore it list : stuff to include in the combobox body : parent widget ui : the screen row : where this object is to be found onscreen focus : index of the element in the list to pick first callback : function that takes (combobox,sel_index,user_args=None) user_args : user_args in the callback """ self.label = urwid.Text(label) self.attrs = attrs self.focus_attr = focus_attr self.list = list str,trash = self.label.get_text() self.overlay = None #w,sensitive=True,attrs=('editbx','editnfc'),focus_attr='editfc') self.cbox = DynWrap(SelText(' vvv'),attrs=attrs,focus_attr=focus_attr) # Unicode will kill me sooner or later. ^_^ if label != '': w = urwid.Columns([('fixed',len(str),self.label),self.cbox],dividechars=1) else: w = urwid.Columns([self.cbox]) self.__super.__init__(w) # We need this to pick our keypresses self.use_enter = use_enter # The Focus self.focus = focus # The callback and friends self.callback = callback self.user_args = user_args def set_list(self,list): self.list = list def set_focus(self,index): self.focus = index def build_combobox(self,body,ui,row): str,trash = self.label.get_text() self.cbox = DynWrap(SelText([self.list[self.focus]+' vvv']),attrs=self.attrs,focus_attr=self.focus_attr) if str != '': w = urwid.Columns([('fixed',len(str),self.label),self.cbox],dividechars=1) self.overlay = self.ComboSpace(self.list,body,ui,self.focus, pos=(len(str)+1,row)) else: w = urwid.Columns([self.cbox]) self.overlay = self.ComboSpace(self.list,body,ui,self.focus, pos=(0,row)) self.set_w(w) self.body = body self.ui = ui # If we press space or enter, be a combo box! def keypress(self,size,key): activate = key == ' ' if self.use_enter: activate = activate or key == 'enter' if activate: # Die if the user didn't prepare the combobox overlay if self.overlay == None: raise ComboBoxException('ComboBox must be built before use!') retval = self.overlay.show(self.ui,self.body) if retval != None: self.cbox.set_w(SelText(retval+' vvv')) if self.callback != None: self.callback(self,self.overlay._listbox.get_focus()[1],self.user_args) return self._w.keypress(size,key) def selectable(self): return self.cbox.selectable() def get_focus(self): if self.overlay: return self.overlay._listbox.get_focus() else: return None,self.focus def get_sensitive(self): return self.cbox.get_sensitive() def set_sensitive(self,state): self.cbox.set_sensitive(state) # This is a h4x3d copy of some of the code in Ian Ward's dialog.py example. class DialogExit(Exception): pass class Dialog2(urwid.WidgetWrap): def __init__(self, text, height,width, body=None ): self.width = int(width) if width <= 0: self.width = ('relative', 80) self.height = int(height) if height <= 0: self.height = ('relative', 80) self.body = body if body is None: # fill space with nothing body = urwid.Filler(urwid.Divider(),'top') self.frame = urwid.Frame( body, focus_part='footer') if text is not None: self.frame.header = urwid.Pile( [urwid.Text(text,align='right'), urwid.Divider()] ) w = self.frame self.view = w # pad area around listbox #w = urwid.Padding(w, ('fixed left',2), ('fixed right',2)) #w = urwid.Filler(w, ('fixed top',1), ('fixed bottom',1)) #w = urwid.AttrWrap(w, 'body') # buttons: tuple of name,exitcode def add_buttons(self, buttons): l = [] for name, exitcode in buttons: b = urwid.Button( name, self.button_press ) b.exitcode = exitcode b = urwid.AttrWrap( b, 'body','focus' ) l.append( b ) self.buttons = urwid.GridFlow(l, 10, 3, 1, 'center') self.frame.footer = urwid.Pile( [ urwid.Divider(), self.buttons ], focus_item = 1) def button_press(self, button): raise DialogExit(button.exitcode) def run(self,ui,parent): ui.set_mouse_tracking() size = ui.get_cols_rows() overlay = urwid.Overlay(urwid.LineBox(self.view), parent, 'center', self.width, 'middle', self.height) try: while True: canvas = overlay.render( size, focus=True ) ui.draw_screen( size, canvas ) keys = None while not keys: keys = ui.get_input() for k in keys: if urwid.is_mouse_event(k): event, button, col, row = k overlay.mouse_event( size, event, button, col, row, focus=True) if k == 'window resize': size = ui.get_cols_rows() k = self.view.keypress( size, k ) if k == 'esc': raise DialogExit(-1) if k: self.unhandled_key( size, k) except DialogExit, e: return self.on_exit( e.args[0] ) def on_exit(self, exitcode): return exitcode, "" def unhandled_key(self, size, key): pass # Simple dialog with text in it and "OK" class TextDialog(Dialog2): def __init__(self, text, height, width, header=None,align='left'): l = [] for line in text: l.append( urwid.Text( line,align=align)) body = urwid.ListBox(l) body = urwid.AttrWrap(body, 'body') Dialog2.__init__(self, header, height+2, width+2, body) self.add_buttons([('OK',1)]) def unhandled_key(self, size, k): if k in ('up','page up','down','page down'): self.frame.set_focus('body') self.view.keypress( size, k ) self.frame.set_focus('footer') class InputDialog(Dialog2): def __init__(self, text, height, width,ok_name='OK'): self.edit = urwid.Edit(wrap='clip') body = urwid.ListBox([self.edit]) body = urwid.AttrWrap(body, 'editbx','editfc') Dialog2.__init__(self, text, height, width, body) self.frame.set_focus('body') self.add_buttons([(ok_name,0),('Cancel',-1)]) def unhandled_key(self, size, k): if k in ('up','page up'): self.frame.set_focus('body') if k in ('down','page down'): self.frame.set_focus('footer') if k == 'enter': # pass enter to the "ok" button self.frame.set_focus('footer') self.view.keypress( size, k ) def on_exit(self, exitcode): return exitcode, self.edit.get_edit_text()