o
    Gôj›  ã                   @   sÂ   d dl Z d dlZd dlZd dlZd dlmZmZ d dlmZm	Z	m
Z
mZmZmZmZmZmZmZ eeje B Zg d¢ZG dd„ de jd�ZG dd	„ d	eƒZeG d
d„ deƒƒZG dd„ deƒZdS )é    N)ÚIterableÚIterator)
ÚAnyÚBinaryIOÚLiteralÚNoReturnÚOptionalÚProtocolÚTextÚTextIOÚoverloadÚruntime_checkable)ÚResourceReaderÚTraversableÚTraversableResourcesc                   @   sp   e Zd ZdZejdedefdd„ƒZejdedefdd„ƒZ	ejdede
fd	d
„ƒZejdee fdd„ƒZdS )r   zDAbstract base class for loaders to provide resource reading support.ÚresourceÚreturnc                 C   ó   t ‚)zÑReturn an opened, file-like object for binary reading.

        The 'resource' argument is expected to represent only a file name.
        If the resource cannot be found, FileNotFoundError is raised.
        ©ÚFileNotFoundError©Úselfr   © r   úh/var/www/html/academy/tools/voices/clone/sv-venv/lib/python3.10/site-packages/importlib_resources/abc.pyÚopen_resource   s   
zResourceReader.open_resourcec                 C   r   )zçReturn the file system path to the specified resource.

        The 'resource' argument is expected to represent only a file name.
        If the resource does not exist on the file system, raise
        FileNotFoundError.
        r   r   r   r   r   Úresource_path'   s   zResourceReader.resource_pathÚpathc                 C   r   )zjReturn True if the named 'path' is a resource.

        Files are resources, directories are not.
        r   ©r   r   r   r   r   Úis_resource4   s   zResourceReader.is_resourcec                 C   r   )z+Return an iterable of entries in `package`.r   ©r   r   r   r   Úcontents<   s   zResourceReader.contentsN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__ÚabcÚabstractmethodr
   r   r   r   Úboolr   r   Ústrr    r   r   r   r   r      s    r   )Ú	metaclassc                   @   s   e Zd ZdS )ÚTraversalErrorN)r!   r"   r#   r   r   r   r   r*   B   s    r*   c                   @   s(  e Zd ZdZejded  fdd„ƒZdefdd„Z		d!de
e d	e
e defd
d„Zejdefdd„ƒZejdefdd„ƒZdedd fdd„Zdedd fdd„Zed"ded dededefdd„ƒZeded dededefdd„ƒZejd"dedededeeB fdd„ƒZeejdefdd „ƒƒZdS )#r   zÔ
    An object with a subset of pathlib.Path methods suitable for
    traversing directories and opening files.

    Any exceptions that occur when accessing the backing resource
    may propagate unaltered.
    r   c                 C   ó   dS )z3
        Yield Traversable objects in self
        Nr   r   r   r   r   ÚiterdirP   ó    zTraversable.iterdirc                 C   s6   |   d¡�}| ¡ W  d  ƒ S 1 sw   Y  dS )z0
        Read contents of self as bytes
        ÚrbN©ÚopenÚread)r   Ústrmr   r   r   Ú
read_bytesV   s   $ÿzTraversable.read_bytesNÚencodingÚerrorsc                 C   s:   | j ||d��}| ¡ W  d  ƒ S 1 sw   Y  dS )z/
        Read contents of self as text
        )r4   r5   Nr/   )r   r4   r5   r2   r   r   r   Ú	read_text]   s   $ÿzTraversable.read_textc                 C   r+   )z4
        Return True if self is a directory
        Nr   r   r   r   r   Úis_dirf   r-   zTraversable.is_dirc                 C   r+   )z/
        Return True if self is a file
        Nr   r   r   r   r   Úis_filel   r-   zTraversable.is_fileÚdescendantsc                    sz   |s| S t j dd„ ttj|ƒD ƒ¡}t|ƒ‰ ‡ fdd„|  ¡ D ƒ}zt|ƒ}W n ty7   t	dˆ t
