�
`�*j
� � � d Z ddlZddlZddlZddlmZ ddlmZmZ G d� dej � Z G d� d e� Z
G d
� d e� Z G d � d
ee � Z y)z+
Interface adapters for low-level readers.
� N)�BinaryIO� )� Traversable�TraversableResourcesc �� � e Zd ZdZeej defd�� � Zej de d fd�� Z
ej de e fd�� Z ej dede fd�� Z
ed� � Zy )
� SimpleReaderzQ
The minimum, low-level interface required from a resource
provider.
�returnc � � y)zP
The name of the package for which this reader loads resources.
N� ��selfs �I/opt/hc_python/lib/python3.12/site-packages/importlib_resources/simple.py�packagezSimpleReader.package � � � c � � y)zo
Obtain an iterable of SimpleReader for available
child containers (e.g. directories).
Nr r s r �childrenzSimpleReader.children r r c � � y)zL
Obtain available named resources for this virtual package.
Nr r s r � resourceszSimpleReader.resources! r r �resourcec � � y)z:
Obtain a File-like for a named resource.
Nr )r
r s r � open_binaryzSimpleReader.open_binary' r r c �> � | j j d� d S )N�.���)r �splitr s r �namezSimpleReader.name- s � ��|�|�!�!�#�&�r�*�*r N)�__name__�
__module__� __qualname__�__doc__�property�abc�abstractmethod�strr �listr r r r r r r r r r
s� � ��
���� �� � � � �
��� �$�~�.� � � � ��� �4��9� � � �
��� �C� �H� � � �
�+� �+r r c �4 � e Zd ZdZdefd�Zd� Zd� Zd� Zd� Z y) �ResourceContainerzI
Traversable container for a package's resources via its reader.
�readerc � � || _ y �N)r) )r
r) s r �__init__zResourceContainer.__init__7 s � � �� r c � � y�NTr r s r �is_dirzResourceContainer.is_dir: � � �r c � � y�NFr r s r �is_filezResourceContainer.is_file= � � �r c � � � � fd�� j j D � }t t � j j � � }t j ||� S )Nc 3 �6 �K � | ] }t �|� �� � y �wr+ )�ResourceHandle)�.0r r
s �r � <genexpr>z,ResourceContainer.iterdir.<locals>.<genexpr>A s �� �� �N�8M�� ��d�+�8M�s �)r) r �mapr( r � itertools�chain)r
�files�dirss ` r �iterdirzResourceContainer.iterdir@ sB �� �N�� � �8M�8M�N���$�d�k�k�&:�&:�&<�=�����u�d�+�+r c � � t � �r+ )�IsADirectoryError)r
�args�kwargss r �openzResourceContainer.openE s � � �!�!r N)
r r r r! r r, r/ r3 r? rD r r r r( r( 2 s' � �� �|� ���,�
"r r( c �: � e Zd ZdZdedefd�Zd� Zd� Zd
d�Z d� Z
y ) r7 z9
Handle to a named resource in a ResourceReader.
�parentr c � � || _ || _ y r+ )rF r )r
rF r s r r, zResourceHandle.__init__N s � � �� ��� r c � � yr. r r s r r3 zResourceHandle.is_fileR r0 r c � � yr2 r r s r r/ zResourceHandle.is_dirU r4 r c � � | j j j | j � }d|vrt j
|g|��i |��}|S )N�b)rF r) r r �io�
TextIOWrapper)r
�moderB rC �streams r rD zResourceHandle.openX sF � ����#�#�/�/�� � �:�� �d�?��%�%�f�>�t�>�v�>�F��
r c � � t d� �)Nz Cannot traverse into a resource)� RuntimeError)r
r s r �joinpathzResourceHandle.joinpath^ s � ��<�=�=r N)�r) r r r r! r( r% r, r3 r/ rD rR r r r r7 r7 I s/ � ��� 0� �� ���� >r r7 c � � e Zd ZdZd� Zy)�TraversableReaderz�
A TraversableResources based on SimpleReader. Resource providers
may derive from this class to provide the TraversableResources
interface by supplying the SimpleReader interface.
c � � t | � S r+ )r( r s r r= zTraversableReader.filesi s
� � ��&�&r N)r r r r! r= r r r rU rU b s � �� 'r rU )
r! r# rL r; �typingr r r �ABCr r( r7 rU r r r �<module>rY sS ��� � � � � 2�"+�3�7�7� "+�J"� � "�.>�[� >�2'�,�l� 'r