�
�(�gS � �2 � d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl
m Z m Z m
Z
ddlmZmZ ddlmZ e ej& ef ZeZd� Zed de e defd �� Zd
ej& de e fd �Zej4 d e e dej& fd
�� Zej8 d edej& fd�� Z ej8 d ddej& fd�� Z d� Z d
ej& fd�Z ej@ d e jB d�d�� Z"d� Z#dede$fd�Z%ej4 d� � Z&e&j9 ejN � ej@ d� � � Z ej@ dejP fd�� Z)ej@ d� � Z*d � Z+y) � N)�Union�Optional�cast� )�ResourceReader� Traversable)� wrap_specc �` � �� t � �t j � � ��f� �fd� � }|S )a
Replace 'package' parameter as 'anchor' and warn about the change.
Other errors should fall through.
>>> files('a', 'b')
Traceback (most recent call last):
TypeError: files() takes from 0 to 1 positional arguments but 2 were given
c � �� |�ur1| �ur �| |� S t j dt d�� �|� S | �u r �� S �| � S )Nz/First parameter to files is renamed to 'anchor'� )�
stacklevel)�warnings�warn�DeprecationWarning)�anchor�package�func� undefineds ���2/usr/lib/python3.12/importlib/resources/_common.py�wrapperz"package_to_anchor.<locals>.wrapper! sZ �� � �)� #��Y�&��F�G�,�,� �M�M�A�"� �
�
��=� �
�y�
��6�M��F�|�� )�object� functools�wraps)r r r s ` @r �package_to_anchorr s3 �� � ��I��_�_�T�� �)� � � � �Nr r �returnc �* � t t | � � S )z3
Get a Traversable resource for an anchor.
)� from_package�resolve)r s r �filesr 3 s � �
���� (�(r r c �r � | j }t |j dd� }|�y ||j � S )z?
Return the package's loader if it's a ResourceReader.
�get_resource_readerN)�__spec__�getattr�loader�name�r �spec�readers r r" r" ; s9 � � � � �D�
�T�[�[�"7��
>�F�
�~�� �$�)�)� � r �candc �6 � t t j | � S �N)r �types�
ModuleType�r* s r r r K s � � �� � �$� '�'r c �, � t j | � S r, )� importlib�
import_moduler/ s r �_r3 P s � � � "� "�4� (�(r c �B � t t � j d � S )N�__name__)r �
_infer_caller� f_globalsr/ s r r3 r3 U s � � �=�?�,�,�Z�8� 9�9r c � � d� } d� }t j | t j � � }t j ||� }t |� j
S )zS
Walk the stack and find the frame of the first caller not in this module.
c �( � | j t k( S r, )�filename�__file__��
frame_infos r � is_this_filez#_infer_caller.<locals>.is_this_file_ s � ��"�"�h�.�.r c � � | j dk( S )Nr )�functionr< s r �
is_wrapperz!_infer_caller.<locals>.is_wrapperb s � ��"�"�i�/�/r )� itertools� filterfalse�inspect�stack�next�frame)r> rA �
not_this_file�callerss r r6 r6 Z sH � �
/�0� �)�)�,��
�
��H�M��#�#�J�
�>�G� ��=� � � r c � � t | � }|j j |j � }|j � S )z=
Return a Traversable object for the given package.
)r r% r" r& r r' s r r r k s2 � �
�W� �D�
�[�[�
,�
,�T�Y�Y�
7�F� �<�<�>�r )�
_os_removec # �p K � t j |�� \ }} t j | | � � t j |� ~ t j |� �� ||� y # t j |� w xY w# t $ r Y y w xY w# ||� w # t $ r Y w w xY wxY w�w�N)�suffix)�tempfile�mkstemp�os�write�close�pathlib�Path�FileNotFoundError)r) rN rK �fd�raw_paths r � _tempfilerY u s� � �� � �#�#�6�2�L�B�� � � �H�H�R��� "� �H�H�R�L� ��l�l�8�$�$� � �x� ��
�H�H�R�L�� !� � � �� � �x� �� � � � �so �B6�A0 �-B �'B
�/B6�0B�B �
B�B6�B�B6�B3�B$�#B3�$ B0�-B3�/B0�0B3�3B6c �D � t | j | j �� S rM )rY �
read_bytesr& ��paths r �
_temp_filer^ � s � � �T�_�_�T�Y�Y� 7�7r r] c � � t j t � 5 | j � cddd� S # 1 sw Y yxY w)a
Some Traversables implement ``is_dir()`` to raise an
exception (i.e. ``FileNotFoundError``) when the
directory doesn't exist. This function wraps that call
to always return a boolean and only return True
if there's a dir and it exists.
NF)�
contextlib�suppressrV �is_dirr\ s r �_is_present_dirrc � s4 � �
� � � .� /� ��{�{�}� � � � �s �4�=c �D � t | � r t | � S t | � S )zu
Given a Traversable object, return that object as a
path on the local file system in a context manager.
)rc � _temp_dirr^ r\ s r �as_filerf � s � � .�d� 3�9�T�?�I��D�9I�Ir c # � K � | �� y�w)z7
Degenerate behavior for pathlib.Path objects.
N� r\ s r r3 r3 � s
� �� � �J�s ��dirc # �h K � | 5 }t j |� �� ddd� y# 1 sw Y yxY w�w)zD
Wrap tempfile.TemporyDirectory to return a pathlib object.
N)rT rU )ri �results r �
_temp_pathrl � s0 � �� �
� #���l�l�6�"�"�#� #� #�s �2�&� 2�/�2c # � K � | j � sJ �t t j � � 5 }t || � �� ddd� y# 1 sw Y yxY w�w)zt
Given a traversable dir, recursively replicate the whole tree
to the file system in a context manager.
N)rb rl rO �TemporaryDirectory�_write_contents)r] �temp_dirs r re re � sJ � �� � �;�;�=��=� �H�/�/�1� 2� .�h� �h��-�-�.� .� .�s �0A�A
� A�
A�Ac � � | j |j � }|j � r3|j � |j � D ] }t ||� � |S |j
|j � � |S r, )�joinpathr& rb �mkdir�iterdirro � write_bytesr[ )�target�source�child�items r ro ro � sk � � �O�O�F�K�K� (�E�
�}�}��
� � �
��N�N�$� )�D� �E�4� (� )� �L� ���&�+�+�-�.� �Lr r, )� ),rQ rT rO r r` r- r1 rD r rB �typingr r r �abcr r � _adaptersr r. �str�Package�Anchorr r r" �singledispatchr �registerr3 r6 r �contextmanager�removerY r^ �boolrc rf rU rn rl re ro rh r r �<module>r� s �� � � � � � � � � � � (� (� ,� �
�� � �#�%�
&�� ���< �)�(�6�"� )�k� )� �)�
��!1�!1�
�h�~�6N�
� ���(�(�6�"� (�u�'7�'7� (� �(� ���)�C� )�E�$�$� )� �)� ���:�D� :�U�%�%� :� �:� �"�%�*�*� � ��� �� �y�y�
� ��48�
�+�
�$�
� ���J� �J� ���'�,�,� � ���� � �� ���#�H�/�/� #� �#� ���.� �.�r |