�
�S�g� � �� � U d Z ddlmZ ddlZddlZddlmZ ddlmZ ddl m
Z
ddl m Z e rddl
mZ eeeef Zd ed
< d Zd � d
d � �Z G d� de� Z G d� de� Z G d� de� Zd� Zy)z�Provide basic warnings used by setuptools modules.
Using custom classes (other than ``UserWarning``) allow users to set
``PYTHONWARNINGS`` filters to run tests and prepare for upcoming changes in
setuptools.
� )� annotationsN)�date)�cleandoc)�indent)�
TYPE_CHECKING)� TypeAliasr �_DueDatez zP********************************************************************************z
{details}
c �z � e Zd ZdZe d dd�� Ze d dd�� Zy) �SetuptoolsWarningz/Base class in ``setuptools`` warning hierarchy.Nc � � |xs t | dd� xs d}|xs t | dd� xs d} |xs
t | dd� }|xs
t | dd� }
|
xr d|
� �} |xs
t | dd� }|rt |� nd} | j || | |xs | |� }
| r)| t j � k rt � r | |
� �t j |
| |d z �
� y) �6Private: reserved for ``setuptools`` internal use only�_SUMMARYN� �_DETAILS� _DUE_DATE� _SEE_DOCSz%https://setuptools.pypa.io/en/latest/�_SEE_URL� )�
stacklevel)�getattrr �_format�today�_should_enforce�warnings�warn)�cls�summary�details�due_date�see_docs�see_urlr �kwargs�summary_�details_�docs_ref�docs_url�due�texts ��/build/snapcraft-certbot-29b1212f749eeba2f1dece1adfe9a83a/parts/certbot/install/lib/python3.12/site-packages/setuptools/warnings.py�emitzSetuptoolsWarning.emit s� � � �B�g�c�:�t� <�B����B�g�c�:�t� <�B����>�w�s�K�� >���>�w�s�K�� >���R�"G��z� R���;�W�S�*�d� ;��!)�d�H�o�t���{�{�8�X�s�G�4G�x��P�� �3���� �%�/�*;��d�)�O��
�
�d�C�J��N�;� c � � t j � }t |� j |xs i � }t |� j |xs i � |r ||kD rd|d�d�nd|r||k rdnd|rd|� d�ndg}|D �cg c] }|s�|�� } }| rHt t
j
dj | � � � t � }
dj |d
|
d g� S |S c c}w ) r
z
By z%Y-%b-%dzi, you need to update your project and remove deprecated calls
or your builds will no longer be supported.Nzy
This deprecation is overdue, please update your project and remove deprecated
calls to avoid build errors in the future.z
See z
for details.�
)r z!!
z
!!) r r r �
format_mapr � _TEMPLATE�format�join�_INDENT) r r r r r! � format_argsr �possible_parts�x�parts�bodys r) r zSetuptoolsWarning._format6 s� � � �
�
� ���7�#�.�.�{�/@�b�A�� �W� � (� (��):�� ;� ��5� 0� ���*� +P� P� �
��5� 0�I� �07�v�g�Y�m�
,�T�
�� +�0�q�a��0��0� ��)�*�*�4�9�9�U�3C�*�D�g�N�D��9�9�g�v�t�V� <�=� =���� 1s �8C� C)NNNNN� )r �
str | Noner r9 r z_DueDate | Noner r9 r! r9 r �int�return�None)NNN) r �strr r= r z date | Noner! r9 r3 z dict | Noner; r= )�__name__�
__module__� __qualname__�__doc__� classmethodr* r � r+ r) r r s� � �9�� #� "�$(� #� "��<��<� �<� "� <�
� <� �
<� �<�
�<� �<�2 �
!%� "�#'�
�� � � � � �
� � !�
�
� � � r+ r c � � e Zd ZdZy)�InformationOnlya Currently there is no clear way of displaying messages to the users
that use the setuptools backend directly via ``pip``.
The only thing that might work is a warning, although it is not the
most appropriate tool for the job...
See pypa/packaging-problems#558.
N�r> r? r@ rA rC r+ r) rE rE Y s � �r+ rE c � � e Zd ZdZy)� SetuptoolsDeprecationWarningz�
Base class for warning deprecations in ``setuptools``
This class is not derived from ``DeprecationWarning``, and as such is
visible by default.
NrF rC r+ r) rH rH c s � �r+ rH c �R � t j dd� j � } | dv S )N� SETUPTOOLS_ENFORCE_DEPRECATION�false)�true�on�ok�1)�os�getenv�lower)�enforces r) r r l s( � ��i�i�8�'�B�H�H�J�G� �/� /�/r+ )rA �
__future__r rP r �datetimer �inspectr �textwrapr �typingr �typing_extensionsr �tupler: r �__annotations__r2 r/ � UserWarningr rE rH r rC r+ r) �<module>r] s} ��� #� � � � � � ��+��C��c�M�*��)� *�
���
�/�(�� 6� �=� � =�@�'� ��#4� �0r+ |