|ƒƒ‚w |j|Ž S )zë
        Return Traversable resolved with any descendants applied.

        Each descendant should be a path segment relative to self
        and each may contain multiple levels separated by
        ``posixpath.sep`` (``/``).
        c                 s   ó   � | ]}|j V  qd S ©N)Úparts)Ú.0r   r   r   r   Ú	<genexpr>|   s   € 
ÿz'Traversable.joinpath.<locals>.<genexpr>c                 3   s   � | ]
}|j ˆ kr|V  qd S r;   ©Úname)r=   Ztraversable©Útargetr   r   r>   €   s   € ÿz"Target not found during traversal.)Ú	itertoolsÚchainÚfrom_iterableÚmapÚpathlibÚPurePosixPathÚnextr,   ÚStopIterationr*   ÚlistÚjoinpath)r   r9   ÚnamesÚmatchesÚmatchr   rA   r   rL   r   s"   
ÿ
ÿ
ÿÿ
zTraversable.joinpathÚchildc                 C   s
   |   |¡S )z2
        Return Traversable child in self
        )rL   )r   rP   r   r   r   Ú__truediv__‹   s   
zTraversable.__truediv__ÚrÚmodeÚargsÚkwargsc                 O   ó   d S r;   r   ©r   rS   rT   rU   r   r   r   r0   ‘   ó   zTraversable.openr.   c                 O   rV   r;   r   rW   r   r   r   r0   ”   rX   c                 O   r+   )zý
        mode may be 'r' or 'rb' to open as text or binary. Return a handle
        suitable for reading (same as pathlib.Path.open).

        When opening as text, accepts encoding parameters such as those
        accepted by io.TextIOWrapper.
        Nr   rW   r   r   r   r0   —   r-   c                 C   r+   )zM
        The base name of this object without any parent references.
        Nr   r   r   r   r   r@   ¡   r-   zTraversable.name)NN)rR   )r!   r"   r#   r$   r%   r&   r   r,   Úbytesr3   r   r(   r6   r'   r7   r8   ÚStrPathrL   rQ   r   r   r   r   r0   r   Úpropertyr@   r   r   r   r   r   F   s8    ÿÿÿ
þ	" "	r   c                   @   sh   e Zd ZdZejddd„ƒZdedefdd„Z	de
defd	d
„Zdedefdd„Zdee fdd„ZdS )r   zI
    The required interface for providing traversable
    resources.
    r   r   c                 C   r+   )z3Return a Traversable object for the loaded package.Nr   r   r   r   r   Úfiles¯   r-   zTraversableResources.filesr   c                 C   s   |   ¡  |¡ d¡S )Nr.   )r\   rL   r0   r   r   r   r   r   ³   s   z"TraversableResources.open_resourcec                 C   s   t |ƒ‚r;   r   r   r   r   r   r   ¶   s   z"TraversableResources.resource_pathr   c                 C   s   |   ¡  |¡ ¡ S r;   )r\   rL   r8   r   r   r   r   r   ¹   s   z TraversableResources.is_resourcec                 C   s   dd„ |   ¡  ¡ D ƒS )Nc                 s   r:   r;   r?   )r=   Úitemr   r   r   r>   ½   s   € z0TraversableResources.contents.<locals>.<genexpr>)r\   r,   r   r   r   r   r    ¼   s   zTraversableResources.contentsN)r   r   )r!   r"   r#   r$   r%   r&   r\   rZ   r   r   r   r   r   r'   r   r   r(   r    r   r   r   r   r   ©   s    r   )r%   rC   ÚosrG   Úcollections.abcr   r   Útypingr   r   r   r   r   r	   r
   r   r   r   r(   ÚPathLikerZ   Ú__all__ÚABCMetar   Ú	Exceptionr*   r   r   r   r   r   r   Ú<module>   s    0*b