Skip to content

Document flow-control changes from remote settings - #1337

Open
ac1982 wants to merge 1 commit into
python-hyper:masterfrom
ac1982:docs/settings-flow-control-events
Open

ac1982 wants to merge 1 commit into
python-hyper:masterfrom
ac1982:docs/settings-flow-control-events

Conversation

@ac1982

@ac1982 ac1982 commented Oct 14, 2026

Copy link
Copy Markdown

The sending flow-control guide describes waking blocked streams after WindowUpdated, but a peer can also resize stream windows through SETTINGS_INITIAL_WINDOW_SIZE. That path emits RemoteSettingsChanged without a WindowUpdated event, so an application following only the documented wake-up path can remain blocked after its window grows.

Document checking changed settings and rechecking each blocked stream's available window. Cover decreases (including negative windows), the unchanged connection limit, and new streams. Also narrow the WindowUpdated API description, which currently claims the event fires whenever a window changes.

Related to #1193. This documents the current event API; it does not change the proposed event behavior.

Validation: a two-peer public-API exchange checks exhaustion, SETTINGS/ACK-based unblocking, negative windows, connection limits, new streams, and normal closure. All 1,662 tests pass on Python 3.14/Linux arm64 (two pytest deprecation warnings), and the Sphinx HTML build passes with warnings treated as errors. No runtime logic changes.

AI assistance was used for the documentation and validation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant