Module Gnumed.wxpython.gmDateTimeInput
GNUmed date input widget
All GNUmed date input should happen via classes in this module.
@copyright: author(s)
Classes
class cCalendarDatePickerDlg (parent)-
Expand source code
class cCalendarDatePickerDlg(wx.Dialog): """Shows a calendar control from which the user can pick a date.""" def __init__(self, parent): wx.Dialog.__init__(self, parent, title = _('Pick a date ...')) panel = wx.Panel(self, -1) sizer = wx.BoxSizer(wx.VERTICAL) panel.SetSizer(sizer) cal = wxcal.CalendarCtrl(panel) if sys.platform != 'win32': # gtk truncates the year - this fixes it w, h = cal.Size cal.Size = (w+25, h) cal.MinSize = cal.Size sizer.Add(cal, 0) button_sizer = wx.BoxSizer(wx.HORIZONTAL) button_sizer.Add((0, 0), 1) btn_ok = wx.Button(panel, wx.ID_OK) btn_ok.SetDefault() button_sizer.Add(btn_ok, 0, wx.ALL, 2) button_sizer.Add((0, 0), 1) btn_can = wx.Button(panel, wx.ID_CANCEL) button_sizer.Add(btn_can, 0, wx.ALL, 2) button_sizer.Add((0, 0), 1) sizer.Add(button_sizer, 1, wx.EXPAND | wx.ALL, 10) sizer.Fit(panel) self.ClientSize = panel.Size cal.Bind(wx.EVT_KEY_DOWN, self.__on_key_down) cal.SetFocus() self.cal = cal #----------------------------------------------------------- def __on_key_down(self, evt): code = evt.KeyCode if code == wx.WXK_TAB: self.cal.Navigate() elif code in (wx.WXK_RETURN, wx.WXK_NUMPAD_ENTER): self.EndModal(wx.ID_OK) elif code == wx.WXK_ESCAPE: self.EndModal(wx.ID_CANCEL) else: evt.Skip()Shows a calendar control from which the user can pick a date.
Ancestors
- wx._core.Dialog
- wx._core.TopLevelWindow
- wx._core.NonOwnedWindow
- wx._core.Window
- wx._core.WindowBase
- wx._core.EvtHandler
- wx._core.Object
- wx._core.Trackable
- sip.wrapper
- sip.simplewrapper
class cDateInputPhraseWheel (*args, **kwargs)-
Expand source code
class cDateInputPhraseWheel(gmPhraseWheel.cPhraseWheel): def __init__(self, *args, **kwargs): gmPhraseWheel.cPhraseWheel.__init__(self, *args, **kwargs) self.matcher = cDateMatchProvider() self.phrase_separators = None self.static_tooltip_extra = _('<ALT-C/K>: pick from (c/k)alendar') self.__weekday_keys = [wx.WXK_F1, wx.WXK_F2, wx.WXK_F3, wx.WXK_F4, wx.WXK_F5, wx.WXK_F6, wx.WXK_F7] #-------------------------------------------------------- # internal helpers #-------------------------------------------------------- # def __text2timestamp(self): # # self._update_candidates_in_picklist(val = self.GetValue().strip()) # # if len(self._current_match_candidates) == 1: # return self._current_match_candidates[0]['data'] # # return None #-------------------------------------------------------- def __pick_from_calendar(self): dlg = cCalendarDatePickerDlg(self) # FIXME: show below parent dlg.CentreOnScreen() decision = dlg.ShowModal() date = dlg.cal.Date dlg.DestroyLater() if decision != wx.ID_OK: return if date is None: return if not date.IsValid(): return date = gmDateTime.wxDate2py_dt(wxDate = date).replace ( hour = 11, minute = 11, second = 11, microsecond = 111111 ) val = date.strftime('%Y-%m-%d') self.SetText(value = val, data = date, suppress_smarts = True) #-------------------------------------------------------- def __pick_from_weekday(self, weekday): self.is_valid_timestamp(empty_is_valid = True) target_date = gmDateTime.get_date_of_weekday_in_week_of_date(weekday, base_dt = self.date) val = target_date.strftime('%Y-%m-%d') self.SetText(value = val, data = target_date, suppress_smarts = True) #-------------------------------------------------------- # phrasewheel internal API #-------------------------------------------------------- def _on_lose_focus(self, event): # no valid date yet ? if len(self._data) == 0: self._set_data_to_first_match() date = self.GetData() if date is not None: self.SetValue(date.strftime('%Y-%m-%d')) # let the base class do its thing super(cDateInputPhraseWheel, self)._on_lose_focus(event) #-------------------------------------------------------- def _picklist_item2display_string(self, item=None): data = item['data'] if data is not None: return data.strftime('%Y-%m-%d') return item['field_label'] #-------------------------------------------------------- def _on_key_down(self, event): if event.GetUnicodeKey() == wx.WXK_NONE: key = event.GetKeyCode() if key in self.__weekday_keys: self.__pick_from_weekday(self.__weekday_keys.index(key)) return # <ALT-C> / <ALT-K> -> calendar if event.AltDown() is True: char = chr(event.GetUnicodeKey()) if char in 'ckCK': self.__pick_from_calendar() return super()._on_key_down(event) #-------------------------------------------------------- def _get_data_tooltip(self): if len(self._data) == 0: return '' date = self.GetData() # if match provider only provided completions # but not a full date with it if date is None: return '' if isinstance(date, pyDT.datetime): date = pyDT.date(date.year, date.month, date.day) today = pyDT.date.today() if date > today: intv = date - today return _('%s\n (a %s in %s)') % ( date.strftime(format = '%B %d %Y -- %x'), date.strftime(format = '%A'), gmDateTime.format_interval(interval = intv, accuracy_wanted = gmDateTime.ACC_DAYS, verbose = True) ) if date < today: intv = today - date return _('%s\n (a %s %s ago)') % ( date.strftime('%B %d %Y -- %x'), date.strftime('%A'), gmDateTime.format_interval(interval = intv, accuracy_wanted = gmDateTime.ACC_DAYS, verbose = True) ) return _('today (%s): %s') % ( date.strftime('%A'), date.strftime('%B %d %Y -- %x') ) #-------------------------------------------------------- # external API #-------------------------------------------------------- def SetValue(self, value): if isinstance(value, pyDT.datetime): date = value.replace ( hour = 11, minute = 11, second = 11, microsecond = 111111 ) self.SetText(data = date, suppress_smarts = True) return if value is None: value = '' super().SetValue(value) #-------------------------------------------------------- def SetText(self, value='', data=None, suppress_smarts=False): if data is not None: if isinstance(data, gmDateTime.cFuzzyTimestamp): data = data.timestamp.replace ( hour = 11, minute = 11, second = 11, microsecond = 111111 ) if value.strip() == '': value = data.strftime('%Y-%m-%d') super().SetText(value = value, data = data, suppress_smarts = suppress_smarts) #-------------------------------------------------------- def SetData(self, data=None): if data is None: gmPhraseWheel.cPhraseWheel.SetText(self, '', None) return self.SetText(data = data) #-------------------------------------------------------- def GetData(self): if len(self._data) == 0: self._set_data_to_first_match() return super().GetData() #-------------------------------------------------------- def is_valid_timestamp(self, empty_is_valid=True): if len(self._data) > 0: self.display_as_valid(True) return True if self.GetValue().strip() == '': if empty_is_valid: self.display_as_valid(True) return True else: self.display_as_valid(False) return False # skip showing calendar on '*' from here if self.GetValue().strip() == '*': self.display_as_valid(False) return False # try to auto-snap to first match self._set_data_to_first_match() if len(self._data) == 0: self.display_as_valid(False) return False date = self.GetData() self.SetValue(date.strftime('%Y-%m-%d')) self.display_as_valid(True) return True #-------------------------------------------------------- # properties #-------------------------------------------------------- def _get_date(self): return self.GetData() def _set_date(self, date): raise AttributeError('._set_date not implemented') # val = date.strftime('%Y-%m-%d') # self.data = date.replace ( # hour = 11, # minute = 11, # second = 11, # microsecond = 111111 # ) date = property(_get_date, _set_date)Standard single-value Phrasewheel.
Ancestors
- cPhraseWheel
- cPhraseWheelBase
- wx._core.TextCtrl
- wx._core.Control
- wx._core.Window
- wx._core.WindowBase
- wx._core.EvtHandler
- wx._core.Object
- wx._core.Trackable
- wx._core.TextEntry
- sip.wrapper
- sip.simplewrapper
Instance variables
prop date-
Expand source code
def _get_date(self): return self.GetData()
Methods
def SetValue(self, value)-
Expand source code
def SetValue(self, value): if isinstance(value, pyDT.datetime): date = value.replace ( hour = 11, minute = 11, second = 11, microsecond = 111111 ) self.SetText(data = date, suppress_smarts = True) return if value is None: value = '' super().SetValue(value)SetValue(value)
Sets the new text control value.
def is_valid_timestamp(self, empty_is_valid=True)-
Expand source code
def is_valid_timestamp(self, empty_is_valid=True): if len(self._data) > 0: self.display_as_valid(True) return True if self.GetValue().strip() == '': if empty_is_valid: self.display_as_valid(True) return True else: self.display_as_valid(False) return False # skip showing calendar on '*' from here if self.GetValue().strip() == '*': self.display_as_valid(False) return False # try to auto-snap to first match self._set_data_to_first_match() if len(self._data) == 0: self.display_as_valid(False) return False date = self.GetData() self.SetValue(date.strftime('%Y-%m-%d')) self.display_as_valid(True) return True
Inherited members
class cDateMatchProvider-
Expand source code
class cDateMatchProvider(gmMatchProvider.cMatchProvider): """Turns strings into candidate dates. Matching on "all" (*, '') will pop up a calendar :-) """ def __init__(self): gmMatchProvider.cMatchProvider.__init__(self) self.setThresholds(aPhrase = 1, aWord = 998, aSubstring = 999) self.word_separators = None # self.ignored_chars("""[?!."'\\(){}\[\]<>~#*$%^_]+""") #-------------------------------------------------------- # external API #-------------------------------------------------------- #-------------------------------------------------------- # base class API #-------------------------------------------------------- # internal matching algorithms # # if we end up here: # - aFragment will not be "None" # - aFragment will be lower case # - we _do_ deliver matches (whether we find any is a different story) #-------------------------------------------------------- def getMatchesByPhrase(self, aFragment): """Return matches for aFragment at start of phrases.""" matches = gmDateTime.str2pydt_matches(str2parse = aFragment.strip()) if len(matches) == 0: return (False, []) items = [] for match in matches: if match['data'] is None: items.append ({ 'data': None, 'field_label': match['label'], 'list_label': match['label'] }) continue data = match['data'].replace ( hour = 11, minute = 11, second = 11, microsecond = 111111 ) list_label = data.strftime('%A, %d. %B %Y (%x)') items.append ({ 'data': data, 'field_label': match['label'], 'list_label': list_label }) return (True, items) #-------------------------------------------------------- def getMatchesByWord(self, aFragment): """Return matches for aFragment at start of words inside phrases.""" return self.getMatchesByPhrase(aFragment) #-------------------------------------------------------- def getMatchesBySubstr(self, aFragment): """Return matches for aFragment as a true substring.""" return self.getMatchesByPhrase(aFragment) #-------------------------------------------------------- def getAllMatches(self): """Return all items.""" matches = (False, []) return matchesTurns strings into candidate dates.
Matching on "all" (*, '') will pop up a calendar :-)
Ancestors
Methods
def getAllMatches(self)-
Expand source code
def getAllMatches(self): """Return all items.""" matches = (False, []) return matchesReturn all items.
def getMatchesByPhrase(self, aFragment)-
Expand source code
def getMatchesByPhrase(self, aFragment): """Return matches for aFragment at start of phrases.""" matches = gmDateTime.str2pydt_matches(str2parse = aFragment.strip()) if len(matches) == 0: return (False, []) items = [] for match in matches: if match['data'] is None: items.append ({ 'data': None, 'field_label': match['label'], 'list_label': match['label'] }) continue data = match['data'].replace ( hour = 11, minute = 11, second = 11, microsecond = 111111 ) list_label = data.strftime('%A, %d. %B %Y (%x)') items.append ({ 'data': data, 'field_label': match['label'], 'list_label': list_label }) return (True, items)Return matches for aFragment at start of phrases.
def getMatchesBySubstr(self, aFragment)-
Expand source code
def getMatchesBySubstr(self, aFragment): """Return matches for aFragment as a true substring.""" return self.getMatchesByPhrase(aFragment)Return matches for aFragment as a true substring.
def getMatchesByWord(self, aFragment)-
Expand source code
def getMatchesByWord(self, aFragment): """Return matches for aFragment at start of words inside phrases.""" return self.getMatchesByPhrase(aFragment)Return matches for aFragment at start of words inside phrases.
Inherited members
class cFuzzyTimestampInput (*args, **kwargs)-
Expand source code
class cFuzzyTimestampInput(gmPhraseWheel.cPhraseWheel): def __init__(self, *args, **kwargs): gmPhraseWheel.cPhraseWheel.__init__(self, *args, **kwargs) self.matcher = cMatchProvider_FuzzyTimestamp() self.phrase_separators = None self.selection_only = True self.selection_only_error_msg = _('Cannot interpret input as timestamp.') self.display_accuracy = None # index 0 resp weekday 0 maps to Sunday, hence, offset K_F1 to index 1 ... self.__weekday_keys = [-1, wx.WXK_F1, wx.WXK_F2, wx.WXK_F3, wx.WXK_F4, wx.WXK_F5, wx.WXK_F6, wx.WXK_F7] #-------------------------------------------------------- # internal helpers #-------------------------------------------------------- def __text2timestamp(self, val=None): if val is None: val = self.GetValue() val = val.strip() if val == '': return None success, matches = self.matcher.getMatchesByPhrase(val) if len(matches) == 1: return matches[0]['data'] return None #-------------------------------------------------------- def __pick_from_weekday(self, weekday): self.is_valid_timestamp(empty_is_valid = True) dt = self.GetData() if dt is not None: dt = dt.timestamp target_date = gmDateTime.get_date_of_weekday_in_week_of_date(weekday, base_dt = dt) self.SetText(data = target_date, suppress_smarts = True) #-------------------------------------------------------- # phrasewheel internal API #-------------------------------------------------------- def _on_lose_focus(self, event): # are we valid ? if not self.raw_data: # no, so try date = self.__text2timestamp() if date is not None: self.SetValue(value = date.format_accurately(accuracy = self.display_accuracy)) self.data = date # let the base class do its thing gmPhraseWheel.cPhraseWheel._on_lose_focus(self, event) #-------------------------------------------------------- def _picklist_item2display_string(self, item=None): data = item['data'] if data is not None: return data.format_accurately(accuracy = self.display_accuracy) return item['field_label'] #-------------------------------------------------------- def _on_key_down(self, event): if event.GetUnicodeKey() == wx.WXK_NONE: key = event.GetKeyCode() if key in self.__weekday_keys: self.__pick_from_weekday(self.__weekday_keys.index(key)) return # # <ALT-C> / <ALT-K> -> calendar # if event.AltDown() is True: # char = chr(event.GetUnicodeKey()) # if char in 'ckCK': # self.__pick_from_calendar() # return super()._on_key_down(event) #-------------------------------------------------------- def _get_data_tooltip(self): if len(self._data) == 0: return '' date = self.GetData() # if match provider only provided completions # but not a full date with it if date is None: return '' ts = date.timestamp now = gmDateTime.pydt_now_here() if ts > now: intv = ts - now template = _('%s\n %s\n in %s') else: intv = now - ts template = _('%s\n%s\n%s ago') txt = template % ( date.format_accurately(self.display_accuracy), ts.strftime('%A, %B-%d %Y (%c)'), gmDateTime.format_interval ( interval = intv, accuracy_wanted = gmDateTime.ACC_DAYS, verbose = True ) ) return txt #-------------------------------------------------------- # external API #-------------------------------------------------------- def SetText(self, value='', data=None, suppress_smarts=False): if data is not None: if isinstance(data, pyDT.datetime): data = gmDateTime.cFuzzyTimestamp(timestamp = data) if value.strip() == '': value = data.format_accurately(accuracy = self.display_accuracy) super().SetText(value = value, data = data, suppress_smarts = suppress_smarts) #-------------------------------------------------------- def SetData(self, data=None): if data is None: gmPhraseWheel.cPhraseWheel.SetText(self, '', None) else: if isinstance(data, pyDT.datetime): data = gmDateTime.cFuzzyTimestamp(timestamp=data) gmPhraseWheel.cPhraseWheel.SetText(self, value = data.format_accurately(accuracy = self.display_accuracy), data = data) #-------------------------------------------------------- def is_valid_timestamp(self, empty_is_valid=True): if self.GetData() is not None: return True # skip empty value if self.GetValue().strip() == '': if empty_is_valid: return True return False date = self.__text2timestamp() if date is None: return False self.SetText ( value = date.format_accurately(accuracy = self.display_accuracy), data = date, suppress_smarts = True ) return TrueStandard single-value Phrasewheel.
Ancestors
- cPhraseWheel
- cPhraseWheelBase
- wx._core.TextCtrl
- wx._core.Control
- wx._core.Window
- wx._core.WindowBase
- wx._core.EvtHandler
- wx._core.Object
- wx._core.Trackable
- wx._core.TextEntry
- sip.wrapper
- sip.simplewrapper
Methods
def is_valid_timestamp(self, empty_is_valid=True)-
Expand source code
def is_valid_timestamp(self, empty_is_valid=True): if self.GetData() is not None: return True # skip empty value if self.GetValue().strip() == '': if empty_is_valid: return True return False date = self.__text2timestamp() if date is None: return False self.SetText ( value = date.format_accurately(accuracy = self.display_accuracy), data = date, suppress_smarts = True ) return True
Inherited members
class cIntervalPhraseWheel (*args, **kwargs)-
Expand source code
class cIntervalPhraseWheel(gmPhraseWheel.cPhraseWheel): def __init__(self, *args, **kwargs): gmPhraseWheel.cPhraseWheel.__init__(self, *args, **kwargs) self.phrase_separators = None self.display_accuracy = None #-------------------------------------------------------- # phrasewheel internal API #-------------------------------------------------------- def _update_candidates_in_picklist(self, val): intv = gmDateTime.str2interval(str_interval = val) if intv is None: self._current_match_candidates = [] else: self._current_match_candidates = [{ 'data': intv, 'field_label': gmDateTime.format_interval(intv, gmDateTime.ACC_MINUTES), 'list_label': gmDateTime.format_interval(intv, gmDateTime.ACC_MINUTES) }] self._picklist.SetItems(self._current_match_candidates) #--------------------------------------------------------- # def _on_lose_focus(self, event): # # are we valid ? # if len(self._data) == 0: # self._set_data_to_first_match() # # # let the base class do its thing # super(cIntervalPhraseWheel, self)._on_lose_focus(event) #-------------------------------------------------------- def _picklist_item2display_string(self, item=None): intv = item['data'] if intv is not None: return gmDateTime.format_interval ( interval = intv, accuracy_wanted = self.display_accuracy ) return item['field_label'] #-------------------------------------------------------- def _get_data_tooltip(self): intv = self.GetData() if intv is None: return '' return gmDateTime.format_interval ( interval = intv, accuracy_wanted = self.display_accuracy ) #-------------------------------------------------------- # external API #-------------------------------------------------------- def SetValue(self, value): if isinstance(value, pyDT.timedelta): self.SetText(data = value, suppress_smarts = True) return if value is None: value = '' super(cIntervalPhraseWheel, self).SetValue(value) #-------------------------------------------------------- def SetText(self, value='', data=None, suppress_smarts=False): if data is not None: if value.strip() == '': value = gmDateTime.format_interval ( interval = data, accuracy_wanted = self.display_accuracy ) super(cIntervalPhraseWheel, self).SetText(value = value, data = data, suppress_smarts = suppress_smarts) #-------------------------------------------------------- def SetData(self, data=None): if data is None: super(cIntervalPhraseWheel, self).SetText('', None) return value = gmDateTime.format_interval ( interval = data, accuracy_wanted = self.display_accuracy ) super(cIntervalPhraseWheel, self).SetText(value = value, data = data) #-------------------------------------------------------- def GetData(self): if len(self._data) == 0: self._set_data_to_first_match() return super(cIntervalPhraseWheel, self).GetData()Standard single-value Phrasewheel.
Ancestors
- cPhraseWheel
- cPhraseWheelBase
- wx._core.TextCtrl
- wx._core.Control
- wx._core.Window
- wx._core.WindowBase
- wx._core.EvtHandler
- wx._core.Object
- wx._core.Trackable
- wx._core.TextEntry
- sip.wrapper
- sip.simplewrapper
Methods
def SetValue(self, value)-
Expand source code
def SetValue(self, value): if isinstance(value, pyDT.timedelta): self.SetText(data = value, suppress_smarts = True) return if value is None: value = '' super(cIntervalPhraseWheel, self).SetValue(value)SetValue(value)
Sets the new text control value.
Inherited members
class cMatchProvider_FuzzyTimestamp-
Expand source code
class cMatchProvider_FuzzyTimestamp(gmMatchProvider.cMatchProvider): def __init__(self): self.__allow_past = 1 self.__shifting_base = None gmMatchProvider.cMatchProvider.__init__(self) self.setThresholds(aPhrase = 1, aWord = 998, aSubstring = 999) self.word_separators = None # self.ignored_chars("""[?!."'\\(){}\[\]<>~#*$%^_]+""") #-------------------------------------------------------- # external API #-------------------------------------------------------- #-------------------------------------------------------- # base class API #-------------------------------------------------------- # internal matching algorithms # # if we end up here: # - aFragment will not be "None" # - aFragment will be lower case # - we _do_ deliver matches (whether we find any is a different story) #-------------------------------------------------------- def getMatchesByPhrase(self, aFragment): """Return matches for aFragment at start of phrases.""" matches = gmDateTime.str2fuzzy_timestamp_matches(aFragment.strip()) if len(matches) == 0: return (False, []) items = [] for match in matches: items.append ({ 'data': match['data'], 'field_label': match['label'], 'list_label': match['label'] }) return (True, items) #-------------------------------------------------------- def getMatchesByWord(self, aFragment): """Return matches for aFragment at start of words inside phrases.""" return self.getMatchesByPhrase(aFragment) #-------------------------------------------------------- def getMatchesBySubstr(self, aFragment): """Return matches for aFragment as a true substring.""" return self.getMatchesByPhrase(aFragment) #-------------------------------------------------------- def getAllMatches(self): """Return all items.""" return (False, [])Base class for match providing objects.
Match sources might be: - database tables - flat files - previous input - config files - in-memory list created on the fly
Ancestors
Methods
def getAllMatches(self)-
Expand source code
def getAllMatches(self): """Return all items.""" return (False, [])Return all items.
def getMatchesByPhrase(self, aFragment)-
Expand source code
def getMatchesByPhrase(self, aFragment): """Return matches for aFragment at start of phrases.""" matches = gmDateTime.str2fuzzy_timestamp_matches(aFragment.strip()) if len(matches) == 0: return (False, []) items = [] for match in matches: items.append ({ 'data': match['data'], 'field_label': match['label'], 'list_label': match['label'] }) return (True, items)Return matches for aFragment at start of phrases.
def getMatchesBySubstr(self, aFragment)-
Expand source code
def getMatchesBySubstr(self, aFragment): """Return matches for aFragment as a true substring.""" return self.getMatchesByPhrase(aFragment)Return matches for aFragment as a true substring.
def getMatchesByWord(self, aFragment)-
Expand source code
def getMatchesByWord(self, aFragment): """Return matches for aFragment at start of words inside phrases.""" return self.getMatchesByPhrase(aFragment)Return matches for aFragment at start of words inside phrases.
Inherited members