keyclean 0.9.0__tar.gz

keyclean-0.9.0/.claude/settings.local.json

@@ -0,0 +1,13 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(python -c \"import pygame\")",
+      "Bash(SDL_VIDEODRIVER=dummy SDL_AUDIODRIVER=dummy python -m pytest tests/ -v 2>&1)",
+      "Bash(PYTHONPATH=src pylint src/keyclean 2>&1)",
+      "Bash(SDL_VIDEODRIVER=dummy SDL_AUDIODRIVER=dummy python -m pytest tests/test_input_grabber.py -v 2>&1)",
+      "Bash(python -m pytest tests/test_input_grabber.py -v)",
+      "Bash(pylint src/keyclean)",
+      "Bash(make:*)"
+    ]
+  }
+}

keyclean-0.9.0/.editorconfig

@@ -0,0 +1,27 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+# The POSIX standard requires the last line to end with a new line character.
+# All UNIX tools expect a new line at the end of files. Most text editors use this convention too.
+insert_final_newline = true
+trim_trailing_whitespace = true
+max_line_length = 120
+
+# Matches multiple files with brace expansion notation
+# Set default charset and 4 space indentation
+[*.{py,txt,md,rst,c,cxx,cpp,h,hpp,hxx,sh,cfg,ini}]
+indent_style = space
+indent_size = 4
+
+[*.{js,json,html,htm,xml,yaml,yml}]
+indent_style = space
+indent_size = 2
+
+# Tab indentation (no size specified)
+[{Makefile,*.go}]
+indent_style = tab

keyclean-0.9.0/.gitignore

