-
Notifications
You must be signed in to change notification settings - Fork 108
/
events.py
190 lines (136 loc) · 5.47 KB
/
events.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
"""
This module provides the :class:`InputEvent` class, which closely
resembles the ``input_event`` struct defined in ``linux/input.h``:
.. code-block:: c
struct input_event {
struct timeval time;
__u16 type;
__u16 code;
__s32 value;
};
This module also defines several :class:`InputEvent` sub-classes that
know more about the different types of events (key, abs, rel etc). The
:data:`event_factory` dictionary maps event types to these classes.
Assuming you use the :func:`evdev.util.categorize()` function to
categorize events according to their type, adding or replacing a class
for a specific event type becomes a matter of modifying
:data:`event_factory`.
All classes in this module have reasonable ``str()`` and ``repr()``
methods::
>>> print(event)
event at 1337197425.477827, code 04, type 04, val 458792
>>> print(repr(event))
InputEvent(1337197425L, 477827L, 4, 4, 458792L)
>>> print(key_event)
key event at 1337197425.477835, 28 (KEY_ENTER), up
>>> print(repr(key_event))
KeyEvent(InputEvent(1337197425L, 477835L, 1, 28, 0L))
"""
# event type descriptions have been taken mot-a-mot from:
# http:https://www.kernel.org/doc/Documentation/input/event-codes.txt
from evdev.ecodes import keys, KEY, SYN, REL, ABS, EV_KEY, EV_REL, EV_ABS, EV_SYN
class InputEvent:
"""A generic input event."""
__slots__ = "sec", "usec", "type", "code", "value"
def __init__(self, sec, usec, type, code, value):
#: Time in seconds since epoch at which event occurred.
self.sec = sec
#: Microsecond portion of the timestamp.
self.usec = usec
#: Event type - one of ``ecodes.EV_*``.
self.type = type
#: Event code related to the event type.
self.code = code
#: Event value related to the event type.
self.value = value
def timestamp(self):
"""Return event timestamp as a float."""
return self.sec + (self.usec / 1000000.0)
def __str__(s):
msg = "event at {:f}, code {:02d}, type {:02d}, val {:02d}"
return msg.format(s.timestamp(), s.code, s.type, s.value)
def __repr__(s):
msg = "{}({!r}, {!r}, {!r}, {!r}, {!r})"
return msg.format(s.__class__.__name__, s.sec, s.usec, s.type, s.code, s.value)
class KeyEvent:
"""An event generated by a keyboard, button or other key-like devices."""
key_up = 0x0
key_down = 0x1
key_hold = 0x2
__slots__ = "scancode", "keycode", "keystate", "event"
def __init__(self, event, allow_unknown=False):
"""
The ``allow_unknown`` argument determines what to do in the event of an event code
for which a key code cannot be found. If ``False`` a ``KeyError`` will be raised.
If ``True`` the keycode will be set to the hex value of the event code.
"""
self.scancode = event.code
if event.value == 0:
self.keystate = KeyEvent.key_up
elif event.value == 2:
self.keystate = KeyEvent.key_hold
elif event.value == 1:
self.keystate = KeyEvent.key_down
try:
self.keycode = keys[event.code]
except KeyError:
if allow_unknown:
self.keycode = "0x{:02X}".format(event.code)
else:
raise
#: Reference to an :class:`InputEvent` instance.
self.event = event
def __str__(self):
try:
ks = ("up", "down", "hold")[self.keystate]
except IndexError:
ks = "unknown"
msg = "key event at {:f}, {} ({}), {}"
return msg.format(self.event.timestamp(), self.scancode, self.keycode, ks)
def __repr__(s):
return "{}({!r})".format(s.__class__.__name__, s.event)
class RelEvent:
"""A relative axis event (e.g moving the mouse 5 units to the left)."""
__slots__ = "event"
def __init__(self, event):
#: Reference to an :class:`InputEvent` instance.
self.event = event
def __str__(self):
msg = "relative axis event at {:f}, {}"
return msg.format(self.event.timestamp(), REL[self.event.code])
def __repr__(s):
return "{}({!r})".format(s.__class__.__name__, s.event)
class AbsEvent:
"""An absolute axis event (e.g the coordinates of a tap on a touchscreen)."""
__slots__ = "event"
def __init__(self, event):
#: Reference to an :class:`InputEvent` instance.
self.event = event
def __str__(self):
msg = "absolute axis event at {:f}, {}"
return msg.format(self.event.timestamp(), ABS[self.event.code])
def __repr__(s):
return "{}({!r})".format(s.__class__.__name__, s.event)
class SynEvent:
"""
A synchronization event. Used as markers to separate events. Events may be
separated in time or in space, such as with the multitouch protocol.
"""
__slots__ = "event"
def __init__(self, event):
#: Reference to an :class:`InputEvent` instance.
self.event = event
def __str__(self):
msg = "synchronization event at {:f}, {}"
return msg.format(self.event.timestamp(), SYN[self.event.code])
def __repr__(s):
return "{}({!r})".format(s.__class__.__name__, s.event)
#: A mapping of event types to :class:`InputEvent` sub-classes. Used
#: by :func:`evdev.util.categorize()`
event_factory = {
EV_KEY: KeyEvent,
EV_REL: RelEvent,
EV_ABS: AbsEvent,
EV_SYN: SynEvent,
}
__all__ = ("InputEvent", "KeyEvent", "RelEvent", "SynEvent", "AbsEvent", "event_factory")