evdev 1.7.1__tar.gz → 1.9.0__tar.gz

{evdev-1.7.1 → evdev-1.9.0}/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2012-2023 Georgi Valkov. All rights reserved.
+Copyright (c) 2012-2025 Georgi Valkov. All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are

{evdev-1.7.1 → evdev-1.9.0}/MANIFEST.in

@@ -1,4 +1,5 @@
 # The _ecodes extension module source file needs to be generated against the
 # evdev headers of the running kernel. Refer to the 'build_ecodes' distutils
 # command in setup.py.
-exclude evdev/ecodes.c
+exclude src/evdev/ecodes.c
+include src/evdev/ecodes.py

{evdev-1.7.1/evdev.egg-info → evdev-1.9.0}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.1
 Name: evdev
-Version: 1.7.1
+Version: 1.9.0
 Summary: Bindings to the Linux input handling subsystem
 Author-email: Georgi Valkov <georgi.t.valkov@gmail.com>
 Maintainer-email: Tobi <proxima@sezanzeb.de>
-License: Copyright (c) 2012-2023 Georgi Valkov. All rights reserved.
+License: Copyright (c) 2012-2025 Georgi Valkov. All rights reserved.
         
         Redistribution and use in source and binary forms, with or without
         modification, are permitted provided that the following conditions are
@@ -43,7 +43,7 @@ Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development :: Libraries
 Classifier: License :: OSI Approved :: BSD License
 Classifier: Programming Language :: Python :: Implementation :: CPython
-Requires-Python: >=3.6
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 
@@ -52,6 +52,7 @@ License-File: LICENSE
 <p>
     <a href="https://pypi.python.org/pypi/evdev"><img alt="pypi version" src="https://img.shields.io/pypi/v/evdev.svg"></a>
     <a href="https://github.com/gvalkov/python-evdev/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/pypi/l/evdev"></a>
+    <a href="https://repology.org/project/python:evdev/versions"><img alt="Packaging status" src="https://repology.org/badge/tiny-repos/python:evdev.svg"></a>
 </p>
 
 This package provides bindings to the generic input event interface in Linux.

{evdev-1.7.1 → evdev-1.9.0}/README.md

@@ -3,6 +3,7 @@
 <p>
     <a href="https://pypi.python.org/pypi/evdev"><img alt="pypi version" src="https://img.shields.io/pypi/v/evdev.svg"></a>
     <a href="https://github.com/gvalkov/python-evdev/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/pypi/l/evdev"></a>
+    <a href="https://repology.org/project/python:evdev/versions"><img alt="Packaging status" src="https://repology.org/badge/tiny-repos/python:evdev.svg"></a>
 </p>
 
 This package provides bindings to the generic input event interface in Linux.

{evdev-1.7.1 → evdev-1.9.0}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "evdev"
-version = "1.7.1"
+version = "1.9.0"
 description = "Bindings to the Linux input handling subsystem"
 keywords = ["evdev", "input", "uinput"]
 readme = "README.md"
 license = {file = "LICENSE"}
-requires-python = ">=3.6"
+requires-python = ">=3.8"
 authors = [
   { name="Georgi Valkov", email="georgi.t.valkov@gmail.com" },
 ]
