UnixHTTPConnectionPool

The UnixHTTPConnectionPool is a Python library that provides a way to establish a pool of HTTP connections to Unix domain sockets using HTTP/1.1 or HTTP/2 protocols.

Timeout

One of the features of the UnixHTTPConnectionPool is the ability to set timeouts for various operations such as read and connect. The read timeout is the time limit for reading the data from the socket. It ensures that the socket does not wait indefinitely for data that may never arrive.

In the provided error message:

UnixHTTPConnectionPool(host='localhost', port=None): Read timed out. (read timeout = 60)

It indicates that the read timed out after 60 seconds. This means that the UnixHTTPConnectionPool failed to read the data from the server within the specified timeout period of 60 seconds.

Usage

The UnixHTTPConnectionPool can be instantiated with the following parameters:

• socket_path: path to the Unix domain socket
• maxsize: maximum number of connections in the pool
• block: block requests until a connection is available
• headers: HTTP headers to be sent with every request
• connection_timeout: timeout for establishing a connection
• read_timeout: timeout for reading data from the socket
• keepalive: whether to enable TCP keep-alive

import requests_unixsocket

session = requests_unixsocket.Session()
pool = requests_unixsocket.UnixHTTPConnectionPool(socket_path='/var/run/docker.sock',
                                                  maxsize=10,
                                                  block=True,
                                                  headers={'Content-Type': 'application/json'},
                                                  connection_timeout=0.1,
                                                  read_timeout=60,
                                                  keepalive=True)

response = session.get('http+unix://%2Fvar%2Frun%2Fdocker.sock/v1.24/services',
                       pool=pool)

print(response.content)

Conclusion

In conclusion, the UnixHTTPConnectionPool library provides a powerful and flexible way to establish a pool of HTTP connections to Unix domain sockets. By setting the various timeout parameters appropriately, we can ensure that our connections are reliable and resilient to various network conditions.