Distinction between the two timeouts

[Dzol]

I read the various issues here around timeouts but none explain the difference between the two that are documented. What exactly do the timeout and recv_timeout options mean? I'm guessing the following:

• timeout to establish (open) a TCP connection
• recv_timeout to receive an HTTP response having sent a request

The documentation says "timeout used when receiving a connection" for the recv_timeout but I wouldn't say we receive a connection as a client 😕 Is the guess above right?

[edgurgel]

Oh hey! Yes, it's confusing. Take a look at this issue and it may help clarify things: #215

[Dzol]

Hey 🙂

I dug into Hackney... its connect_timeout is about TCP session establishment and the recv_timeout is about HTTP response time. I'll get the source references together and post a PR with a description in documentation in the coming week.

How does that sound?

[edgurgel]

That would be great 👍

[Dzol]

Hey @edgurgel,

Thanks for your patience. I opened a small PR.

Do you have some suggestions on the phrasing that would make the details even more clear.

[edgurgel]

Awesome thanks!