�
�S�gj( � �� � U d dl mZ d dlZd dlZd dlmZ d dlmZ ddlm Z ej rd dlm Z G d� d e� Z e j Zd
ed < ej ej" ee f Z G d � d
� Zy)� )� annotationsN)�Enum)�getdefaulttimeout� )�TimeoutStateError)�Finalc � � e Zd ZdZy)�
_TYPE_DEFAULT���N)�__name__�
__module__� __qualname__�token� � ��/build/snapcraft-certbot-29b1212f749eeba2f1dece1adfe9a83a/parts/certbot/install/lib/python3.12/site-packages/urllib3/util/timeout.pyr
r
s � �
�Er r
zFinal[_TYPE_DEFAULT]�_DEFAULT_TIMEOUTc � � e Zd ZU dZeZded< deef dd�Zdd�ZeZ e
dd�� Z e dd�� Z
e dd �� Zdd
�Zdd �Zdd �Zedd
�� Zedd�� Zy)�Timeouta� Timeout configuration.
Timeouts can be defined as a default for a pool:
.. code-block:: python
import urllib3
timeout = urllib3.util.Timeout(connect=2.0, read=7.0)
http = urllib3.PoolManager(timeout=timeout)
resp = http.request("GET", "https://example.com/")
print(resp.status)
Or per-request (which overrides the default for the pool):
.. code-block:: python
response = http.request("GET", "https://example.com/", timeout=Timeout(10))
Timeouts can be disabled by setting all the parameters to ``None``:
.. code-block:: python
no_timeout = Timeout(connect=None, read=None)
response = http.request("GET", "https://example.com/", timeout=no_timeout)
:param total:
This combines the connect and read timeouts into one; the read timeout
will be set to the time leftover from the connect attempt. In the
event that both a connect timeout and a total are specified, or a read
timeout and a total are specified, the shorter timeout will be applied.
Defaults to None.
:type total: int, float, or None
:param connect:
The maximum amount of time (in seconds) to wait for a connection
attempt to a server to succeed. Omitting the parameter will default the
connect timeout to the system default, probably `the global default
timeout in socket.py
<http://hg.python.org/cpython/file/603b4d593758/Lib/socket.py#l535>`_.
None will set an infinite timeout for connection attempts.
:type connect: int, float, or None
:param read:
The maximum amount of time (in seconds) to wait between consecutive
read operations for a response from the server. Omitting the parameter
will default the read timeout to the system default, probably `the
global default timeout in socket.py
<http://hg.python.org/cpython/file/603b4d593758/Lib/socket.py#l535>`_.
None will set an infinite timeout.
:type read: int, float, or None
.. note::
Many factors can affect the total amount of time for urllib3 to return
an HTTP response.
For example, Python's DNS resolver does not obey the timeout specified
on the socket. Other factors that can affect total request time include
high CPU load, high swap, the program running at a low priority level,
or other behaviors.
In addition, the read and total timeouts only measure the time between
read operations on the socket connecting the client and the server,
not the total amount of time for the request to return a complete
response. For most requests, the timeout is raised because the server
has not sent the first byte in the specified time. This is not always
the case; if a server streams one byte every fifteen seconds, a timeout
of 20 seconds will not trigger, even though the request will take
several minutes to complete.
�
_TYPE_TIMEOUT�DEFAULT_TIMEOUTNc � � | j |d� | _ | j |d� | _ | j |d� | _ d | _ y )N�connect�read�total)�_validate_timeout�_connect�_readr �_start_connect)�selfr r r s r �__init__zTimeout.__init__m sH � � �.�.�w� �B��
��+�+�D�&�9��
��+�+�E�7�;��
�,0��r c � � t | � j � d| j �d| j �d| j �d�S )Nz (connect=z, read=z, total=�))�typer r r r �r s r �__repr__zTimeout.__repr__x s? � ��t�*�%�%�&�i��
�
�/@���
�
�~�U]�^b�^h�^h�]k�kl�m�mr c �* � | t u r
t � S | S )N)r r )�timeouts r �resolve_default_timeoutz Timeout.resolve_default_timeout~ s � �&-�1A�&A� �"�N�w�Nr c �* � |�|t u r|S t |t � r t d� � t |� |dk rt d|�d|�d �� � |S # t
t f$ r t d|�d|�d�� d�w xY w# t
$ r t d|�d|�d�� d�w xY w)
a� Check that a timeout attribute is valid.
:param value: The timeout value to validate
:param name: The name of the timeout attribute to validate. This is
used to specify in error messages.
:return: The validated and casted version of the given value.
:raises ValueError: If it is a numeric value less than or equal to
zero, or the type is not an integer, float, or None.
NzDTimeout cannot be a boolean value. It must be an int, float or None.zTimeout value z was z', but it must be an int, float or None.r zAttempted to set z timeout to zC, but the timeout cannot be set to a value less than or equal to 0.)r �
isinstance�bool�
ValueError�float� TypeError)�cls�value�names r r zTimeout._validate_timeout� s� � � �=�E�%5� 5��L� �e�T� "� �,��
� � �%�L� ���z� � .2�5�:�� � � � ��' �:�&� � �)-�u�6�� �
� �� � � �)-�u�6�� �
� �s � A �A5 �#A2�5 Bc � � t ||�� S )a Create a new Timeout from a legacy timeout value.
The timeout value used by httplib.py sets the same timeout on the
connect(), and recv() socket requests. This creates a :class:`Timeout`
object that sets the individual timeouts to the ``timeout`` value
passed to this function.
:param timeout: The legacy timeout value.
:type timeout: integer, float, :attr:`urllib3.util.Timeout.DEFAULT_TIMEOUT`, or None
:return: Timeout object
:rtype: :class:`Timeout`
)r r )r )r0 r( s r �
from_floatzTimeout.from_float� s � � �G�W�5�5r c �Z � t | j | j | j �� S )a Create a copy of the timeout object
Timeout properties are stored per-pool but each request needs a fresh
Timeout object to ensure each one has its own start/stop configured.
:return: a copy of the timeout object
:rtype: :class:`Timeout`
)r r r )r r r r r% s r �clonez
Timeout.clone� s � � �t�}�}�4�:�:�T�Z�Z�P�Pr c �z � | j � t d� �t j � | _ | j S )z�Start the timeout clock, used during a connect() attempt
:raises urllib3.exceptions.TimeoutStateError: if you attempt
to start a timer that has been started already.
z'Timeout timer has already been started.�r r �time� monotonicr% s r �
start_connectzTimeout.start_connect� s7 � � � � � *�#�$M�N� N� "�n�n� .����"�"�"r c �r � | j � t d� �t j � | j z
S )a Gets the time elapsed since the call to :meth:`start_connect`.
:return: Elapsed time in seconds.
:rtype: float
:raises urllib3.exceptions.TimeoutStateError: if you attempt
to get duration for a timer that hasn't been started.
z:Can't get connect duration for timer that has not started.r8 r% s r �get_connect_durationz Timeout.get_connect_duration� s: � � � � � &�#�L��
� �~�~� �$�"5�"5�5�5r c �� � | j � | j S | j �| j t u r | j S t | j | j � S )a! Get the value to use when setting a connection timeout.
This will be a positive float or integer, the value None
(never timeout), or the default system timeout.
:return: Connect timeout.
:rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
)r r r �minr% s r �connect_timeoutzTimeout.connect_timeout� sM � � �:�:� ��=�=� � �=�=� �D�M�M�5E�$E��:�:� ��4�=�=�$�*�*�-�-r c �� � | j ��| j t urq| j �e| j t urS| j � | j S t dt | j | j
� z
| j � � S | j �9| j t ur't d| j | j
� z
� S | j | j � S )a{ Get the value for the read timeout.
This assumes some time has elapsed in the connection timeout and
computes the read timeout appropriately.
If self.total is set, the read timeout is dependent on the amount of
time taken by the connect timeout. If the connection time has not been
established, a :exc:`~urllib3.exceptions.TimeoutStateError` will be
raised.
:return: Value to use for the read timeout.
:rtype: int, float or None
:raises urllib3.exceptions.TimeoutStateError: If :meth:`start_connect`
has not yet been called on this object.
r )r r r r �maxr? r= r) r% s r � read_timeoutzTimeout.read_timeout� s� � �$
�J�J� "��
�
�"2�2��
�
�&��
�
�"2�2� �"�"�*��z�z�!��q�#�d�j�j�4�+D�+D�+F� F��
�
�S�T� T�
�Z�Z�
#��
�
�:J�(J��q�$�*�*�t�'@�'@�'B�B�C� C��/�/��
�
�;� ;r )r r r r r r �return�None)rD �str)r( r rD � float | None)r1 r r2 rF rD r )r( r rD r )rD r )rD r. )rD r )rD rG )r r
r �__doc__r r �__annotations__r! r& �__str__� staticmethodr) � classmethodr r4 r6 r; r= �propertyr@ rC r r r r r s� � �N�b &6�O�]�5� $�!1� .� 1� � 1� � 1� � 1�
� 1�n� �G��O� �O� �'� �'�R �
6� �
6� Q� #� 6� �.� �.�" � <� � <r r )�
__future__r r9 �typing�enumr �socketr �
exceptionsr �
TYPE_CHECKINGr r
r r rI �Optional�Unionr. r r r r r �<module>rV sk �� "� �
� � $� *� ��� ��D� � *7�)<�)<� �&� <����� � �U�M�-A� B�C�
�z<� z<r |