@@ -0,0 +1,31 @@
+/dist/
+/build/
+/htmlcov/
+__pycache__/
+*.py[cod]
+*.egg-info/
+*.egg
+.eggs/
+.tox/
+.pytest_cache/
+.coverage
+*.py,cover
+site.py
+__pypackages__/
+
+# uv
+/.venv/
+/uv.lock
+
+# Local wheels cache
+/whl_local/
+
+# Packaging
+/*.spec
+/VERSION
+
+# Editor
+/.idea/
+/.vscode/
+*.swp
+*~

keyclean-0.9.0/CHANGELOG.md

@@ -0,0 +1,139 @@
+## 0.9.0 — 2026-03-22
+
+### Changes since beginning
+
+- f0a2b04 Add uv run keyclean to README usage examples
+- 785119a Add app header above clock; make milliseconds optional
+- 2e9f934 Show /dev/input hint in UI below exit-phrase help text
+- b09c869 Add make release target
+- d42cc72 Fix Enter key overlapping Del — shorten #~ and backslash, shift Enter left
+- d71cb0d Fix Wayland Super key leak — explicit zwp_keyboard_shortcuts_inhibit_manager_v1
+- 0c4fb12 Add Development section to README, fix uv dep groups, add py314 to tox
+- 0703c7b Silence pygame setuptools related depecation warnings.
+- bdd632d Initial implementation of KeyClean 0.1.0
+- 47251bc Minor plan adjustment, .gitignore.
+- 0154a64 Start.
+
+# Changelog
+
+## 0.1.0 — 2026-03-22
+
+Initial implementation.
+
+### Added
+
+- `pyproject.toml` — build config using `hatchling`, `pygame-ce` as core dependency,
+  `pynput` and `python-xlib` as optional extras, full dev toolchain
+  (`autopep8`, `pylint`, `pytest`, `pytest-mock`, `pytest-cov`, `tox`, `twine`, `build`).
+- `tox.ini` — cross-version test matrix for Python 3.9–3.13.
+- `README.md` — installation, usage, exit methods, platform notes.
+- `LICENSE` — Unlicense.
+- `.gitignore` — Python, uv, build artifact, and editor ignores.
+
+#### `src/keyclean/`
+
+- `__init__.py` — version (`0.1.0`), author, license metadata.
+- `__main__.py` — `python -m keyclean` entry point.
+- `config.py` — all constants: colors, key sizes, FPS (60), exit phrase
+  (`"keys are clean"`), datetime format, Done button geometry.
+- `keyboard_layout.py` — full ISO 105-key layout: rows 0–5 (Esc/F-keys, number row,
+  QWERTY, home row, bottom row with ISO extra key, space bar row), navigation cluster
+  (Insert/Delete/Home/End/PgUp/PgDn/arrows), numpad (17 keys including tall Enter and
+  Plus). `PYGAME_KEY_MAP` dict for O(1) keycode lookup.
+- `renderer.py` — `Renderer` class: auto-scales layout to screen resolution;
+  draws datetime top bar (`YYYY-MM-DD HH:MM:SS.mmm ±HHMM TZ`), ISO keyboard in the
+  middle with pressed-key highlighting, keystroke counter (bottom-left), help text
+  (bottom-center), Done button (bottom-right, hover highlight), warning banner.
+- `safety_sequence.py` — `SafetySequence`: `collections.deque` ring buffer,
+  case-insensitive match against the exit phrase; `feed(char) -> bool`.
+- `app.py` — `App` class: fullscreen pygame init, 60 FPS loop that drains the full
+  SDL event queue each frame, tracks `pressed_keys: set[int]` and `strike_count: int`,
+  feeds printable characters to `SafetySequence`, handles Done button mouse click.
+
+#### `src/keyclean/input_grabber/`
+
+- `_base.py` — `AbstractGrabber` ABC with `grab()`, `release()`, context manager.
+- `_fallback.py` — No-op grabber; sets `is_fallback=True` to trigger warning banner.
+- `_wayland.py` — Best-effort Wayland grabber; relies on SDL2
+  `zwp_keyboard_shortcuts_inhibit_manager_v1`; warns if SDL2 < 2.28.
+- `_x11.py` — Full keyboard grab via `XGrabKeyboard` (python-xlib); logs window ID.
+- `_pynput.py` — Global suppression via `pynput.keyboard.Listener(suppress=True)`;
+  used on macOS (CGEventTap) and Windows (LowLevelHook).
+- `__init__.py` — `get_grabber()` factory: dispatches on `sys.platform` and
+  `$XDG_SESSION_TYPE`; gracefully falls back through X11 → pynput → fallback.
+
+#### `tests/`
+
+- `conftest.py` — shared fixtures.
+- `test_safety_sequence.py` — 9 tests: exact phrase, case-insensitive, partial,
+  wrong chars, sliding ring buffer, reset, edge cases.
+- `test_keyboard_layout.py` — 12 tests: key count (~105), unique IDs, unique pygame
+  keycodes, map consistency, no zero-size keys, all labels present, ISO extra key,
+  numpad completeness, F1–F12, arrows, row/col bounds.
+- `test_renderer.py` — 8 tests: instantiation, Done rect returned and within screen,
+  pressed keys, warning banner, counter values, small and large resolutions.
+- `test_input_grabber.py` — 11 tests: FallbackGrabber lifecycle, context manager,
+  WaylandGrabber SDL version warning, factory dispatch for unknown/Wayland/X11/macOS/Windows.
+- `test_app.py` — 9 tests: `_key_to_char` filtering, exit phrase detection,
+  counter initial state.
+
+#### `Makefile`
+
+- Updated `test_upload` and `upload` targets from `termcolor_dg-*` to `keyclean-*`.
+
+### Result
+
+- **52/52 tests passing.**
+- **pylint 10.00/10.**
+
+● All done. Here's the final state:
+
+52/52 tests passing  •  pylint 10.00/10
+
+Files created:
+
+┌─────────────────────────────────────────┬─────────────────────────────────────────────────────────────────────────────┐
+│                  File                   │                                   Purpose                                   │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ .gitignore                              │ Updated with full Python/uv/build ignores                                   │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ LICENSE                                 │ Already existed (Unlicense)                                                 │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ README.md                               │ Installation, usage, platform notes                                         │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ tox.ini                                 │ Python 3.9–3.13 test matrix                                                 │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ pyproject.toml                          │ Build config, deps, pylint/pytest/autopep8 settings                         │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ src/keyclean/__init__.py                │ Version, author, license metadata                                           │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ src/keyclean/__main__.py                │ python -m keyclean entry point                                              │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ src/keyclean/config.py                  │ All constants: colors, sizes, FPS, exit phrase, datetime format             │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ src/keyclean/keyboard_layout.py         │ Full ISO 105-key definitions (rows 0–5 + nav cluster + numpad)              │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ src/keyclean/renderer.py                │ Datetime top bar, keyboard, counter, help text, Done button, warning banner │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ src/keyclean/safety_sequence.py         │ Ring buffer matching "keys are clean" case-insensitively                    │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ src/keyclean/app.py                     │ Main loop, event drain, key state, exit handling                            │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ src/keyclean/input_grabber/__init__.py  │ Platform-dispatch factory                                                   │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ src/keyclean/input_grabber/_base.py     │ AbstractGrabber ABC                                                         │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ src/keyclean/input_grabber/_fallback.py │ Pygame-only no-op with warning                                              │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ src/keyclean/input_grabber/_wayland.py  │ Best-effort (SDL2 shortcuts_inhibit)                                        │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ src/keyclean/input_grabber/_x11.py      │ XGrabKeyboard via python-xlib                                               │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ src/keyclean/input_grabber/_pynput.py   │ pynput suppress=True (macOS/Windows)                                        │
+├─────────────────────────────────────────┼─────────────────────────────────────────────────────────────────────────────┤
+│ tests/                                  │ 52 tests across all modules                                                 │
+└─────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────────┘
+
+The warnings in the test output are all from the system's pkg_resources (pygame's dependency) — not from our code.
+
+✻ Sautéed for 18m 23s

keyclean-0.9.0/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org>

keyclean-0.9.0/Makefile

@@ -0,0 +1,182 @@
+SHELL:=/usr/bin/env bash # Use bash syntax, mitigates dash's printf on Debian
+export TOP:=$(shell dirname "$(abspath $(lastword $(MAKEFILE_LIST)))")
+name:=$(shell basename "$(TOP)")
+export PIP_FIND_LINKS:=$(abspath $(TOP)/whl_local/)
+export PYTHONPATH:=$(TOP)/src
+
+
+.PHONY: help
+help:
+	@echo
+	@echo "▍Help"
+	@echo "▀▀▀▀▀▀"
+	@echo
+	@echo "Available targets:"
+	@echo "    check:              run checks"
+	@echo "    test:               run all tests"
+	@echo "    coverage:           run all tests and collect code coverage"
+	@echo "    lint:               run linters"
+	@echo
+	@echo "    pep8format:         auto-format code to PEP8 standards"
+	@echo
+	@echo "    build:              build the source and whl package, look for */dist/*.whl"
+	@echo
+	@echo "    release:            tag a new release (required: V=X.Y.Z)"
+	@echo "                        updates version in pyproject.toml + __init__.py,"
+	@echo "                        prepends git log to CHANGELOG.md, commits, tags."
+	@echo "                        Example: make V=0.2.0 release"
+	@echo
+	@echo "    clean:              clean the build tree"
+	@echo
+	@echo "name='$(name)'"
+	@echo "PYTHONPATH     = '$(PYTHONPATH)'"
+	@echo "PIP_FIND_LINKS = '$(PIP_FIND_LINKS)'"
+
+
+.PHONY: check
+check: lint
+
+
+.PHONY: test
+test:
+	pytest -v
+
+
+.PHONY: coverage
+coverage:
+	pytest --cov=.
+
+
+.PHONY: lint
+lint:
+	pylint "src/$(name)"
+
+
+.PHONY: pep8format
+pep8format:
+	autopep8 --in-place --recursive "src/$(name)"
+
+
+.PHONY: build
+build:
+	python3 -m build
+	mkdir -p "$(PIP_FIND_LINKS)/"
+	cp dist/*.whl "$(PIP_FIND_LINKS)/"
+
+
+.PHONY: userinstall
+userinstall: build
+	python3 -m pip install $(PIP_USER) ./dist/*.whl
+
+
+.PHONY: uninstall
+uninstall:
+	python3 -m pip uninstall -y "$(name)"
+
+
+.PHONY: useruninstall
+useruninstall: uninstall
+
+
+.PHONY: rpmprep
+rpmprep:
+	cp "rpm/$(name).spec.in" "$(name).spec"
+	sed -i 's|^Release:.*|Release:        $(RPM_REV)%{?dist}|g' "$(name).spec"
+	sed -i 's|^Version:.*|Version:        $(RPM_VER)|g' "$(name).spec"
+	rm -rf ~/rpmbuild/RPMS/noarch/"$(name)"*.rpm
+	rm -rf ~/rpmbuild/SRPMS/"$(name)"*.src.rpm
+	python3 setup.py sdist
+
+
+.PHONY: rpm
+rpm: rpmprep
+	rpmbuild -ba "$(name).spec" --define "_sourcedir $$PWD/dist"
+	rm "$(name).spec"
+
+
+.PHONY: srpm
+srpm: rpmprep
+	rpmbuild -bs "$(name).spec" --define "_sourcedir $$PWD/dist"
+	rm "$(name).spec"
+
+
+# Python script that prepends a new section to CHANGELOG.md.
+# Exported as an env var so the recipe can pipe it to python3 via stdin
+# without heredoc/quoting nightmares.
+define _release_py
+import subprocess, datetime, pathlib, sys
+v, top = sys.argv[1], sys.argv[2]
+cl = pathlib.Path(top, "CHANGELOG.md")
+tags = subprocess.check_output(
+    ["git", "-C", top, "tag", "--sort=-version:refname"],
+    text=True
+).strip().splitlines()
+tags = [t for t in tags if t]
+last_tag = tags[0] if tags else None
+log_range = [last_tag + "..HEAD"] if last_tag else []
+commits = subprocess.check_output(
+    ["git", "-C", top, "log"] + log_range +
+    ["--oneline", "--no-decorate", "--no-merges"],
+    text=True
+).strip()
+date = datetime.date.today().isoformat()
+since = last_tag if last_tag else "beginning"
+section = "## " + v + " \u2014 " + date + "\n\n"
+section += "### Changes since " + since + "\n\n"
+if commits:
+    section += "\n".join("- " + c for c in commits.splitlines()) + "\n"
+section += "\n"
+existing = cl.read_text()
+cl.write_text(section + existing)
+n = len(commits.splitlines()) if commits else 0
+print("Updated CHANGELOG.md (" + str(n) + " commit" + ("s" if n != 1 else "") + ")")
+endef
+export _release_py
+
+
+.PHONY: release
+release:
+	@[ -n "$(V)" ] || { echo "Error: V is not set.  Usage: make V=X.Y.Z release"; exit 1; }
+	@printf '%s' "$(V)" | grep -qE '^[0-9]+\.[0-9]+\.[0-9]+$$' || \
+		{ echo "Error: '$(V)' is not a valid version (expected X.Y.Z)"; exit 1; }
+	@git -C "$(TOP)" diff --quiet HEAD 2>/dev/null || \
+		{ echo "Error: uncommitted changes — commit or stash first"; exit 1; }
+	@git -C "$(TOP)" tag | grep -qxF "v$(V)" && \
+		{ echo "Error: tag v$(V) already exists"; exit 1; } || true
+	@echo "▶ Bumping version to $(V) ..."
+	sed -i 's/^version = ".*"/version = "$(V)"/' "$(TOP)/pyproject.toml"
+	sed -i 's/^__version__ = ".*"/__version__ = "$(V)"/' \
+		"$(TOP)/src/$(name)/__init__.py"
+	@echo "▶ Updating CHANGELOG.md ..."
+	printf '%s\n' "$$_release_py" | python3 - "$(V)" "$(TOP)"
+	@echo "▶ Committing and tagging v$(V) ..."
+	git -C "$(TOP)" add pyproject.toml "src/$(name)/__init__.py" CHANGELOG.md
+	git -C "$(TOP)" commit -m "Release $(V)"
+	git -C "$(TOP)" tag -a "v$(V)" -m "Version $(V)"
+	@echo
+	@echo "✓ Released v$(V).  Push with:"
+	@echo "      git push && git push --tags"
+
+
+.PHONY: clean
+clean:
+	-python3 -m coverage erase
+	-python3 -m pip uninstall -y "$(name)"
+	find . -depth \( -name '*.pyc' -o -name '__pycache__' -o -name '__pypackages__' \
+		-o -name '*.pyc' -o -name '*.pyd' -o -name '*.pyo' -o -name '*.egg-info' \
+		-o -name '*.py,cover'  \) -not -path "./.?*/*" \
+		-exec rm -rf \{\} \;
+	rm -rf site.py build/ dist/ "$(name).spec" VERSION bin/ .tox/ .pytest_cache/
+
+
+# https://packaging.python.org/en/latest/guides/using-testpypi/
+# Upload to https://test.pypi.org/
+.PHONY: test_upload
+test_upload: build
+	twine upload --repository testpypi dist/keyclean-*.whl dist/keyclean-*.tar.gz
+
+
+# Upload to https://pypi.org/
+.PHONY: upload
+upload: build
+	twine upload dist/keyclean-*.whl dist/keyclean-*.tar.gz

