This library provides an interface to the Linux and FreeBSD input device subsystem.
- Ergonomic Rusty API designed for stability.
- Exposes almost every
evdevanduinputfeature, including force-feedback and multitouch. - Device Hotplug support.
- Light on dependencies.
- FreeBSD compatibility.
asyncsupport via Tokio orasync-io.
| Feature | Description |
|---|---|
serde |
Implements Serialize and Deserialize for many event code wrappers like Key, Rel, etc. |
tokio |
Uses Tokio to enable async event reading. |
async-io |
Uses async-io to enable async event reading. |
The tokio and async-io features are mutually exclusive.
Compilation will fail if both are enabled.
This library targets the latest stable Rust version.
Older Rust versions are supported by equally older versions of this crate. For example, to use a version of Rust that was succeeded 6 months ago, you'd also use an at least 6 month old version of this library.
Compatibility with older Rust versions may be provided on a best-effort basis.
The minimum supported Rust version is specified as rust-version in Cargo.toml, and tested
against in CI, so Cargo's resolver should find a version for you that works.
Documentation for Linux' input subsystem can be found at https://www.kernel.org/doc/html/latest/input/index.html.
The crate is tested using end-to-end tests that create a virtual uinput device and then open it.
This means the user running the tests needs to have permission to write to /dev/uinput and the input devices in /dev/input/event*.
To run the test suite (and all examples) via sudo, you can place this .cargo/config.toml file in your repository checkout:
[target.'cfg(true)']
runner = "sudo -E --preserve-env=PATH"