# This library is free software; you can redistribute it and/or modify it # under the terms of the GNU Lesser General Public License as published by the # 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
""" pyudev._qt_base ===============
Base mixin class for Qt4,Qt5 support.
.. moduleauthor:: Sebastian Wiesner <lunaryorn@gmail.com> """
from __future__ import absolute_import from __future__ import division from __future__ import print_function from __future__ import unicode_literals
import six
from pyudev.device import Device
class MonitorObserverMixin(object): """ Base mixin for pyqt monitor observers. """ # pylint: disable=too-few-public-methods
@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. This merely reflects the state of the ``enabled`` property of the underlying :attr:`notifier`.
def _process_udev_event(self): """ Attempt to receive a single device event from the monitor, process the event and emit corresponding signals.
Called by ``QSocketNotifier``, if data is available on the udev monitoring socket. """ device = self.monitor.poll(timeout=0) if device is not None: self._emit_event(device)
def _emit_event(self, device): self.deviceEvent.emit(device.action, device) signal = self._action_signal_map.get(device.action) if signal is not None: signal.emit(device)
def make_init(qobject, socket_notifier): """ Generates an initializer to observer the given ``monitor`` (a :class:`~pyudev.Monitor`):
``parent`` is the parent :class:`~PyQt{4,5}.QtCore.QObject` of this object. It is passed unchanged to the inherited constructor of :class:`~PyQt{4,5}.QtCore.QObject`. """
class MonitorObserverGenerator(object): """ Class to generate a MonitorObserver class. """ # pylint: disable=too-few-public-methods
@staticmethod def make_monitor_observer(qobject, signal, socket_notifier): """Generates an observer for device events integrating into the PyQt{4,5} mainloop.
This class inherits :class:`~PyQt{4,5}.QtCore.QObject` to turn device events into Qt signals:
class QUDevMonitorObserverGenerator(object): """ Class to generate a MonitorObserver class. """ # pylint: disable=too-few-public-methods
@staticmethod def make_monitor_observer(qobject, signal, socket_notifier): """Generates an observer for device events integrating into the PyQt{4,5} mainloop.
This class inherits :class:`~PyQt{4,5}.QtCore.QObject` to turn device events into Qt signals:
This class is a child of :class:`~{PyQt{4,5}, PySide}.QtCore.QObject`.
""" return type( str("QUDevMonitorObserver"), (qobject, QUDevMonitorObserverMixin), { str("__init__") : make_init(qobject, socket_notifier), #: emitted upon arbitrary device events str("deviceEvent") : signal(six.text_type, Device), #: emitted if a device was added str("deviceAdded") : signal(Device), #: emitted if a device was removed str("deviceRemoved") : signal(Device), #: emitted if a device was changed str("deviceChanged") : signal(Device), #: emitted if a device was moved str("deviceMoved") : signal(Device) } )