0003. Register handlers explicitly, not with decorators¶
Status: Accepted
Date: 2026-09-18 (practised since the first release; written down today)
Deciders: maintainer
Context¶
pygls handlers are conventionally declared with @server.feature(...)
and @server.command(...). mutmut 3 never mutates a decorated
function, so the eleven handlers were outside mutation testing; a first
run produced no mutants for them.
Options considered¶
Keep the decorators and accept that the handlers are untested by mutation; the score describes the helpers only.
Register the same functions by explicit calls after the definitions; the registered object, name, signature and order are identical.
Decision¶
Option 2. The handlers are what the editor calls; a mutation score that excludes them measures the wrong thing. The first honest run scored 76.5 percent and exposed that no test pinned the diagnostics’ positions or messages; sixteen tests now do, and the score is gated.
Consequences¶
A new handler is added as a plain function plus one registration line
in the block before main(). mutation.yml fails a pull request
below the floor in the Makefile. The stdio end-to-end test proves the
registrations still serve every feature.