@@ -29,9 +29,6 @@ classifiers = [
 [project.urls]
 "Homepage" = "https://github.com/gvalkov/python-evdev"
 
-[tool.setuptools]
-packages = ["evdev"]
-
 [tool.ruff]
 line-length = 120
 
@@ -39,7 +36,7 @@ line-length = 120
 ignore = ["E265", "E241", "F403", "F401", "E401", "E731"]
 
 [tool.bumpversion]
-current_version = "1.7.1"
+current_version = "1.9.0"
 commit = true
 tag = true
 allow_dirty = true
@@ -49,3 +46,12 @@ filename = "pyproject.toml"
 
 [[tool.bumpversion.files]]
 filename = "docs/conf.py"
+
+[tool.pylint.'MESSAGES CONTROL']
+disable = """
+    no-member,
+"""
+
+[tool.pylint.typecheck]
+generated-members = ["evdev.ecodes.*"]
+ignored-modules= ["evdev._*"]

{evdev-1.7.1 → evdev-1.9.0}/setup.py

@@ -1,14 +1,17 @@
 import os
 import sys
+import shutil
 import textwrap
+import platform
 from pathlib import Path
+from subprocess import run
 
 from setuptools import setup, Extension, Command
 from setuptools.command import build_ext as _build_ext
 
 
 curdir = Path(__file__).resolve().parent
-ecodes_path = curdir / "evdev/ecodes.c"
+ecodes_c_path = curdir / "src/evdev/ecodes.c"
 
 
 def create_ecodes(headers=None):
@@ -23,7 +26,11 @@ def create_ecodes(headers=None):
             include_paths.update(c_inc_path.split(":"))
 
         include_paths.add("/usr/include")
-        files = ["linux/input.h", "linux/input-event-codes.h", "linux/uinput.h"]
+        if platform.system().lower() == "freebsd":
+            files = ["dev/evdev/input.h", "dev/evdev/input-event-codes.h", "dev/evdev/uinput.h"]
+        else:
+            files = ["linux/input.h", "linux/input-event-codes.h", "linux/uinput.h"]
+
         headers = [os.path.join(path, file) for path in include_paths for file in files]
 
     headers = [header for header in headers if os.path.isfile(header)]
@@ -47,16 +54,18 @@ def create_ecodes(headers=None):
               build_ecodes --evdev-headers path/input.h:path/input-event-codes.h \\
               build_ext --include-dirs path/ \\
               install
+
+        If you want to avoid building this package from source, then please consider
+        installing the `evdev-binary` package instead. Keep in mind that it may not be
+        fully compatible with, or support all the features of your current kernel.
         """
 
         sys.stderr.write(textwrap.dedent(msg))
         sys.exit(1)
 
-    from subprocess import run
-
-    print("writing %s (using %s)" % (ecodes_path, " ".join(headers)))
-    with ecodes_path.open("w") as fh:
-        cmd = [sys.executable, "evdev/genecodes.py", *headers]
+    print("writing %s (using %s)" % (ecodes_c_path, " ".join(headers)))
+    with ecodes_c_path.open("w") as fh:
+        cmd = [sys.executable, "src/evdev/genecodes_c.py", "--ecodes", *headers]
         run(cmd, check=True, stdout=fh)
 
 
@@ -80,14 +89,27 @@ class build_ecodes(Command):
 
 class build_ext(_build_ext.build_ext):
     def has_ecodes(self):
-        if ecodes_path.exists():
+        if ecodes_c_path.exists():
             print("ecodes.c already exists ... skipping build_ecodes")
-        return not ecodes_path.exists()
+            return False
+        return True
+
+    def generate_ecodes_py(self):
+        ecodes_py = Path(self.build_lib) / "evdev/ecodes.py"
+        print(f"writing {ecodes_py}")
+        with ecodes_py.open("w") as fh:
+            cmd = [sys.executable, "-B", "src/evdev/genecodes_py.py"]
+            res = run(cmd, env={"PYTHONPATH": self.build_lib}, stdout=fh)
+
+        if res.returncode != 0:
+            print(f"failed to generate static {ecodes_py} - will use ecodes_runtime.py")
+            shutil.copy("src/evdev/ecodes_runtime.py", ecodes_py)
 
     def run(self):
         for cmd_name in self.get_sub_commands():
             self.run_command(cmd_name)
         _build_ext.build_ext.run(self)
+        self.generate_ecodes_py()
 
     sub_commands = [("build_ecodes", has_ecodes)] + _build_ext.build_ext.sub_commands
 
@@ -95,9 +117,9 @@ class build_ext(_build_ext.build_ext):
 cflags = ["-std=c99", "-Wno-error=declaration-after-statement"]
 setup(
     ext_modules=[
-        Extension("evdev._input", sources=["evdev/input.c"], extra_compile_args=cflags),
-        Extension("evdev._uinput", sources=["evdev/uinput.c"], extra_compile_args=cflags),
-        Extension("evdev._ecodes", sources=["evdev/ecodes.c"], extra_compile_args=cflags),
+        Extension("evdev._input", sources=["src/evdev/input.c"], extra_compile_args=cflags),
+        Extension("evdev._uinput", sources=["src/evdev/uinput.c"], extra_compile_args=cflags),
+        Extension("evdev._ecodes", sources=["src/evdev/ecodes.c"], extra_compile_args=cflags),
     ],
     cmdclass={
         "build_ext": build_ext,

evdev-1.9.0/src/evdev/__init__.py

@@ -0,0 +1,9 @@
+# --------------------------------------------------------------------------
+# Gather everything into a single, convenient namespace.
+# --------------------------------------------------------------------------
+
+from . import ecodes, ff
+from .device import AbsInfo, DeviceInfo, EvdevError, InputDevice
+from .events import AbsEvent, InputEvent, KeyEvent, RelEvent, SynEvent, event_factory
+from .uinput import UInput, UInputError
+from .util import categorize, list_devices, resolve_ecodes, resolve_ecodes_dict

{evdev-1.7.1 → evdev-1.9.0/src}/evdev/device.py

@@ -1,31 +1,19 @@
-# encoding: utf-8
-
-import os
-import warnings
 import contextlib
-import collections
+import os
+from typing import NamedTuple, Tuple, Union
 
-from evdev import _input, ecodes, util
-from evdev.events import InputEvent
+from . import _input, ecodes, util
 
 try:
-    from evdev.eventio_async import EventIO, EvdevError
+    from .eventio_async import EvdevError, EventIO
 except ImportError:
-    from evdev.eventio import EventIO, EvdevError
-
-
-# --------------------------------------------------------------------------
-_AbsInfo = collections.namedtuple("AbsInfo", ["value", "min", "max", "fuzz", "flat", "resolution"])
+    from .eventio import EvdevError, EventIO
 
-_KbdInfo = collections.namedtuple("KbdInfo", ["repeat", "delay"])
 
-_DeviceInfo = collections.namedtuple("DeviceInfo", ["bustype", "vendor", "product", "version"])
-
-
-class AbsInfo(_AbsInfo):
+class AbsInfo(NamedTuple):
     """Absolute axis information.
 
-    A ``namedtuple`` used for storing absolute axis information -
+    A ``namedtuple`` with absolute axis information -
     corresponds to the ``input_absinfo`` struct:
 
     Attributes
@@ -61,28 +49,38 @@ class AbsInfo(_AbsInfo):
 
     """
 
+    value: int
+    min: int
+    max: int
+    fuzz: int
+    flat: int
+    resolution: int
+
     def __str__(self):
-        return "val {}, min {}, max {}, fuzz {}, flat {}, res {}".format(*self)
+        return "value {}, min {}, max {}, fuzz {}, flat {}, res {}".format(*self)  # pylint: disable=not-an-iterable
 
 
-class KbdInfo(_KbdInfo):
+class KbdInfo(NamedTuple):
     """Keyboard repeat rate.
 
     Attributes
     ----------
-    repeat
-      Keyboard repeat rate in characters per second.
-
     delay
       Amount of time that a key must be depressed before it will start
       to repeat (in milliseconds).
+
+    repeat
+      Keyboard repeat rate in characters per second.
     """
 
+    delay: int
+    repeat: int
+
     def __str__(self):
-        return "repeat {}, delay {}".format(*self)
+        return "delay {}, repeat {}".format(self.delay, self.repeat)
 
 
-class DeviceInfo(_DeviceInfo):
+class DeviceInfo(NamedTuple):
     """
     Attributes
     ----------
@@ -92,9 +90,14 @@ class DeviceInfo(_DeviceInfo):
     version
     """
 
+    bustype: int
+    vendor: int
+    product: int
+    version: int
+
     def __str__(self):
         msg = "bus: {:04x}, vendor {:04x}, product {:04x}, version {:04x}"
-        return msg.format(*self)
+        return msg.format(*self)  # pylint: disable=not-an-iterable
 
 
 class InputDevice(EventIO):
@@ -104,7 +107,7 @@ class InputDevice(EventIO):
 
     __slots__ = ("path", "fd", "info", "name", "phys", "uniq", "_rawcapabilities", "version", "ff_effects_count")
 
-    def __init__(self, dev):
+    def __init__(self, dev: Union[str, bytes, os.PathLike]):
         """
         Arguments
         ---------
@@ -115,15 +118,14 @@ class InputDevice(EventIO):
         #: Path to input device.
         self.path = dev if not hasattr(dev, "__fspath__") else dev.__fspath__()
 
-        # Certain operations are possible only when the device is opened in
-        # read-write mode.
+        # Certain operations are possible only when the device is opened in read-write mode.
         try:
             fd = os.open(dev, os.O_RDWR | os.O_NONBLOCK)
         except OSError:
             fd = os.open(dev, os.O_RDONLY | os.O_NONBLOCK)
 
         #: A non-blocking file descriptor to the device file.
-        self.fd = fd
+        self.fd: int = fd
 
         # Returns (bustype, vendor, product, version, name, phys, capabilities).
         info_res = _input.ioctl_devinfo(self.fd)
@@ -132,16 +134,16 @@ class InputDevice(EventIO):
         self.info = DeviceInfo(*info_res[:4])
 
         #: The name of the event device.
-        self.name = info_res[4]
+        self.name: str = info_res[4]
 
         #: The physical topology of the device.
-        self.phys = info_res[5]
+        self.phys: str = info_res[5]
 
         #: The unique identifier of the device.
-        self.uniq = info_res[6]
+        self.uniq: str = info_res[6]
 
         #: The evdev protocol version.
-        self.version = _input.ioctl_EVIOCGVERSION(self.fd)
+        self.version: int = _input.ioctl_EVIOCGVERSION(self.fd)
 
         #: The raw dictionary of device capabilities - see `:func:capabilities()`.
         self._rawcapabilities = _input.ioctl_capabilities(self.fd)
@@ -156,7 +158,7 @@ class InputDevice(EventIO):
             except (OSError, ImportError, AttributeError):
                 pass
 
-    def _capabilities(self, absinfo=True):
+    def _capabilities(self, absinfo: bool = True):
         res = {}
 
         for etype, _ecodes in self._rawcapabilities.items():
@@ -174,7 +176,7 @@ class InputDevice(EventIO):
 
         return res
 
-    def capabilities(self, verbose=False, absinfo=True):
+    def capabilities(self, verbose: bool = False, absinfo: bool = True):
         """
         Return the event types that this device supports as a mapping of
         supported event types to lists of handled event codes.
@@ -219,7 +221,7 @@ class InputDevice(EventIO):
         else:
             return self._capabilities(absinfo)
 
-    def input_props(self, verbose=False):
+    def input_props(self, verbose: bool = False):
         """
         Get device properties and quirks.
 
@@ -240,7 +242,7 @@ class InputDevice(EventIO):
 
         return props
 
-    def leds(self, verbose=False):
+    def leds(self, verbose: bool = False):
         """
         Return currently set LED keys.
 
@@ -261,7 +263,7 @@ class InputDevice(EventIO):
 
         return leds
 
-    def set_led(self, led_num, value):
+    def set_led(self, led_num: int, value: int):
         """
         Set the state of the selected LED.
 
@@ -331,7 +333,7 @@ class InputDevice(EventIO):
         yield
         self.ungrab()
 
-    def upload_effect(self, effect):
+    def upload_effect(self, effect: "ff.Effect"):
         """
         Upload a force feedback effect to a force feedback device.
         """
@@ -358,10 +360,10 @@ class InputDevice(EventIO):
         return KbdInfo(*_input.ioctl_EVIOCGREP(self.fd))
 
     @repeat.setter
-    def repeat(self, value):
+    def repeat(self, value: Tuple[int, int]):
         return _input.ioctl_EVIOCSREP(self.fd, *value)
 
-    def active_keys(self, verbose=False):
+    def active_keys(self, verbose: bool = False):
         """
         Return currently active keys.
 
@@ -384,13 +386,7 @@ class InputDevice(EventIO):
 
         return active_keys
 
-    @property
-    def fn(self):
-        msg = "Please use {0}.path instead of {0}.fn".format(self.__class__.__name__)
-        warnings.warn(msg, DeprecationWarning, stacklevel=2)
-        return self.path
-
-    def absinfo(self, axis_num):
+    def absinfo(self, axis_num: int):
         """
         Return current :class:`AbsInfo` for input device axis
 
@@ -406,7 +402,7 @@ class InputDevice(EventIO):
         """
         return AbsInfo(*_input.ioctl_EVIOCGABS(self.fd, axis_num))
 
-    def set_absinfo(self, axis_num, value=None, min=None, max=None, fuzz=None, flat=None, resolution=None):
+    def set_absinfo(self, axis_num: int, value=None, min=None, max=None, fuzz=None, flat=None, resolution=None):
         """
         Update :class:`AbsInfo` values. Only specified values will be overwritten.
 

evdev-1.9.0/src/evdev/ecodes.py

@@ -0,0 +1,5 @@
+# When installed, this module is replaced by an ecodes.py generated at
+# build time by genecodes_py.py (see build_ext in setup.py).
+
+# This stub exists to make development of evdev itself more convenient.
+from .ecodes_runtime import *

evdev-1.7.1/evdev/ecodes.py → evdev-1.9.0/src/evdev/ecodes_runtime.py

@@ -1,3 +1,4 @@
+# pylint: disable=undefined-variable
 """
 This modules exposes the integer constants defined in ``linux/input.h`` and
 ``linux/input-event-codes.h``.
@@ -32,26 +33,26 @@ Keep in mind that values in reverse mappings may point to one or more event
 codes. For example::
 
     >>> evdev.ecodes.FF[80]
-    ['FF_EFFECT_MIN', 'FF_RUMBLE']
+    ('FF_EFFECT_MIN', 'FF_RUMBLE')
 
     >>> evdev.ecodes.FF[81]
     'FF_PERIODIC'
 """
 
 from inspect import getmembers
-from evdev import _ecodes
 
+from . import _ecodes
 
 #: Mapping of names to values.
 ecodes = {}
 
-prefixes = "KEY ABS REL SW MSC LED BTN REP SND ID EV BUS SYN FF_STATUS FF INPUT_PROP"
+prefixes = "KEY ABS REL SW MSC LED BTN REP SND ID EV BUS SYN FF_STATUS FF INPUT_PROP".split()
 prev_prefix = ""
 g = globals()
 
 # eg. code: 'REL_Z', val: 2
 for code, val in getmembers(_ecodes):
-    for prefix in prefixes.split():  # eg. 'REL'
+    for prefix in prefixes:  # eg. 'REL'
         if code.startswith(prefix):
             ecodes[code] = val
             # FF_STATUS codes should not appear in the FF reverse mapping
@@ -70,6 +71,15 @@ for code, val in getmembers(_ecodes):
 
         prev_prefix = prefix
 
+
+# Convert lists to tuples.
+k, v = None, None
+for prefix in prefixes:
+    for k, v in g[prefix].items():
+        if isinstance(v, list):
+            g[prefix][k] = tuple(v)
+
+
 #: Keys are a combination of all BTN and KEY codes.
 keys = {}
 keys.update(BTN)
@@ -98,4 +108,4 @@ bytype = {
 from evdev._ecodes import *
 
 # cheaper than whitelisting in an __all__
-del code, val, prefix, getmembers, g, d, prefixes, prev_prefix
+del code, val, prefix, getmembers, g, d, k, v, prefixes, prev_prefix

{evdev-1.7.1 → evdev-1.9.0/src}/evdev/eventio.py

@@ -1,10 +1,11 @@
-import os
 import fcntl
-import select
 import functools
+import os
+import select
+from typing import Iterator, Union
 
-from evdev import _input, _uinput, ecodes, util
-from evdev.events import InputEvent
+from . import _input, _uinput, ecodes
+from .events import InputEvent
 
 
 # --------------------------------------------------------------------------
@@ -35,7 +36,7 @@ class EventIO:
         """
         return self.fd
 
-    def read_loop(self):
+    def read_loop(self) -> Iterator[InputEvent]:
         """
         Enter an endless :func:`select.select()` loop that yields input events.
         """
@@ -45,7 +46,7 @@ class EventIO:
             for event in self.read():
                 yield event
 
-    def read_one(self):
+    def read_one(self) -> Union[InputEvent, None]:
         """
         Read and return a single input event as an instance of
         :class:`InputEvent <evdev.events.InputEvent>`.
@@ -59,19 +60,20 @@ class EventIO:
         if event:
             return InputEvent(*event)
 
-    def read(self):
+    def read(self) -> Iterator[InputEvent]:
         """
         Read multiple input events from device. Return a generator object that
         yields :class:`InputEvent <evdev.events.InputEvent>` instances. Raises
         `BlockingIOError` if there are no available events at the moment.
         """
 
-        # events -> [(sec, usec, type, code, val), ...]
+        # events -> ((sec, usec, type, code, val), ...)
         events = _input.device_read_many(self.fd)
 
         for event in events:
             yield InputEvent(*event)
 
+    # pylint: disable=no-self-argument
     def need_write(func):
         """
         Decorator that raises :class:`EvdevError` if there is no write access to the
@@ -82,6 +84,7 @@ class EventIO:
         def wrapper(*args):
             fd = args[0].fd
             if fcntl.fcntl(fd, fcntl.F_GETFL) & os.O_RDWR:
+                # pylint: disable=not-callable
                 return func(*args)
             msg = 'no write access to device "%s"' % args[0].path
             raise EvdevError(msg)
@@ -112,7 +115,7 @@ class EventIO:
         self.write(event.type, event.code, event.value)
 
     @need_write
-    def write(self, etype, code, value):
+    def write(self, etype: int, code: int, value: int):
         """
         Inject an input event into the input subsystem. Events are
         queued until a synchronization event is received.
@@ -136,5 +139,14 @@ class EventIO:
 
         _uinput.write(self.fd, etype, code, value)
 
+    def syn(self):
+        """
+        Inject a ``SYN_REPORT`` event into the input subsystem. Events
+        queued by :func:`write()` will be fired. If possible, events
+        will be merged into an 'atomic' event.
+        """
+
+        self.write(ecodes.EV_SYN, ecodes.SYN_REPORT, 0)
+
     def close(self):
         pass

{evdev-1.7.1 → evdev-1.9.0/src}/evdev/eventio_async.py

@@ -1,10 +1,10 @@
 import asyncio
 import select
 
-from evdev import eventio
+from . import eventio
 
 # needed for compatibility
-from evdev.eventio import EvdevError
+from .eventio import EvdevError
 
 
 class EventIO(eventio.EventIO):