You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
151 lines
4.4 KiB
Python
151 lines
4.4 KiB
Python
# -*- coding: utf-8 -*-
|
|
# Free Software Foundation; either version 2.1 of the License, or (at your
|
|
# option) any later version.
|
|
|
|
# This library 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 Lesser General Public License
|
|
# for more details.
|
|
|
|
# You should have received a copy of the GNU Lesser General Public License
|
|
# along with this library; if not, write to the Free Software Foundation,
|
|
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
|
|
# pylint: disable=anomalous-backslash-in-string
|
|
|
|
"""pyudev.wx
|
|
=========
|
|
|
|
Wx integration.
|
|
|
|
:class:`MonitorObserver` integrates device monitoring into the wxPython\_
|
|
mainloop by turing device events into wx events.
|
|
|
|
:mod:`wx` from wxPython\_ must be available when importing this module.
|
|
|
|
.. _wxPython: http://wxpython.org/
|
|
|
|
.. moduleauthor:: Tobias Eberle <tobias.eberle@gmx.de>
|
|
.. versionadded:: 0.14
|
|
|
|
"""
|
|
|
|
|
|
from __future__ import (print_function, division, unicode_literals,
|
|
absolute_import)
|
|
|
|
from wx import EvtHandler, PostEvent
|
|
from wx.lib.newevent import NewEvent
|
|
|
|
import pyudev
|
|
|
|
|
|
DeviceEvent, EVT_DEVICE_EVENT = NewEvent()
|
|
|
|
|
|
class MonitorObserver(EvtHandler):
|
|
"""
|
|
An observer for device events integrating into the :mod:`wx` mainloop.
|
|
|
|
This class inherits :class:`~wx.EvtHandler` to turn device events into
|
|
wx events:
|
|
|
|
>>> from pyudev import Context, Monitor
|
|
>>> from pyudev.wx import MonitorObserver
|
|
>>> context = Context()
|
|
>>> monitor = Monitor.from_netlink(context)
|
|
>>> monitor.filter_by(subsystem='input')
|
|
>>> observer = MonitorObserver(monitor)
|
|
>>> def device_event(event):
|
|
... print('action {0} on device {1}'.format(event.device.action, event.device))
|
|
>>> observer.Bind(EVT_DEVICE_EVENT, device_event)
|
|
>>> monitor.start()
|
|
|
|
This class is a child of :class:`wx.EvtHandler`.
|
|
|
|
.. versionadded:: 0.17
|
|
"""
|
|
|
|
def __init__(self, monitor):
|
|
EvtHandler.__init__(self)
|
|
self.monitor = monitor
|
|
self._observer_thread = None
|
|
self.start()
|
|
|
|
@property
|
|
def enabled(self):
|
|
"""
|
|
Whether this observer is enabled or not.
|
|
|
|
If ``True`` (the default), this observer is enabled, and emits events.
|
|
Otherwise it is disabled and does not emit any events.
|
|
"""
|
|
return self._observer_thread is not None
|
|
|
|
@enabled.setter
|
|
def enabled(self, value):
|
|
if value:
|
|
self.start()
|
|
else:
|
|
self.stop()
|
|
|
|
def start(self):
|
|
"""
|
|
Enable this observer.
|
|
|
|
Do nothing, if the observer is already enabled.
|
|
"""
|
|
if self._observer_thread is not None:
|
|
return
|
|
self._observer_thread = pyudev.MonitorObserver(
|
|
self.monitor, callback=self._emit_event,
|
|
name='wx-observer-thread')
|
|
self._observer_thread.start()
|
|
|
|
def stop(self):
|
|
"""
|
|
Disable this observer.
|
|
|
|
Do nothing, if the observer is already disabled.
|
|
"""
|
|
if self._observer_thread is None:
|
|
return
|
|
self._observer_thread.stop()
|
|
|
|
def _emit_event(self, device):
|
|
PostEvent(self, DeviceEvent(device=device))
|
|
|
|
|
|
DeviceAddedEvent, EVT_DEVICE_ADDED = NewEvent()
|
|
DeviceRemovedEvent, EVT_DEVICE_REMOVED = NewEvent()
|
|
DeviceChangedEvent, EVT_DEVICE_CHANGED = NewEvent()
|
|
DeviceMovedEvent, EVT_DEVICE_MOVED = NewEvent()
|
|
|
|
|
|
class WxUDevMonitorObserver(MonitorObserver):
|
|
"""An observer for device events integrating into the :mod:`wx` mainloop.
|
|
|
|
.. deprecated:: 0.17
|
|
Will be removed in 1.0. Use :class:`MonitorObserver` instead.
|
|
"""
|
|
|
|
_action_event_map = {
|
|
'add': DeviceAddedEvent,
|
|
'remove': DeviceRemovedEvent,
|
|
'change': DeviceChangedEvent,
|
|
'move': DeviceMovedEvent
|
|
}
|
|
|
|
def __init__(self, monitor):
|
|
MonitorObserver.__init__(self, monitor)
|
|
import warnings
|
|
warnings.warn('Will be removed in 1.0. '
|
|
'Use pyudev.wx.MonitorObserver instead.',
|
|
DeprecationWarning)
|
|
|
|
def _emit_event(self, device):
|
|
PostEvent(self, DeviceEvent(action=device.action, device=device))
|
|
event_class = self._action_event_map.get(device.action)
|
|
if event_class is not None:
|
|
PostEvent(self, event_class(device=device))
|