Make documentation standalone and generalize examples

This commit is contained in:
Melvin Strobl
2026-10-25 14:43:20 +01:00
parent 13bf0f76d7
commit bdb18b99da
57 changed files with 553 additions and 481 deletions
+4 -9
View File
@@ -211,11 +211,8 @@ def test_only_advisory_codes_are_flagged_advisory():
def test_a_producer_that_cannot_run_does_not_strand_its_consumer():
"""One wave, two producers of one consumer, and one of them never ready.
The house's shape: a battery reading wakes the boiler arbiter and the
watering-pump trigger in the same wave, and the DMX encoder reads both. The
pump waits on a pulse that only exists at 02:00, so it is never ready — and
passing over it used to leave the encoder unreachable, which put every
boiler and plug command into its message and no further.
The ready producer must reach its consumer even when a sibling is
waiting for an input. The consumer can use that sibling's stored value.
"""
ran = []
@@ -268,10 +265,8 @@ def test_a_producer_that_cannot_run_does_not_strand_its_consumer():
def test_a_quiet_producer_does_not_veto_a_noisy_sibling():
"""Two report-by-exception producers, one consumer, and only one with news.
The house reads both boilers into one DMX encoder through `rbe` nodes. The
kitchen boiler is unchanged almost always, so it returns nothing — and
while that held the encoder's dependency count up, the main boiler's
command reached its message and got no further.
A producer that publishes nothing must not block a shared consumer
from processing its sibling's new value.
"""
ran = []