�
_��g� � �& � d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl
m Z m Z m
Z
ddlmZmZ e ej" ef ZeZd� Zed de e defd�� Zd ej" de e fd
�Zej0 d e e dej" fd �� Zej4 d edej" fd
�� Zej4 d ddej" fd�� Zd� Z d ej" fd�Z e j< d ej> d�d�� Z d� Z!dede"fd�Z#ej0 d� � Z$e$j5 ejJ � e j< d� � � Ze j< dejL fd�� Z'e j< d� � Z(d� Z)y) � N)�Optional�Union�cast� )�ResourceReader� Traversablec �` � �� t � �t j � � ��f� �fd� � }|S )a1
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
Remove this compatibility in Python 3.14.
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 ���J/opt/hc_python/lib/python3.12/site-packages/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 �_r1 P s � � � "� "�4� (�(r c �B � t t � j d � S )N�__name__)r �
_infer_caller� f_globalsr- s r r1 r1 U s � � �=�?�,�,�Z�8� 9�9r c � �� �fd�} 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 �d j k( S )Nr )�filename)�
frame_info�stacks �r � is_this_filez#_infer_caller.<locals>.is_this_file_ s �� ��"�"�e�A�h�&7�&7�7�7r c � � | j dk( S )Nr )�function)r9 s r �
is_wrapperz!_infer_caller.<locals>.is_wrapperb s � ��"�"�i�/�/r )�inspectr: � itertools� filterfalse�next�frame)r; r> �
not_this_file�callersr: s @r r4 r4 Z sN �� �
8�0�
�M�M�O�E� �)�)�,��>�M��#�#�J�
�>�G� ��=� � � r c � � ddl m} || � }|j j |j � }|j � S )z=
Return a Traversable object for the given package.
r )� wrap_spec)�future.adaptersrG r$ r! r% r )r rG r& r' s r r r l s5 � � +� �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' rL rI �fd�raw_paths r � _tempfilerW y 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 rK )rW �
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�suppressrT �is_dirrZ s r �_is_present_dirra � s+ � �
� � � .� /��{�{�}�
0� /� /� �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.
)ra � _temp_dirr\ rZ s r �as_filerd � s � � .�d� 3�9�T�?�I��D�9I�Ir c # � K � | �� y�w)z7
Degenerate behavior for pathlib.Path objects.
N� rZ s r r1 r1 � s
� �� � �J�s ��dirc # �h K � | 5 }t j |� �� ddd� y# 1 sw Y yxY w�w)zF
Wrap tempfile.TemporaryDirectory to return a pathlib object.
N)rR rS )rg �results r �
_temp_pathrj � s% � �� �
���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)r` rj rM �TemporaryDirectory�_write_contents)r[ �temp_dirs r rc rc � sA � �� � �;�;�=��=� �H�/�/�1� 2�h� �h��-�-�
3� 2� 2�s �0A�A
� A�
A�Ac � � | j |j � }|j � r3|j � |j � D ] }t ||� � |S |j
|j � � |S r* )�joinpathr% r` �mkdir�iterdirrm � write_bytesrY )�target�source�child�items r rm rm � sf � � �O�O�F�K�K� (�E�
�}�}��
� � �
��N�N�$�D� �E�4� (� %� �L� ���&�+�+�-�.� �Lr r* )� )*r^ r r/ r? r@ rO rR rM r+ r
�typingr r r �abcr r r, �str�Package�Anchorr r r! �singledispatchr �registerr1 r4 r �contextmanager�removerW r\ �boolra rd rS rl rj rc rm rf 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