keyclean-0.9.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: keyclean
+Version: 0.9.0
+Summary: Cross-platform keyboard cleaning utility — lock your keyboard, wipe it clean.
+Project-URL: Homepage, https://github.com/gunchev/keyclean
+Project-URL: Repository, https://github.com/gunchev/keyclean
+Author: Doncho Nikolaev Gunchev
+License-Expression: Unlicense
+License-File: LICENSE
+Keywords: cleaning,keyboard,pygame,utility
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: MacOS X
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: X11 Applications
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: The Unlicense (Unlicense)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: pygame-ce>=2.4.0
+Provides-Extra: grab
+Requires-Dist: pynput>=1.7.6; extra == 'grab'
+Provides-Extra: linux
+Requires-Dist: python-xlib>=0.33; extra == 'linux'
+Requires-Dist: pywayland>=0.4.0; extra == 'linux'
+Provides-Extra: macos
+Requires-Dist: pyobjc-framework-quartz>=9.0; extra == 'macos'
+Provides-Extra: windows
+Description-Content-Type: text/markdown
+
+# KeyClean
+
+Cross-platform keyboard cleaning utility. Locks the keyboard, visualizes keypresses on a
+full ISO 105-key layout, and suppresses input to the OS — so you can wipe your physical
+keyboard without triggering commands.
+
+> Vibe-coded using [Claude Sonnet 4.6](https://www.anthropic.com/claude).
+
+## Installation
+
+```bash
+pip install keyclean
+```
+
+Platform extras for stronger input suppression:
+
+```bash
+pip install "keyclean[grab]"        # pynput (macOS / Windows)
+pip install "keyclean[grab,linux]"  # pynput + python-xlib (Linux X11)
+```
+
+## Usage
+
+```bash
+keyclean
+# or
+python -m keyclean
+# or from the dev tree
+uv run keyclean
+```
+
+The application launches fullscreen. All keypresses are shown on the virtual keyboard and
+counted but have no effect on the OS.
+
+### Exit
+
+- Type **`keys are clean`** on the physical keyboard, or
+- Click the **Done** button with the mouse.
+
+## Platform Notes
+
+| Platform        | Suppression method       | Notes                                      |
+|-----------------|--------------------------|--------------------------------------------|
+| Linux (X11)     | `XGrabKeyboard`          | Full suppression while window is focused   |
+| Linux (Wayland) | SDL2 `shortcuts_inhibit` | Best-effort; Ctrl+Alt+F* cannot be blocked |
+| macOS           | `pynput` / CGEventTap    | Requires Accessibility permission          |
+| Windows         | `pynput` / LowLevelHook  | Ctrl+Alt+Del cannot be blocked (by design) |
+
+Without the optional extras the app falls back to pygame-only mode (fullscreen), which prevents
+most accidental input but a warning banner is displayed.
+
+## Development
+
+Clone and set up the dev environment with [uv](https://docs.astral.sh/uv/):
+
+```bash
+git clone https://github.com/gunchev/keyclean
+cd keyclean
+uv sync --group dev              # core dev tools + pynput
+uv sync --group dev --extra linux  # also install python-xlib (Linux X11)
+```
+
+Run the test suite:
+
+```bash
+uv run pytest
+# or via make
+make test
+
+```
+
+Lint and format:
+
+```bash
+make lint        # pylint
+make pep8format  # autopep8
+```
+
+Build a wheel:
+
+```bash
+make build
+```
+
+Publish to PyPI / TestPyPI:
+
+```bash
+make upload       # PyPI
+make test_upload  # TestPyPI
+```
+
+Dependency groups:
+
+| Command                 | Installs                                                     |
+|-------------------------|--------------------------------------------------------------|
+| `uv sync --group dev`   | dev toolchain (pytest, pylint, autopep8, tox, twine, pynput) |
+| `uv sync --extra grab`  | `pynput` (runtime, macOS/Windows suppression)                |
+| `uv sync --extra linux` | `python-xlib` (runtime, Linux X11 suppression)               |
+| `uv sync --extra macos` | `pyobjc-framework-Quartz` (runtime, macOS)                   |
+
+## License
+
+This is free and unencumbered software released into the public domain.
+See [LICENSE](LICENSE) or <https://unlicense.org>.