File: //lib/python3/dist-packages/pip/_vendor/cachecontrol/__pycache__/heuristics.cpython-312.pyc
�
��h� � �� � d dl mZ d dlZd dlZd dlmZmZmZ d dlmZm Z m
Z
d dl m Z m
Z
mZ e rd dlmZ dZddd�Zdd �Z G d
� d � Z G d � d
e� Z G d� de� Z G d� de� Zy)� )� annotationsN)�datetime� timedelta�timezone)�
formatdate� parsedate� parsedate_tz)�
TYPE_CHECKING�Any�Mapping)� HTTPResponsez%a, %d %b %Y %H:%M:%S GMTc �Z � |xs# t j t j � }|| z S �N)r �nowr �utc)�delta�dates �E/usr/lib/python3/dist-packages/pip/_vendor/cachecontrol/heuristics.py� expire_afterr s# � � � -�8�<�<�� � �-�D� �%�<�� c �Z � t t j | j � � � S r )r �calendar�timegm� timetuple)�dts r �datetime_to_headerr s � � �h�o�o�b�l�l�n�5� 6�6r c �$ � e Zd Zdd�Zdd�Zdd�Zy)�
BaseHeuristicc � � y)a!
Return a valid 1xx warning header value describing the cache
adjustments.
The response is provided too allow warnings like 113
http://tools.ietf.org/html/rfc7234#section-5.5.4 where we need
to explicitly say response is over 24 hours old.
z110 - "Response is Stale"� ��self�responses r �warningzBaseHeuristic.warning s � � +r c � � i S )z�Update the response headers with any new headers.
NOTE: This SHOULD always include some Warning header to
signify that the response was cached by the client, not
by way of the provided headers.
r r! s r �update_headersz BaseHeuristic.update_headers' s � � � r c �� � | j |� }|rK|j j |� | j |� }|� |j j d|i� |S )N�Warning)r& �headers�updater$ )r" r# �updated_headers�warning_header_values r �applyzBaseHeuristic.apply0 s] � � �-�-�h�7�� � � � � #� #�O� 4�#'�<�<��#9� �#�/�� � �'�'��4H�(I�J��r N�r# r
�return�
str | None�r# r
r/ �dict[str, str])r# r
r/ r
)�__name__�
__module__� __qualname__r$ r& r- r r r r r s � � +�� r r c � � e Zd ZdZdd�Zy)� OneDayCachezM
Cache the response by providing an expires 1 day in the
future.
c �� � i }d|j vr\t |j d � }t t d�� t |d d dt
j i��� }t |� |d< d|d < |S )
N�expiresr � )�days� �tzinfo)r �public�
cache-control)r) r r r r r r r )r" r# r) r r9 s r r& zOneDayCache.update_headersB sp � ��� �H� ,� ,� ,� �X� -� -�f� 5�6�D�"�9�!�#4�8�T�"�1�X�;c�V^�Vb�Vb�;c�d�G�!3�G�!<�G�I� �'/�G�O� $��r Nr1 )r3 r4 r5 �__doc__r& r r r r7 r7 < s � ��
r r7 c �( � e Zd ZdZdd�Zdd�Zdd�Zy) � ExpiresAfterz;
Cache **all** requests for a defined time period.
c �$ � t di |��| _ y )Nr )r r )r" �kws r �__init__zExpiresAfter.__init__R s � � �_��_��
r c �H � t | j � }t |� dd�S )Nr> )r9 r? )r r r )r" r# r9 s r r& zExpiresAfter.update_headersU s � � �t�z�z�*��-�g�6��R�Rr c �$ � d}|| j z S )Nz:110 - Automatically cached for %s. Response might be stale)r )r" r# �tmpls r r$ zExpiresAfter.warningY s � �K���d�j�j� � r N)rD r r/ �Noner1 r. )r3 r4 r5 r@ rE r& r$ r r r rB rB M s � ��%�S�!r rB c �( � e Zd ZdZh d�Zdd�Zdd�Zy)� LastModifieda�
If there is no Expires header already, fall back on Last-Modified
using the heuristic from
http://tools.ietf.org/html/rfc7234#section-4.2.2
to calculate a reasonable value.
Firefox also does something like this per
https://developer.mozilla.org/en-US/docs/Web/HTTP/Caching_FAQ
http://lxr.mozilla.org/mozilla-release/source/netwerk/protocol/http/nsHttpResponseHead.cpp#397
Unlike mozilla we limit this to 24-hr.
> �, �- � � � � � �� �� �� �� c � � |j }d|v ri S d|v r
|d dk7 ri S |j | j vri S d|vsd|vri S t |d � }|�J �t j
|d d � }t
|d � }|�i S t j � }t d||z
� }|t j
|� z
}t dt |dz d � � } | |k ri S || z }
dt j t t j |
� � iS )
Nr9 r? r> r z
last-modifiedr< r �
i�Q )
r) �status� cacheable_by_default_statusesr r r r �time�max�min�strftime�TIME_FMT�gmtime) r" �respr) �
time_tupler �
last_modifiedr � current_ager �freshness_lifetimer9 s r r& zLastModified.update_headersy s! � �%)�\�\�� �� ��I� �g� %�'�/�*B�h�*N��I� �;�;�d� @� @� @��I� �� �O�7�$B��I�!�'�&�/�2�
��%�%�%����z�"�1�~�.��!�'�/�":�;�
� � ��I��i�i�k���!�S�4�Z�(� ��x���}�5�5�� ��C���
�I�$>� ?�� �� ,��I��+�+���4�=�=��4�;�;�w�3G�H�I�Ir c � � y r r )r" ra s r r$ zLastModified.warning� s � �r N)ra r
r/ r2 )ra r
r/ r0 )r3 r4 r5 r@ rZ r& r$ r r r rK rK ^ s � �
� %�!� J�@r rK r )r r r zdatetime | Noner/ r )r r r/ �str)�
__future__r r r[ r r r � email.utilsr r r �typingr
r r �pip._vendor.urllib3r
r_ r r r r7 rB rK r r r �<module>rl sf �� #� � � 2� 2� ;� ;� .� .��0� &���
7� � �B�-� �"!�=� !�"<�=� <r