Requiring 3.13 meant the device needed an interpreter the distribution does not
have, which is what dragged uv in, and uv then had to be matched to the Pi's
32-bit userland by hand and to build Pillow from source because no armv7 wheel
exists for a 3.13 ABI. Dropping to 3.11 removes all of that: apt provides the
interpreter and piwheels has prebuilt armhf wheels for the native dependencies.
The 3.13-only syntax was shallow - PEP 695 throughout, which converts back
mechanically:
type X = Y -> X: TypeAlias = Y
type Handler[E: Event] -> E = TypeVar("E", bound=Event) plus a plain alias,
which is generic anyway because it carries a TypeVar
def f[T: Bound](...) -> a module-level TypeVar
Also drop the one @override (3.12, and static-only), and stop the lirc test
harness calling Server.close_clients(), which is 3.13: the scripted handler now
releases its connection when asked, which is what that call was there to force.
Verified on 3.11.14 - 485 passed, mypy strict clean - and still 496 passed on
the 3.14 dev venv, which additionally has the analysis extra.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
80 lines
2.9 KiB
TOML
80 lines
2.9 KiB
TOML
[project]
|
|
name = "musicmouse"
|
|
version = "2.0.0"
|
|
description = "Host backend for the MusicMouse RFID music player"
|
|
# Raspberry Pi OS (Bookworm) ships Python 3.11, and its system interpreter is what the
|
|
# device runs. Staying on it means apt and piwheels supply prebuilt armhf wheels for
|
|
# the native dependencies (pydantic-core, Pillow), instead of needing a separate
|
|
# toolchain to fetch a newer interpreter and compile them on the Pi.
|
|
requires-python = ">=3.11"
|
|
dependencies = [
|
|
"aiomqtt>=2.0",
|
|
"fastapi>=0.115",
|
|
# Podcast RSS feeds in the wild are full of small quirks (odd dates, missing
|
|
# namespaces); parsing them by hand invites silently dropping episodes.
|
|
"feedparser>=6.0",
|
|
# Also what tests drive the ASGI app with - plain httpx is deprecated in favour of
|
|
# this for exactly that. Runtime uses it to proxy the room page's Home Assistant
|
|
# calls, so the long-lived token never has to leave the backend.
|
|
"httpx2>=2.12",
|
|
"mutagen>=1.47",
|
|
"pillow>=10.4",
|
|
"pydantic>=2.7",
|
|
"pyserial-asyncio>=0.6",
|
|
"python-vlc>=3.0",
|
|
"ruamel.yaml>=0.18",
|
|
"uvicorn>=0.30",
|
|
# uvicorn ships no websocket implementation of its own; without this the
|
|
# state-push upgrade is answered with a 404 and the UI never updates.
|
|
"websockets>=13",
|
|
]
|
|
|
|
[project.optional-dependencies]
|
|
dev = ["mypy>=1.10", "pytest-asyncio>=0.23", "pytest>=8.0", "ruff>=0.5"]
|
|
# Off by default: the reactive background is nice, not required, and librosa/numpy are
|
|
# a real install cost on a Pi. Missing this group means `build_analyzer()` falls back
|
|
# to `NullAnalyzer` and the background stays at its static baseline - never a crash.
|
|
analysis = ["librosa>=1.0", "numpy>=2.0"]
|
|
|
|
[project.scripts]
|
|
musicmouse = "musicmouse.__main__:main"
|
|
|
|
[build-system]
|
|
requires = ["setuptools>=68"]
|
|
build-backend = "setuptools.build_meta"
|
|
|
|
[tool.setuptools.packages.find]
|
|
include = ["musicmouse*"]
|
|
|
|
[tool.pytest.ini_options]
|
|
testpaths = ["tests"]
|
|
asyncio_mode = "auto"
|
|
asyncio_default_fixture_loop_scope = "function"
|
|
filterwarnings = ["error"]
|
|
|
|
[tool.ruff]
|
|
line-length = 100
|
|
target-version = "py311"
|
|
# Course material and scratch work, not part of the backend. See notebooks/README.md.
|
|
extend-exclude = ["notebooks"]
|
|
|
|
[tool.ruff.lint]
|
|
select = ["ARG", "B", "C4", "E", "F", "I", "N", "PTH", "RUF", "SIM", "UP", "W"]
|
|
|
|
[tool.ruff.lint.per-file-ignores]
|
|
"tests/*" = ["ARG001"]
|
|
# Entity is an ABC with optional hooks: empty bodies and unused args are the point.
|
|
"musicmouse/services/mqtt/entity.py" = ["ARG002", "B027"]
|
|
|
|
[tool.mypy]
|
|
python_version = "3.11"
|
|
strict = true
|
|
files = ["musicmouse"]
|
|
warn_unreachable = true
|
|
|
|
[[tool.mypy.overrides]]
|
|
# numpy ships its own types, but only when the `analysis` extra is installed - a plain
|
|
# checkout must still type-check clean, so it needs the same treatment as librosa.
|
|
module = ["vlc", "serial_asyncio", "ruamel.*", "librosa.*", "numpy", "feedparser"]
|
|
ignore_missing_imports = true
|