Skip to content

fix doc drift and misleading add_done_callback comments#23

Merged
lesnik512 merged 1 commit intomainfrom
docs-and-comments-cleanup
May 4, 2026
Merged

fix doc drift and misleading add_done_callback comments#23
lesnik512 merged 1 commit intomainfrom
docs-and-comments-cleanup

Conversation

@lesnik512
Copy link
Copy Markdown
Member

README/CLAUDE.md: SIGQUIT was never wired up (only SIGTERM/SIGINT); shutdown timeout default is 20 s not 10 s; the in-flight task tracker is now a counter + asyncio.Event (set was dropped in 1aba826); the shutdown wait uses Event.wait() not asyncio.gather; KafkaBatchCommitter description rewritten for the streaming loop. Also corrected the DI middleware ordering claim — first registered is outermost in FastStream broker_middlewares (verified against faststream _internal/endpoint/subscriber).

processing.py / batch_committer.py: comments claimed add_done_callback fires synchronously when the future is already done; per Python docs it always schedules via loop.call_soon. Reworded to describe the actual mechanism.

README/CLAUDE.md: SIGQUIT was never wired up (only SIGTERM/SIGINT);
shutdown timeout default is 20 s not 10 s; the in-flight task tracker
is now a counter + asyncio.Event (set was dropped in 1aba826); the
shutdown wait uses Event.wait() not asyncio.gather; KafkaBatchCommitter
description rewritten for the streaming loop. Also corrected the DI
middleware ordering claim — first registered is outermost in
FastStream broker_middlewares (verified against faststream
_internal/endpoint/subscriber).

processing.py / batch_committer.py: comments claimed
add_done_callback fires synchronously when the future is already
done; per Python docs it always schedules via loop.call_soon.
Reworded to describe the actual mechanism.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@lesnik512 lesnik512 self-assigned this May 4, 2026
@lesnik512 lesnik512 merged commit 28ae6c5 into main May 4, 2026
5 checks passed
@lesnik512 lesnik512 deleted the docs-and-comments-cleanup branch May 4, 2026 05:34
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