֦iS d dl Z d dlZd dlZd dlZd dlZd dlmZmZmZm Z m
Z
m Z m Z d dlm
Z
mZ d dlmZ eeej" e f Zg dZ G d de j( Z G d d
e Ze
G d d e Z G d
de Zy) N)AnyBinaryIOIterableIteratorNoReturnTextOptional)runtime_checkableProtocol)Union)ResourceReader TraversableTraversableResourcesc e Zd ZdZej
dedefd Zej
dedefd Z ej
dede
fd Z ej
de e
fd Zy )
r
zDAbstract base class for loaders to provide resource reading support.resourcereturnc t )zReturn 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.
FileNotFoundErrorselfr s 0/usr/lib64/python3.12/importlib/resources/abc.py
open_resourcez ResourceReader.open_resource s
c t )zReturn 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 s r
resource_pathz ResourceReader.resource_path s
r pathc t )zjReturn True if the named 'path' is a resource.
Files are resources, directories are not.
r r r s r is_resourcezResourceReader.is_resource, s
r c t )z+Return an iterable of entries in `package`.r r s r contentszResourceReader.contents4 s
r N)__name__
__module__ __qualname____doc__abcabstractmethodr r r r boolr r strr# r r r
r
s N d x
d
t
(3- r r
) metaclassc e Zd Zy)TraversalErrorN)r$ r% r& r, r r r/ r/ : s r r/ c 2 e Zd ZdZej
ded fd ZdefdZ dde
e de fdZ ej
de
fd Zej
de
fd Zd
edd fd Zd edd fd
Zej
dd Zeej
de fd Zy)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 y)z3
Yield Traversable objects in self
Nr, r" s r iterdirzTraversable.iterdirH r c p | j d 5 }|j cddd S # 1 sw Y yxY w)z0
Read contents of self as bytes
rbNopenread)r strms r
read_byteszTraversable.read_bytesN s$ YYt_99; __s ,5Nencodingc r | j | 5 }|j cddd S # 1 sw Y yxY w)z/
Read contents of self as text
)r; Nr6 )r r; r9 s r read_textzTraversable.read_textU s) YYY
)T99; *
)
)s -6c y)z4
Return True if self is a directory
Nr, r" s r is_dirzTraversable.is_dir\ r3 r c y)z/
Return True if self is a file
Nr, r" s r is_filezTraversable.is_fileb r3 r descendantsc L |s| S t j j d t t j
| D }t
| fd| j D } t
| } |j | S # t $ r t dt | w xY w)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 3 4 K | ] }|j y wN)parts).0r s r z'Traversable.joinpath..r s .
#J4DJJ#J c 3 B K | ] }|j k( s| y wrE name)rG traversabletargets r rH z'Traversable.joinpath..v s#
+9K[=M=MQW=WK>s z"Target not found during traversal.) itertoolschain
from_iterablemappathlib
PurePosixPathnextr2
StopIterationr/ listjoinpath)r rB namesmatchesmatchrN s @r rX zTraversable.joinpathh s K-- .
#&w'<'
ME
u~~u%% 4fd5k
s ) B B#childc $ | j | S )z2
Return Traversable child in self
)rX )r r\ s r __truediv__zTraversable.__truediv__ s }}U##r c y)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, )r modeargskwargss r r7 zTraversable.open r3 r c y)zM
The base name of this object without any parent references.
Nr, r" s r rL zTraversable.name r3 r rE )r)r$ r% r& r' r( r) r r2 bytesr: r r+ r= r* r? rA StrPathrX r^ r7 propertyrL r, r r r r > s -0
E (3- 3
&W & &2$ $] $ c r r c e Zd ZdZej
d d Zdedej fdZ
de de fdZ
dedefdZdee fd Zy
) r zI
The required interface for providing traversable
resources.
r c y)z3Return a Traversable object for the loaded package.Nr, r" s r fileszTraversableResources.files r3 r r c ^ | j j | j d S )Nr5 )rj rX r7 r s r r z"TraversableResources.open_resource s$ zz|$$X.33D99r c t | rE r r s r r z"TraversableResources.resource_path s
))r r c \ | j j | j S rE )rj rX rA r s r r z TraversableResources.is_resource s" zz|$$T*2244r c L d | j j D S )Nc 3 4 K | ] }|j y wrE rK )rG items r rH z0TraversableResources.contents.. s =&(3- >r r )r( rq rO osrS typingr r r r r r r r
r r r+ PathLikerf __all__ABCMetar
Exceptionr/ r r r, r r ry s
N N N . R[[%%
&
C' s{{ ' T Y W ( W W t>> >r