Skip to content

Comments

Clarify TimeoutBody documentation#574

Merged
seanmonstar merged 3 commits intotower-rs:mainfrom
mherrerarendon:patch-1
May 30, 2025
Merged

Clarify TimeoutBody documentation#574
seanmonstar merged 3 commits intotower-rs:mainfrom
mherrerarendon:patch-1

Conversation

@mherrerarendon
Copy link
Contributor

Adds a couple of clarifying lines to the TimeoutBody documentation to explain that the timeout applies to the time interval between frame polls, as opposed to the entirety of the body.

Motivation

I was confused about why the timeout was not being triggered even though the time it took to stream the response was longer than the timeout. It wasn't until I looked at what the code was doing that I realized why the timeout was not being triggered.

@seanmonstar
Copy link
Collaborator

Thanks for improving the docs! I'm always for making things clearer. One question: does the following existing line say something similar?

If the body does not produce a requested data frame within the timeout period, it will return an error.

Should the lines be collapsed somehow?

@mherrerarendon
Copy link
Contributor Author

Thanks for improving the docs! I'm always for making things clearer. One question: does the following existing line say something similar?

If the body does not produce a requested data frame within the timeout period, it will return an error.

Should the lines be collapsed somehow?

@seanmonstar You are right, I've updated it. Let me know what you think!

@seanmonstar seanmonstar merged commit 7388e76 into tower-rs:main May 30, 2025
11 checks passed
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.

2 participants