Extract some common view stuff into a View class.
[matthijs/upstream/mobilegtd.git] / src / gui / gui.py
1 from config.config import *
2 from model.projects import Projects
3
4 import appuifw
5 import thread
6 from log.logging import logger
7 from e32 import Ao_lock, in_emulator
8 from key_codes import *
9 import key_codes
10
11
12 def show_config(cfg):        
13     fields = []
14     for k, v in cfg.items():
15         v = cfg.format_value(v)
16         if isinstance(v, int) or isinstance(v, long):
17             tname = 'number'
18             v = int(v)
19         elif isinstance(v, list) or isinstance(v, tuple):
20             for item in v[0]:
21                 if not isinstance(item, unicode):
22                     raise Exception("list can contain only unicode objects, "\
23                                     "object %r is not supported" % item)
24             
25             tname = 'combo'
26         elif isinstance(v, unicode):
27             tname = 'text'
28         else:
29             raise Exception("%s has non-supported value" % k)
30
31         fields.append((unicode(k), tname, v))
32
33
34     form = appuifw.Form(fields=fields, flags=appuifw.FFormEditModeOnly | \
35                         appuifw.FFormDoubleSpaced)
36
37     saved = [False]
38     def save_hook(param):
39         saved[0] = True
40     form.save_hook = save_hook
41     
42     form.execute()
43
44     # return true if user saved, false otherwise
45     if not saved[0]:
46         return False
47     
48     for label, tname, value in form:
49         if tname == 'combo':
50             value = (value[0], int(value[1]))
51
52         cfg[str(label)] = cfg.parse_value(value)
53
54     return True
55
56
57 def no_action():
58     pass
59
60 def applicable_functions(obj,allowed_function_names):
61     function_names = [function_name for function_name in dir(obj) if function_name in allowed_function_names]
62     return [eval('obj.%s'%function_name) for function_name in function_names]
63
64 def get_key(key_name):
65     if key_name == '':
66         key = None
67     else:
68         key=eval('EKey%s'%key_name)
69     return key
70
71 def all_key_names():
72     return filter(lambda entry:entry[0:4]=='EKey',dir(key_codes))
73 def all_key_values():
74     key_values=[
75                 EKey0,
76                 EKey1,
77                 EKey2,
78                 EKey3,
79                 EKey4,
80                 EKey5,
81                 EKey6,
82                 EKey7,
83                 EKey8,
84                 EKey9,
85                 EKeyStar,
86                 EKeyHash,
87                 ]
88     return key_values
89
90
91 def save_gui(object):
92     object.old_gui = appuifw.app.body
93     object.old_menu = appuifw.app.menu
94     object.old_exit_key_handler = appuifw.app.exit_key_handler
95     object.old_title=appuifw.app.title
96
97 def restore_gui(object):
98     appuifw.app.body = object.old_gui
99     appuifw.app.menu = object.old_menu
100     appuifw.app.exit_key_handler = object.old_exit_key_handler
101     appuifw.app.title = object.old_title
102
103 class View(object):
104     def __init__(self):
105         self.title = None
106         self.view = None
107         self.lock = Ao_lock()
108         self.exit_flag = False
109         super(View, self).__init__()
110
111     def set_title(self, title):
112         self.title = title
113    
114     def set_view(self, view):
115         """
116         Sets the main view to be displayed (e.g., an appuifw.Listbox
117         instance).
118         """
119         self.view = view
120
121     def run(self):
122         self.adjustment = None
123         save_gui(self)
124         appuifw.app.screen=COMMON_CONFIG['screen'].encode('utf-8')
125         appuifw.app.title=self.title
126         appuifw.app.body=self.view
127         appuifw.app.exit_key_handler=self.exit
128         try:
129             self.lock.wait()
130             while not self.exit_flag:
131                 self.refresh()
132                 self.lock.wait()
133         except:
134             pass
135         restore_gui(self)
136
137     def exit(self):
138         self.exit_flag = True
139         self.lock.signal()
140         super(View, self).exit()
141
142     def refresh(self):
143         """
144         Update the gui after a change in model or some user interaction.
145         Should be filled by subclasses.
146         """
147         super(View, self).refresh()
148
149 class ListView(View):
150     def __init__(self):
151         super(ListView, self).__init__()
152         self.set_view(appuifw.Listbox(self.items(),self.change_entry))
153
154     def change_entry(self):
155         pass
156     
157     def update(self,subject=None):
158         #logger.log(u'Updated %s'%repr(self))
159         if self.lock:
160             self.lock.signal()
161         #pass
162
163     def index_changed(self,adjustment=None):
164         if adjustment:
165             index = self.selected_index() + adjustment
166         else:
167             index = self.selected_index()
168         if index < 0:
169             index = len(self.widgets) - 1
170         if index >= len(self.widgets):
171             index = 0
172         self.set_bindings_for_selection(index)
173
174     def refresh(self):
175         appuifw.app.menu=self.get_menu_entries()
176
177     def set_index(self,index):
178         if index > len(self.widgets):
179             index = len(self.widgets)
180         if index < 0:
181             index = 0
182         self.view.set_list(self.items(),index)
183
184     def selected_index(self):
185         return self.view.current()
186
187
188 class WidgetBasedListView(ListView):
189     def __init__(self):
190         self.widgets = self.generate_widgets()
191         super(WidgetBasedListView,self).__init__()
192
193     def run(self):
194         self.refresh()
195         self.set_bindings_for_selection(0)
196         ListView.run(self)
197
198     def notify(self,object,attribute,new=None,old=None):
199         self.refresh()
200     def refresh(self):
201         self.widgets = self.generate_widgets()
202         self.redisplay_widgets()
203         super(WidgetBasedListView,self).refresh()
204     def redisplay_widgets(self):
205         self.set_index(self.selected_index())
206     def items(self):
207         return self.all_widget_texts()
208     def all_widget_texts(self):
209         return [entry.list_repr() for entry in self.widgets]
210
211     
212
213     def current_widget(self):
214         return self.widgets[self.selected_index()]
215         
216
217 class KeyBindingView(object):
218     
219     def __init__(self):
220         self.binding_map = {}
221         super(KeyBindingView,self).__init__()
222
223     def set_keybindings(self, binding_map):
224         """
225         Set a new map of key bindings. This map maps method names to a
226         tuple of keyname and description.
227
228         The method name refers to a method on the selected item, or the
229         current view.
230
231         Example: { 'search_item' : ('0', 'Search item') }
232
233         """
234         self.binding_map = binding_map
235
236     def get_menu_entries(self):
237         menu_entries=[]
238         for key,key_name,description,function in self.key_and_menu_bindings(self.selected_index()):
239             if description != '':
240                 if key:
241                     if key_name == 'Backspace': key_name='C'
242                     description='[%s] '%key_name +description
243                 else:
244                     description='    '+description
245                 menu_entries.append((description,function)) 
246         menu_entries.append((u'Exit', self.exit))
247         return menu_entries       
248     def set_bindings_for_selection(self,selected_index):
249         self.remove_all_key_bindings()
250         
251         for key,key_name,description,function in self.key_and_menu_bindings(selected_index):
252             if key:
253                 self.view.bind(key,function)
254         self.view.bind(EKeyUpArrow,lambda: self.index_changed(-1))
255         self.view.bind(EKeyDownArrow,lambda: self.index_changed(1))
256         
257     def remove_all_key_bindings(self):
258         for key in all_key_values():
259             self.view.bind(key,no_action)
260
261 class SearchableListView(WidgetBasedListView):
262     def __init__(self):
263         self.current_entry_filter_index = -1
264         self.entry_filters = []
265         self.filtered_list = lambda:[]
266         self.lock = None
267         super(SearchableListView,self).__init__()
268
269     def set_filters(self, entry_filters):
270         """
271         Set the filters that could be applied to this list. Each filter
272         can be applied in turn by calling switch_entry_filter (for
273         example from a key binding).
274
275         The entry_filters argument should be a list of filters. The
276         active filter is stored into self.filtered_list and should be
277         processed by generate_widgets in the subclass.
278         """
279         self.current_entry_filter_index = 0
280         self.entry_filters = entry_filters
281         self.filtered_list = self.entry_filters[0]
282
283     def search_item(self):
284         selected_item = appuifw.selection_list(self.all_widget_texts(),search_field=1)
285         if selected_item == None or selected_item == -1:
286             selected_item = self.selected_index()
287         self.view.set_list(self.items(),selected_item)
288         self.set_bindings_for_selection(selected_item)
289
290     def switch_entry_filter(self):
291         self.current_entry_filter_index += 1
292         self.filtered_list = self.entry_filters[self.current_entry_filter_index % len(self.entry_filters)]
293         self.refresh()
294
295
296 class EditableListView(SearchableListView,KeyBindingView):
297     def __init__(self):
298         super(EditableListView, self).__init__()
299
300     def key_and_menu_bindings(self,selected_index):
301         key_and_menu_bindings=[]
302         for function in applicable_functions(self.widgets[selected_index],self.binding_map)+\
303             applicable_functions(self,self.binding_map):
304             execute_and_update_function = self.execute_and_update(function)
305             (key,description) = self.binding_map[function.__name__]
306             key_and_menu_bindings.append((get_key(key),key,description,execute_and_update_function))
307         return key_and_menu_bindings
308
309     def change_entry(self):
310         self.current_widget().change()
311         self.refresh()
312     def execute_and_update(self,function):
313         return lambda: (function(),self.refresh(),self.index_changed())
314
315     def notify(self,item,attribute,new=None,old=None):
316         self.refresh()
317
318 #class DisplayableFunction:
319 #    def __init__(self,display_name,function):
320 #        self.display_name = display_name
321 #        self.function = function
322 #    def list_repr(self):
323 #        return self.display_name
324 #    def execute(self):
325 #        function()
326
327 # Public API
328 __all__= ('EditableListView','show_config')