mwxlib 1.0.0__py3-none-any.whl → 1.7.13__py3-none-any.whl

mwx/wxmon.py

@@ -13,11 +13,11 @@ from .framework import CtrlInterface, Menu
 
 
 class EventMonitor(wx.ListCtrl, ListCtrlAutoWidthMixin, CtrlInterface):
-    """Event monitor
+    """Event monitor.
     
     Attributes:
-        parent : shellframe
-        target : widget to monitor
+        parent: shellframe
+        target: widget to monitor
     """
     def __init__(self, parent, **kwargs):
         wx.ListCtrl.__init__(self, parent,
@@ -29,11 +29,11 @@ class EventMonitor(wx.ListCtrl, ListCtrlAutoWidthMixin, CtrlInterface):
         
         self.parent = parent
         self.target = None
-        self._target = None # previous target
+        self._target = None  # previous target
         
         self.Font = wx.Font(9, wx.DEFAULT, wx.NORMAL, wx.NORMAL)
         
-        self.__dir = True # sort direction
+        self.__dir = True  # sort direction
         self.__items = []
         
         _alist = (
@@ -65,7 +65,7 @@ class EventMonitor(wx.ListCtrl, ListCtrlAutoWidthMixin, CtrlInterface):
         @self.handler.bind('C-c pressed')
         def copy(evt):
             self.copy()
-    
+
     def OnDestroy(self, evt):
         if evt.EventObject is self:
             try:
@@ -73,41 +73,42 @@ class EventMonitor(wx.ListCtrl, ListCtrlAutoWidthMixin, CtrlInterface):
             except Exception as e:
                 print(e)
         evt.Skip()
-    
+
     def OnSetFocus(self, evt):
         title = "{} target: {}".format(self.__class__.__name__, self.target)
         self.parent.handler('title_window', title)
         evt.Skip()
-    
+
     ## --------------------------------
-    ## EventWatcher wrapper interface
+    ## EventWatcher wrapper interface.
     ## --------------------------------
-    ew.buildWxEventMap() # build ew._eventBinders and ew._eventIdMap
-    
+    ew.buildWxEventMap()  # build ew._eventBinders and ew._eventIdMap
+
     @staticmethod
     def get_name(event):
         return ew._eventIdMap.get(event, 'Unknown')
-    
+
     @staticmethod
     def get_binder(event):
         return next(x for x in ew._eventBinders if x.typeId == event)
-    
+
     @staticmethod
     def get_watchlist():
         """All watched event binders except noWatchList."""
         return (x for x in ew._eventBinders if x not in ew._noWatchList)
-    
+
     def watch(self, widget=None):
         """Begin watching the widget."""
         self.unwatch()
         self.clear()
         if widget is None:
-            widget = self._target # Resume watching the previous target.
+            widget = self._target  # Resume watching the previous target.
         if not widget:
             return
         if not isinstance(widget, wx.Object):
             wx.MessageBox("Cannot watch the widget.\n\n"
-                          "- {!r} is not a wx.Object.".format(widget))
+                          "- {!r} is not a wx.Object.".format(widget),
+                          self.__module__)
             return
         self._target = widget
         self.target = widget
@@ -123,7 +124,7 @@ class EventMonitor(wx.ListCtrl, ListCtrlAutoWidthMixin, CtrlInterface):
                 print(" #{:6d}:{:32s}{!s}".format(event, name, e))
                 continue
         self.parent.handler('monitor_begin', widget)
-    
+
     def unwatch(self):
         """End watching the widget."""
         widget = self.target
@@ -134,12 +135,12 @@ class EventMonitor(wx.ListCtrl, ListCtrlAutoWidthMixin, CtrlInterface):
                 print("- Failed to unbind {}: {}".format(binder.typeId, widget))
         self.parent.handler('monitor_end', widget)
         self.target = None
-    
+
     def onWatchedEvent(self, evt):
         if self:
             self.update(evt)
         evt.Skip()
-    
+
     def dump(self, widget, verbose=True):
         """Dump all event handlers bound to the widget."""
         ## Note: This will not work unless [Monkey-patch for wx.core] is applied.
@@ -159,15 +160,15 @@ class EventMonitor(wx.ListCtrl, ListCtrlAutoWidthMixin, CtrlInterface):
         except AttributeError:
             pass
         return ssmap
-    
+
     ## --------------------------------
-    ## Actions on list items
+    ## Actions on list items.
     ## --------------------------------
-    
+
     def clear(self):
         self.DeleteAllItems()
         del self.__items[:]
-    
+
     def update(self, evt):
         event = evt.EventType
         obj = evt.EventObject
@@ -178,7 +179,7 @@ class EventMonitor(wx.ListCtrl, ListCtrlAutoWidthMixin, CtrlInterface):
             with ignore(DeprecationWarning):
                 attribs = ew._makeAttribString(evt)
         except Exception:
-            attribs = '' # Failed to get event attributes; possibly <BdbQuit>.
+            attribs = ''  # Failed to get event attributes; possibly <BdbQuit>.
         data = self.__items
         for i, item in enumerate(data):
             if item[0] == event:
@@ -199,7 +200,7 @@ class EventMonitor(wx.ListCtrl, ListCtrlAutoWidthMixin, CtrlInterface):
             self.parent.debugger.set_trace()
             return
         self.blink(i)
-    
+
     def append(self, event):
         data = self.__items
         if event in (item[0] for item in data):
@@ -214,7 +215,7 @@ class EventMonitor(wx.ListCtrl, ListCtrlAutoWidthMixin, CtrlInterface):
             self.SetItem(i, j, str(v))
         self.SetItemTextColour(i, 'blue')
         self.blink(i)
-    
+
     def blink(self, i):
         if self.GetItemBackgroundColour(i) != wx.Colour('yellow'):
             self.SetItemBackgroundColour(i, "yellow")
@@ -222,7 +223,7 @@ class EventMonitor(wx.ListCtrl, ListCtrlAutoWidthMixin, CtrlInterface):
                 if self and i < self.ItemCount:
                     self.SetItemBackgroundColour(i, 'white')
             wx.CallAfter(wx.CallLater, 1000, _reset_color)
-    
+
     def copy(self):
         if not self.SelectedItemCount:
             return
@@ -232,8 +233,8 @@ class EventMonitor(wx.ListCtrl, ListCtrlAutoWidthMixin, CtrlInterface):
                 event, name, *_, attribs = self.__items[i]
                 text += "{}\t{}\n{}\n\n".format(event, name, attribs)
         Clipboard.write(text[:-1])
-    
-    def OnSortItems(self, evt): #<wx._controls.ListEvent>
+
+    def OnSortItems(self, evt):  #<wx._controls.ListEvent>
         n = self.ItemCount
         if n < 2:
             return
@@ -253,19 +254,19 @@ class EventMonitor(wx.ListCtrl, ListCtrlAutoWidthMixin, CtrlInterface):
                 self.SetItem(i, j, str(v))
             self.Select(i, item in ls)
             self.CheckItem(i, item in lc)
-            self.SetItemTextColour(i, 'black') # reset font
+            self.SetItemTextColour(i, 'black')  # reset font
             if item in lb:
                 self.SetItemTextColour(i, 'blue')
             if item == fi:
                 self.Focus(i)
-    
-    def OnItemDClick(self, evt): #<wx._core.MouseEvent>
+
+    def OnItemDClick(self, evt):  #<wx._core.MouseEvent>
         i, flag = self.HitTest(evt.Position)
         if i >= 0:
             item = self.__items[i]
-            wx.CallAfter(wx.TipWindow, self, item[-1], 512) # attribs
+            wx.CallAfter(wx.TipWindow, self, item[-1], 512)  # attribs
         evt.Skip()
-    
+
     def OnContextMenu(self, evt):
         obj = self.target
         wnd = self._target
@@ -294,9 +295,9 @@ def monit(widget=None, **kwargs):
     return ew
 
 
-## Monkey-patch for wx.core (deprecated)
+## Monkey-patch for wx.core (deprecated).
 if 0:
-    from wx import core # PY3
+    from wx import core  # PY3
 
     def _EvtHandler_Bind(self, event, handler=None, source=None, id=wx.ID_ANY, id2=wx.ID_ANY):
         """
@@ -350,11 +351,11 @@ if 0:
                         if v[0] == id or v[1] == handler:
                             handlers.remove(v)
                 else:
-                    handlers.pop(0) # No optional arguments are specified.
+                    handlers.pop(0)  # No optional arguments are specified.
                 if not handlers:
                     del vmap[event.typeId]
             except KeyError:
-                pass # Note: vmap is actually inconsistent, but ignored.
+                pass  # Note: vmap is actually inconsistent, but ignored.
         return retval
 
     core.EvtHandler.Unbind = _EvtHandler_Unbind