_bootstrap_external.pyc
1 o 2 5�Hc� � @ s� d Z daddlZddlZddlZddlZddlZejdkZer(ddl Z 3 ddl Z nddl Z 4 er3ddgZ ndgZ edd� e D ��sAJ �e d Zee �Zd�e �Z d d 5 � e D �Zd Zd Zee Zd d� Ze� Zdd� Zdd� Zdd� Zerwdd� Z ndd� Z dd� Z dd� Z d d � Z d d � Z d d!� Z!er�d"d#� Z"nd$d#� Z"dpd&d'�Z#e$e#j%�Z&d(�'d)d*�d+ Z(e)�*e(d*�Z+d,Z,d-Z-d.gZ.er�e.�/d/� e�0� Z1d0gZ2e2 Z3Z4dqdd1�d2d3�Z5d4d5� Z6d6d7� Z7d8d9� Z8d:d;� Z9d<d=� Z:d>d?� Z;d@dA� Z<dBdC� Z=dDdE� Z>drdFdG�Z?dsdHdI�Z@dtdKdL�ZAdMdN� ZBeC� ZDdqdeDdO�dPdQ�ZEG dRdS� dS�ZFG dTdU� dU�ZGG dVdW� dWeG�ZHG dXdY� dY�ZIG dZd[� d[eIeH�ZJG d\d]� d]eIeG�ZKG d^d_� d_eIeG�ZLG d`da� da�ZMG dbdc� dc�ZNG ddde� de�ZOG dfdg� dg�ZPdqdhdi�ZQdjdk� ZRdldm� ZSdndo� ZTdS )ua^ Core implementation of path-based import. 6 7 This module is NOT meant to be directly imported! It has been designed such 8 that it can be bootstrapped into Python as the implementation of import. As 9 such it requires the injection of specific modules and attributes in order to 10 work. One should use importlib as the public-facing version of this module. 11 12 N� �win32�\�/c c s � | ] }t |�d kV qdS )� N)�len)�.0�sep� r ��C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.10_3.10.2800.0_x64__qbz5n2kfra8p0\lib\importlib\_bootstrap_external.py� <genexpr>. s � r � c C s h | ]}d |� ��qS )�:r )r �sr r r 13 � <setcomp>2 s r )�win)�cygwin�darwinc s> t j�t�rt j�t�rd� nd� � fdd�} | S dd� } | S )N� PYTHONCASEOKs PYTHONCASEOKc s t jj o � tjv S )z^True if filenames must be checked case-insensitively and ignore environment flags are not set.)�sys�flags�ignore_environment�_os�environr ��keyr r 14 � _relax_caseC � z%_make_relax_case.<locals>._relax_casec S � dS )z5True if filenames must be checked case-insensitively.Fr r r r r 15 r G � )r �platform� 16 startswith�_CASE_INSENSITIVE_PLATFORMS�#_CASE_INSENSITIVE_PLATFORMS_STR_KEY)r r r r 17 �_make_relax_case< s �r# c C s t | �d@ �dd�S )z*Convert a 32-bit integer to little-endian.� �� � �little)�int�to_bytes)�xr r r 18 � _pack_uint32O r r* c C � t | �dksJ �t�| d�S )z/Convert 4 bytes in little-endian to an integer.r% r& �r r' � 19 from_bytes��datar r r 20 �_unpack_uint32T � r0 c C r+ )z/Convert 2 bytes in little-endian to an integer.� r& r, r. r r r 21 �_unpack_uint16Y r1 r3 c G s� | sdS t | �dkr| d S d}g }ttj| �D ]=\}}|�t�s&|�t�r3|�t�p,|}t | g}q|�d�rL|� 22 � |� 23 � krF|}|g}q|� |� q|pO|}|� |� qdd� |D �}t |�dkrk|d sk|t S |t � |� S )� Replacement for os.path.join().r r r r c S � g | ] }|r|� t��qS r ��rstrip�path_separators�r �pr r r 24 � 25 <listcomp>w s � _path_join.<locals>.<listcomp>) r �mapr �_path_splitrootr �path_sep_tuple�endswithr7 r8 �path_sep�casefold�append�join)� 26 path_parts�root�path�new_root�tailr r r 27 � 28 _path_join` s* 29 rJ c G s t �dd� | D ��S )r4 c S r5 r r6 )r �partr r r 30 r; � s �r< )rA rD )rE r r r 31 rJ ~ s 32 �c sB t � fdd�tD ��}|dk rd� fS � d|� � |d d� fS )z Replacement for os.path.split().c 3 s � | ]}� � |�V qd S �N)�rfindr9 �rG r r 33 r � s � z _path_split.<locals>.<genexpr>r r Nr )�maxr8 )rG �ir rN r 34 � _path_split� s rQ c C s 35 t �| �S )z~Stat the path. 36 37 Made a separate function to make it easier to override in experiments 38 (e.g. cache stat results). 39 40 )r �statrN r r r 41 � 42 _path_stat� s 43 rS c C s0 zt | �}W n 44 ty Y dS w |jd@ |kS )z1Test whether the path is the specified mode type.Fi � )rS �OSError�st_mode)rG �mode� stat_infor r r 45 �_path_is_mode_type� s �rX c C s 46 t | d�S )z Replacement for os.path.isfile.i � )rX rN r r r 47 � _path_isfile� � 48 rY c C s | st �� } t| d�S )z Replacement for os.path.isdir.i @ )r �getcwdrX rN r r r 49 � _path_isdir� s 50 r\ c C s> | sdS t �| �d �dd�}t|�dko |�d�p |�d�S )� Replacement for os.path.isabs.Fr r r r z\\)r r> �replacer r r@ )rG rF r r r 51 � _path_isabs� s r_ c C s 52 | � t�S )r] )r r8 rN r r r 53 r_ � rZ � c C s� d� | t| ��}t�|tjtjB tjB |d@ �}z$t�|d�� }|� |� W d � n1 s/w Y t� 54 || � W dS t yT zt� |� W � t yS Y � w w )z�Best-effort function to write data to a path atomically. 55 Be prepared to handle a FileExistsError if concurrent writing of the 56 temporary file is attempted.�{}.{}r` �wbN) �format�idr �open�O_EXCL�O_CREAT�O_WRONLY�_io�FileIO�writer^ rT �unlink)rG r/ rV �path_tmp�fd�filer r r 57 � _write_atomic� s$ � � ���rp io r2 r& s 58 � __pycache__zopt-z.pyz.pywz.pyc)� optimizationc C sP |durt �dt� |durd}t|��|rdnd}t�| �} t| �\}}|�d�\}}}tj j 59 } | du r9t d��d� |r?|n||| g�} 60 |du rVtj jdkrRd}ntj j}t|�}|dkrp|�� sitd �|���d 61 �| 62 t|�} 63 | 64 td } tjdur�t|�s�tt�� |�}|d d kr�|d tvr�|d d� }ttj|�t�| �S t|t| �S ) a� Given the path to a .py file, return the path to its .pyc file. 65 66 The .py file does not need to exist; this simply returns the path to the 67 .pyc file calculated as if the .py file were imported. 68 69 The 'optimization' parameter controls the presumed optimization level of 70 the bytecode file. If 'optimization' is not None, the string representation 71 of the argument is taken and verified to be alphanumeric (else ValueError 72 is raised). 73 74 The debug_override parameter is deprecated. If debug_override is not None, 75 a True value is the same as setting 'optimization' to the empty string 76 while a False value is equivalent to setting 'optimization' to '1'. 77 78 If sys.implementation.cache_tag is None then NotImplementedError is raised. 79 80 NzFthe debug_override parameter is deprecated; use 'optimization' insteadz2debug_override or optimization must be set to Noner r �.�$sys.implementation.cache_tag is Noner z{!r} is not alphanumericz{}.{}{}r r2 ) � _warnings�warn�DeprecationWarning� TypeErrorr �fspathrQ � 81 rpartitionr �implementation� cache_tag�NotImplementedErrorrD r �optimize�str�isalnum� 82 ValueErrorrc �_OPT�BYTECODE_SUFFIXES�pycache_prefixr_ rJ r[ r8 �lstrip�_PYCACHE) rG �debug_overriderr �message�headrI �baser �rest�tag�almost_filename�filenamer r r 83 �cache_from_source| sH � 84 85 � r� c 86 C s( t jjdu r 87 td��t�| �} t| �\}}d}t jdur3t j�t �}|� 88 |t �r3|t |�d� }d}|sHt|�\}}|t krHtt � d| ����|�d�}|dvrXtd|����|d kr�|�dd 89 �d }|� 90 t�sptd t����|t t�d� }|�� s�td |�d���|�d�d } t|| td �S )an Given the path to a .pyc. file, return the path to its .py file. 91 92 The .pyc file does not need to exist; this simply returns the path to 93 the .py file calculated to correspond to the .pyc file. If path does 94 not conform to PEP 3147/488 format, ValueError will be raised. If 95 sys.implementation.cache_tag is None then NotImplementedError is raised. 96 97 Nrt FTz not bottom-level directory in rs > r2 � z expected only 2 or 3 dots in r� r2 �����z5optimization portion of filename does not start with zoptimization level z is not an alphanumeric valuer )r r{ r| r} r ry rQ r� r7 r8 r rA r r� r� �count�rsplitr� r� � partitionrJ �SOURCE_SUFFIXES) 98 rG r� �pycache_filename�found_in_pycache_prefix� stripped_path�pycache� dot_countrr � opt_level� base_filenamer r r 99 �source_from_cache� s< 100 101 � 102 103 �r� c C s| t | �dkrdS | �d�\}}}|r |�� dd� dkr | S zt| �}W n ttfy5 | dd� }Y nw t|�r<|S | S )z�Convert a bytecode file path to a source path (if possible). 104 105 This function exists purely for backwards-compatibility for 106 PyImport_ExecCodeModuleWithFilenames() in the C API. 107 108 r Nrs �����������py)r rz �lowerr� r} r� rY )� bytecode_pathr� �_� extension� source_pathr r r 109 �_get_sourcefile� s �r� c C sD | � tt��rzt| �W S ty Y d S w | � tt��r | S d S rL )r@ �tupler� r� r} r� )r� r r r 110 � _get_cached� s 111 �r� c C s2 zt | �j}W n ty d}Y nw |dO }|S )z3Calculate the mode permissions for a bytecode file.r` � )rS rU rT )rG rV r r r 112 � 113 _calc_mode 114 s �r� c s4 d� fdd� }t durt j}ndd� }||� � |S )z�Decorator to verify that the module being requested matches the one the 115 loader can handle. 116 117 The first argument (self) must define _name which the second argument is 118 compared against. If the comparison fails then ImportError is raised. 119 120 Nc sH |d u r| j }n| j |krtd| j |f |d��� | |g|�R i |��S )Nz loader for %s cannot handle %s��name)r� � ImportError)�selfr� �args�kwargs��methodr r 121 �_check_name_wrapper s 122 ��z(_check_name.<locals>._check_name_wrapperc S s8 dD ]}t ||�rt| |t||�� q| j�|j� d S )N)� 123 __module__�__name__� __qualname__�__doc__)�hasattr�setattr�getattr�__dict__�update)�new�oldr^ r r r 124 �_wrap+ s 125 126 �z_check_name.<locals>._wraprL )� 127 _bootstrapr� )r� r� r� r r� r 128 � _check_name s 129 130 r� c C sH t �dt� | �|�\}}|du r"t|�r"d}t �|�|d �t� |S )z�Try to find a loader for the specified module by delegating to 131 self.find_loader(). 132 133 This method is deprecated in favor of finder.find_spec(). 134 135 zZfind_module() is deprecated and slated for removal in Python 3.12; use find_spec() insteadNz,Not importing directory {}: missing __init__r )ru rv rw � find_loaderr rc � ImportWarning)r� �fullname�loader�portions�msgr r r 136 �_find_module_shim5 s �r� c C s� | dd� }|t kr d|�d|��}t�d|� t|fi |���t| �dk r5d|��}t�d|� t|��t| dd� �}|d @ rQd 137 |�d |��}t|fi |���|S ) aT Perform basic validity checking of a pyc header and return the flags field, 138 which determines how the pyc should be further validated against the source. 139 140 *data* is the contents of the pyc file. (Only the first 16 bytes are 141 required, though.) 142 143 *name* is the name of the module being imported. It is used for logging. 144 145 *exc_details* is a dictionary passed to ImportError if it raised for 146 improved debugging. 147 148 ImportError is raised when the magic number is incorrect or when the flags 149 field is invalid. EOFError is raised when the data is found to be truncated. 150 151 Nr% zbad magic number in z: �{}� z(reached EOF while reading pyc header of � �����zinvalid flags z in )� MAGIC_NUMBERr� �_verbose_messager� r �EOFErrorr0 )r/ r� � exc_details�magicr� r r r r 152 � _classify_pycI s 153 r� c C s| t | dd� �|d@ kr d|��}t�d|� t|fi |���|dur:t | dd� �|d@ kr<td|��fi |���dS dS )a Validate a pyc against the source last-modified time. 154 155 *data* is the contents of the pyc file. (Only the first 16 bytes are 156 required.) 157 158 *source_mtime* is the last modified timestamp of the source file. 159 160 *source_size* is None or the size of the source file in bytes. 161 162 *name* is the name of the module being imported. It is used for logging. 163 164 *exc_details* is a dictionary passed to ImportError if it raised for 165 improved debugging. 166 167 An ImportError is raised if the bytecode is stale. 168 169 r� � r$ zbytecode is stale for r� Nr� )r0 r� r� r� )r/ � source_mtime� source_sizer� r� r� r r r 170 �_validate_timestamp_pycj s 171 �r� c C s* | dd� |krt d|��fi |���dS )a� Validate a hash-based pyc by checking the real source hash against the one in 172 the pyc header. 173 174 *data* is the contents of the pyc file. (Only the first 16 bytes are 175 required.) 176 177 *source_hash* is the importlib.util.source_hash() of the source file. 178 179 *name* is the name of the module being imported. It is used for logging. 180 181 *exc_details* is a dictionary passed to ImportError if it raised for 182 improved debugging. 183 184 An ImportError is raised if the bytecode is stale. 185 186 r� r� z.hash in bytecode doesn't match hash of source N)r� )r/ � source_hashr� r� r r r 187 �_validate_hash_pyc� s ���r� c C sL t �| �}t|t�r t�d|� |durt�||� |S td� |�||d��)z#Compile bytecode as found in a pyc.zcode object from {!r}NzNon-code object in {!r}�r� rG ) 188 �marshal�loads� 189 isinstance� 190 _code_typer� r� �_imp�_fix_co_filenamer� rc )r/ r� r� r� �coder r r 191 �_compile_bytecode� s 192 193 194 �r� c C sF t t�}|�td�� |�t|�� |�t|�� |�t�| �� |S )z+Produce the data for a timestamp-based pyc.r )� bytearrayr� �extendr* r� �dumps)r� �mtimer� r/ r r r 195 �_code_to_timestamp_pyc� s r� Tc C sP t t�}d|d> B }|�t|�� t|�dksJ �|�|� |�t�| �� |S )z&Produce the data for a hash-based pyc.r r� )r� r� r� r* r r� r� )r� r� �checkedr/ r r r r 196 �_code_to_hash_pyc� s 197 r� c C s> ddl }t�| �j}|�|�}t�dd�}|�| �|d ��S )zyDecode bytes representing source code and return the string. 198 199 Universal newline support is used in the decoding. 200 r NT)�tokenizeri �BytesIO�readline�detect_encoding�IncrementalNewlineDecoder�decode)� source_bytesr� �source_bytes_readline�encoding�newline_decoderr r r 201 � decode_source� s 202 203 r� �r� �submodule_search_locationsc C s6 |du r d}t |d�r z|�| �}W n& ty Y n w n t�|�}t|�s9z tt�� |�}W n ty8 Y nw t j 204 | ||d�}d|_ |du rct � D ]\}}|� t|��r`|| |�}||_ nqKdS |tu r�t |d�r�z|�| �}W n ty| Y n 205 w |r�g |_n||_|jg kr�|r�t|�d }|j�|� |S )a= Return a module spec based on a file location. 206 207 To indicate that the module is a package, set 208 submodule_search_locations to a list of directory paths. An 209 empty list is sufficient, though its not otherwise useful to the 210 import system. 211 212 The loader must take a spec as its only __init__() arg. 213 214 Nz <unknown>� get_filename��originT� 215 is_packager )r� r� r� r ry r_ rJ r[ rT r� � 216 ModuleSpec� _set_fileattr�_get_supported_file_loadersr@ r� r� � _POPULATEr� r� rQ rC ) r� �locationr� r� �spec� loader_class�suffixesr� �dirnamer r r 217 �spec_from_file_location� sT 218 �� 219 � 220 � 221 �� 222 r c @ sX e Zd ZdZdZdZeodev Ze dd� �Z 223 e dd� �Z e dd 224 d ��Z e dd d ��Zd S )�WindowsRegistryFinderz>Meta path finder for modules declared in the Windows registry.z;Software\Python\PythonCore\{sys_version}\Modules\{fullname}zASoftware\Python\PythonCore\{sys_version}\Modules\{fullname}\Debugz_d.pydc C s2 zt �t j| �W S ty t �t j| � Y S w rL )�winreg�OpenKey�HKEY_CURRENT_USERrT �HKEY_LOCAL_MACHINEr r r r 225 �_open_registry& s 226 �z$WindowsRegistryFinder._open_registryc C s� | j r| j}n| j}|j|dtjd d� d�}z | �|��}t�|d�}W d � W |S 1 s1w Y W |S t yB Y d S w )Nz%d.%dr2 )r� � sys_versionr ) 227 � DEBUG_BUILD�REGISTRY_KEY_DEBUG� REGISTRY_KEYrc r � version_infor r � 228 QueryValuerT )�clsr� � registry_keyr �hkey�filepathr r r 229 �_search_registry- s � �� ��z&WindowsRegistryFinder._search_registryNc C sx | � |�}|d u r d S zt|� W n 230 ty Y d S w t� D ]\}}|�t|��r9tj||||�|d�}| S q d S )Nr� )r rS rT r� r@ r� r� �spec_from_loader)r r� rG �targetr r� r r� r r r 231 � find_spec< s" 232 ����z WindowsRegistryFinder.find_specc C s* t �dt� | �||�}|dur|jS dS )zjFind module named in the registry. 233 234 This method is deprecated. Use find_spec() instead. 235 236 zpWindowsRegistryFinder.find_module() is deprecated and slated for removal in Python 3.12; use find_spec() insteadN�ru rv rw r r� �r r� rG r� r r r 237 � find_moduleL s � z!WindowsRegistryFinder.find_module�NNrL )r� r� r� r� r r � _MS_WINDOWS�EXTENSION_SUFFIXESr � staticmethodr � classmethodr r r r r r r 238 r s �� 239 240 r c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd 241 S ) � _LoaderBasicszSBase class of common code needed by both SourceLoader and 242 SourcelessFileLoader.c C s@ t | �|��d }|�dd�d }|�d�d }|dko |dkS )z�Concrete implementation of InspectLoader.is_package by checking if 243 the path returned by get_filename has a filename of '__init__.py'.r rs r r2 �__init__)rQ r� r� rz )r� r� r� � filename_base� tail_namer r r 244 r� b s z_LoaderBasics.is_packagec C r �z*Use default semantics for module creation.Nr �r� r� r r r 245 � create_modulej � z_LoaderBasics.create_modulec C s8 | � |j�}|du rtd�|j���t�t||j� dS )zExecute the module.Nz4cannot load module {!r} when get_code() returns None)�get_coder� r� rc r� �_call_with_frames_removed�execr� )r� �moduler� r r r 246 � exec_modulem s �z_LoaderBasics.exec_modulec C s t �| |�S )zThis method is deprecated.)r� �_load_module_shim�r� r� r r r 247 � load_moduleu s z_LoaderBasics.load_moduleN)r� r� r� r� r� r& r, r/ r r r r 248 r ] s r c @ sJ e Zd Zdd� Zdd� Zdd� Zdd� Zd d 249 � Zd d �d d�Zdd� Z dS )� SourceLoaderc C s t �)z�Optional method that returns the modification time (an int) for the 250 specified path (a str). 251 252 Raises OSError when the path cannot be handled. 253 )rT �r� rG r r r 254 � 255 path_mtime} s zSourceLoader.path_mtimec C s d| � |�iS )a� Optional method returning a metadata dict for the specified 256 path (a str). 257 258 Possible keys: 259 - 'mtime' (mandatory) is the numeric timestamp of last source 260 code modification; 261 - 'size' (optional) is the size in bytes of the source code. 262 263 Implementing this method allows the loader to read bytecode files. 264 Raises OSError when the path cannot be handled. 265 r� )r2 r1 r r r 266 � 267 path_stats� s zSourceLoader.path_statsc C s | � ||�S )z�Optional method which writes data (bytes) to a file path (a str). 268 269 Implementing this method allows for the writing of bytecode files. 270 271 The source path is needed in order to correctly transfer permissions 272 )�set_data)r� r� � 273 cache_pathr/ r r r 274 �_cache_bytecode� s z SourceLoader._cache_bytecodec C r )z�Optional method which writes data (bytes) to a file path (a str). 275 276 Implementing this method allows for the writing of bytecode files. 277 Nr )r� rG r/ r r r 278 r4 � r' zSourceLoader.set_datac 279 C sF | � |�}z 280 | �|�}W t|�S ty" } ztd|d�|�d}~ww )z4Concrete implementation of InspectLoader.get_source.z'source not available through get_data()r� N)r� �get_datarT r� r� )r� r� rG r� �excr r r 281 � 282 get_source� s 283 �����zSourceLoader.get_sourcer� )� _optimizec C s t jt||dd|d�S )z�Return the code object compiled from source. 284 285 The 'data' argument can be any object type that compile() supports. 286 r* T)� dont_inheritr~ )r� r) �compile)r� r/ rG r: r r r 287 �source_to_code� s �zSourceLoader.source_to_codec C s | � |�}d}d}d}d}d}zt|�}W n ty d}Y n�w z| �|�} W n ty1 Y nw t| d �}z| �|�} 288 W n tyH Y nhw ||d�} zGt| 289 || �} t| 290 �dd� } | d@ dk}|r�| d @ dk}t j 291 d 292 kr�|swt j 293 d kr�| �|�}t � t |�}t | 294 ||| � n 295 t| 296 || d || � W n ttfy� Y nw t�d ||� t| |||d�S |du r�| �|�}| �||�}t�d|� tjs�|dur�|dur�|r�|du r�t � |�}t|||�} 297 nt||t|��} 298 z 299 | �||| 300 � W |S ty� Y |S w |S )z�Concrete implementation of InspectLoader.get_code. 301 302 Reading of bytecode requires path_stats to be implemented. To write 303 bytecode, set_data must also be implemented. 304 305 NFTr� r� r� r r r2 �never�always�sizez {} matches {})r� r� r� zcode object from {})r� r� r} r3 rT r' r7 r� � 306 memoryviewr� �check_hash_based_pycsr� �_RAW_MAGIC_NUMBERr� r� r� r� r� r� r� r= r �dont_write_bytecoder� r� r r6 )r� r� r� r� r� r� � 307 hash_based� check_sourcer� �str/ r� r � 308 bytes_data� code_objectr r r 309 r( � s� 310 � � �� 311 � 312 313 �������� 314 315 � ��zSourceLoader.get_codeN) 316 r� r� r� r2 r3 r6 r4 r9 r= r( r r r r 317 r0 { s 318 319 r0 c s\ e Zd ZdZdd� Zdd� Zdd� Ze� fdd ��Zed 320 d � �Z d d � Z 321 edd� �Z � Z S )� 322 FileLoaderzgBase file loader class which implements the loader protocol methods that 323 require file system usage.c C s || _ || _dS )zKCache the module name and the path to the file found by the 324 finder.Nr� )r� r� rG r r r 325 r! s 326 zFileLoader.__init__c C � | j |j ko | j|jkS rL �� __class__r� �r� �otherr r r 327 �__eq__ � 328 �zFileLoader.__eq__c C � t | j�t | j�A S rL ��hashr� rG �r� r r r 329 �__hash__ � zFileLoader.__hash__c s t t| ��|�S )zdLoad a module from a file. 330 331 This method is deprecated. Use exec_module() instead. 332 333 )�superrJ r/ r. �rM r r 334 r/ s 335 zFileLoader.load_modulec C � | j S �z:Return the path to the source file as found by the finder.rN r. r r r 336 r� ) � zFileLoader.get_filenamec C s� t | ttf�r$t�t|��� }|�� W d � S 1 s w Y dS t�|d�� }|�� W d � S 1 s9w Y dS )z'Return the data from path as raw bytes.N�r)r� r0 �ExtensionFileLoaderri � open_coder �readrj )r� rG ro r r r 337 r7 . s $�$�zFileLoader.get_datac C s ddl m} || �S )Nr )� 338 FileReader)�importlib.readersra )r� r+ ra r r r 339 �get_resource_reader7 s z FileLoader.get_resource_reader) r� r� r� r� r! rP rV r� r/ r� r7 rc � __classcell__r r rY r 340 rJ s 341 rJ c @ s. e Zd ZdZdd� Zdd� Zdd�dd �Zd 342 S ) �SourceFileLoaderz>Concrete implementation of SourceLoader using the file system.c C s t |�}|j|jd�S )z!Return the metadata for the path.)r� r@ )rS �st_mtime�st_size)r� rG rG r r r 343 r3 A s zSourceFileLoader.path_statsc C s t |�}| j|||d�S )N��_mode)r� r4 )r� r� r� r/ rV r r r 344 r6 F s z SourceFileLoader._cache_bytecoder` rh c C s� t |�\}}g }|r t|�s t |�\}}|�|� |r t|�rt|�D ]1}t||�}zt�|� W q# ty: Y q# tyT } zt � 345 d||� W Y d}~ dS d}~ww zt |||� t � 346 d|� W dS ty~ } zt � 347 d||� W Y d}~dS d}~ww )zWrite bytes data to a file.zcould not create {!r}: {!r}Nz created {!r}) rQ r\ rC �reversedrJ r �mkdir�FileExistsErrorrT r� r� rp ) r� rG r/ ri �parentr� rE rK r8 r r r 348 r4 K s8 349 � 350 ��� ���zSourceFileLoader.set_dataN)r� r� r� r� r3 r6 r4 r r r r 351 re = s 352 re c @ s e Zd ZdZdd� Zdd� ZdS )�SourcelessFileLoaderz-Loader which handles sourceless file imports.c C sD | � |�}| �|�}||d�}t|||� tt|�dd � ||d�S )Nr� r� )r� r� )r� r7 r� r� rA )r� r� rG r/ r� r r r 353 r( n s 354 355 � �z SourcelessFileLoader.get_codec C r )z'Return None as there is no source code.Nr r. r r r 356 r9 ~ r z SourcelessFileLoader.get_sourceN)r� r� r� r� r( r9 r r r r 357 rn j s rn c @ s\ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd 358 d � Zd d � Z dd� Z 359 dd� Z e dd� �Z dS )r^ z]Loader for extension modules. 360 361 The constructor is designed to work with FileFinder. 362 363 c C s || _ || _d S rL r� )r� r� rG r r r 364 r! � s 365 z ExtensionFileLoader.__init__c C rK rL rL rN r r r 366 rP � rQ zExtensionFileLoader.__eq__c C rR rL rS rU r r r 367 rV � rW z ExtensionFileLoader.__hash__c C s$ t �tj|�}t �d|j| j� |S )z&Create an unitialized extension modulez&extension module {!r} loaded from {!r})r� r) r� �create_dynamicr� r� rG )r� r� r+ r r r 368 r& � s ��z!ExtensionFileLoader.create_modulec C s$ t �tj|� t �d| j| j� dS )z Initialize an extension modulez(extension module {!r} executed from {!r}N)r� r) r� � exec_dynamicr� r� rG �r� r+ r r r 369 r, � s �z ExtensionFileLoader.exec_modulec s$ t | j�d � t� fdd�tD ��S )z1Return True if the extension module is a package.r c 3 s � | ] }� d | kV qdS )r! Nr �r �suffix�� file_namer r 370 r � s � �z1ExtensionFileLoader.is_package.<locals>.<genexpr>)rQ rG �anyr r. r rt r 371 r� � s �z ExtensionFileLoader.is_packagec C r )z?Return None as an extension module cannot create a code object.Nr r. r r r 372 r( � r z ExtensionFileLoader.get_codec C r )z5Return None as extension modules have no source code.Nr r. r r r 373 r9 � r z ExtensionFileLoader.get_sourcec C rZ r[ rN r. r r r 374 r� � r\ z ExtensionFileLoader.get_filenameN)r� r� r� r� r! rP rV r& r, r� r( r9 r� r� r r r r 375 r^ � s r^ c @ sl e Zd ZdZdZdd� Zdd� Zdd� Zd d 376 � Zd d � Z d d� Z 377 dd� Z dd� Z dd� Z dd� Zdd� ZdS )�_NamespacePatha& Represents a namespace package's path. It uses the module name 378 to find its parent module, and from there it looks up the parent's 379 __path__. When this changes, the module's own path is recomputed, 380 using path_finder. For top-level modules, the parent module's path 381 is sys.path.r c C s, || _ || _t| �� �| _| j| _|| _d S rL )�_name�_pathr� �_get_parent_path�_last_parent_path�_epoch� _last_epoch� _path_finder�r� r� rG � path_finderr r r 382 r! � s 383 384 z_NamespacePath.__init__c C s& | j �d�\}}}|dkrdS |dfS )z>Returns a tuple of (parent-module-name, parent-path-attr-name)rs r )r rG �__path__)rx rz )r� rm �dot�mer r r 385 �_find_parent_path_names� s z&_NamespacePath._find_parent_path_namesc C s | � � \}}ttj| |�S rL )r� r� r �modules)r� �parent_module_name�path_attr_namer r r 386 rz � s z _NamespacePath._get_parent_pathc C sd t | �� �}|| jks| j| jkr/| �| j|�}|d ur(|jd u r(|jr(|j| _ || _| j| _| j S rL ) 387 r� rz r{ r| r} r~ rx r� r� ry )r� � parent_pathr� r r r 388 � _recalculate� s z_NamespacePath._recalculatec C � t | �� �S rL )�iterr� rU r r r 389 �__iter__� � z_NamespacePath.__iter__c C s | � � | S rL �r� )r� �indexr r r 390 � __getitem__� r� z_NamespacePath.__getitem__c C s || j |< d S rL )ry )r� r� rG r r r 391 � __setitem__� s z_NamespacePath.__setitem__c C r� rL )r r� rU r r r 392 �__len__� r� z_NamespacePath.__len__c C � d� | j�S )Nz_NamespacePath({!r}))rc ry rU r r r 393 �__repr__� r� z_NamespacePath.__repr__c C s || � � v S rL r� �r� �itemr r r 394 � __contains__� r� z_NamespacePath.__contains__c C s | j �|� d S rL )ry rC r� r r r 395 rC � � z_NamespacePath.appendN)r� r� r� r� r| r! r� rz r� r� r� r� r� r� r� rC r r r r 396 rw � s 397 rw c @ sX e Zd Zdd� Zedd� �Zdd� Zdd� Zd d 398 � Zd d � Z d d� Z 399 dd� Z dd� Z dS )�_NamespaceLoaderc C s t |||�| _d S rL )rw ry r r r r 400 r! � s z_NamespaceLoader.__init__c C s t �dt� d�| j�S )zsReturn repr for the module. 401 402 The method is deprecated. The import machinery does the job itself. 403 404 zR_NamespaceLoader.module_repr() is deprecated and slated for removal in Python 3.12z<module {!r} (namespace)>)ru rv rw rc r� )r+ r r r 405 � module_repr s � z _NamespaceLoader.module_reprc C r )NTr r. r r r 406 r� � z_NamespaceLoader.is_packagec C r )Nr r r. r r r 407 r9 r� z_NamespaceLoader.get_sourcec C s t ddddd�S )Nr z<string>r* T)r; )r< r. r r r 408 r( r� z_NamespaceLoader.get_codec C r r$ r r% r r r 409 r& r' z _NamespaceLoader.create_modulec C s d S rL r rq r r r 410 r, r� z _NamespaceLoader.exec_modulec C s t �d| j� t �| |�S )zbLoad a namespace module. 411 412 This method is deprecated. Use exec_module() instead. 413 414 z&namespace module loaded with path {!r})r� r� ry r- r. r r r 415 r/ s � z _NamespaceLoader.load_modulec C s ddl m} || j�S )Nr )�NamespaceReader)rb r� ry )r� r+ r� r r r 416 rc ' s 417 z$_NamespaceLoader.get_resource_readerN) r� r� r� r! r r� r� r9 r( r& r, r/ rc r r r r 418 r� � s 419 420 r� c @ sv e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Z edd d ��Z 421 edd d��Z eddd��Z edd� �Z d 422 S )� 423 PathFinderz>Meta path finder for sys.path and package __path__ attributes.c C sN t tj�� �D ]\} }|du rtj| = qt|d�r |�� qt jd7 _dS )z}Call the invalidate_caches() method on all path entry finders 424 stored in sys.path_importer_caches (where implemented).N�invalidate_cachesr )�listr �path_importer_cache�itemsr� r� rw r| )r� �finderr r r 425 r� 2 s 426 427 �z PathFinder.invalidate_cachesc C sL t jdurt jst�dt� t jD ]}z|| �W S ty# Y qw dS )z.Search sys.path_hooks for a finder for 'path'.Nzsys.path_hooks is empty)r � 428 path_hooksru rv r� r� )rG �hookr r r 429 � _path_hooks? s 430 �zPathFinder._path_hooksc C sd |dkrzt �� }W n 431 ty Y dS w ztj| }W |S ty1 | �|�}|tj|< Y |S w )z�Get the finder for the path entry from sys.path_importer_cache. 432 433 If the path entry is not in the cache, find the appropriate finder 434 and cache it. If no finder is available, store None. 435 436 r N)r r[ �FileNotFoundErrorr r� �KeyErrorr� )r rG r� r r r 437 �_path_importer_cacheL s � � 438 �z PathFinder._path_importer_cachec C s� t |d�rt�|�� d�}t�|t� |�|�\}}nt�|�� d�}t�|t� |�|�}g }|d ur:t�||�S t� |d �}||_ 439 |S )Nr� z5.find_spec() not found; falling back to find_loader()z5.find_spec() not found; falling back to find_module()) r� r� � _object_nameru rv r� r� r r r� r� )r r� r� r� r� r� r� r r r 440 �_legacy_get_specb s 441 442 zPathFinder._legacy_get_specNc C s� g }|D ]C}t |ttf�sq| �|�}|durGt|d�r#|�||�}n| �||�}|du r.q|jdur7| S |j}|du rBt d��|� 443 |� qt � |d�}||_|S )z?Find the loader or namespace_path for this module/package name.Nr zspec missing loader) r� r �bytesr� r� r r� r� r� r� r� r� r� ) r r� rG r �namespace_path�entryr� r� r� r r r 444 � _get_specw s* 445 446 447 448 � zPathFinder._get_specc C s^ |du rt j}| �|||�}|du rdS |jdu r-|j}|r+d|_t||| j�|_|S dS |S )z�Try to find a spec for 'fullname' on sys.path or 'path'. 449 450 The search is based on sys.path_hooks and sys.path_importer_cache. 451 N)r rG r� r� r� r� rw )r r� rG r r� r� r r r 452 r � s 453 zPathFinder.find_specc C s* t �dt� | �||�}|du rdS |jS )z�find the module on sys.path or 'path' based on sys.path_hooks and 454 sys.path_importer_cache. 455 456 This method is deprecated. Use find_spec() instead. 457 458 zePathFinder.find_module() is deprecated and slated for removal in Python 3.12; use find_spec() insteadNr r r r r 459 r � s � zPathFinder.find_modulec O s ddl m} |j| i |��S )a 460 Find distributions. 461 462 Return an iterable of all Distribution instances capable of 463 loading the metadata for packages matching ``context.name`` 464 (or all names if ``None`` indicated) along the paths in the list 465 of directories ``context.path``. 466 r )�MetadataPathFinder)�importlib.metadatar� �find_distributions)r� r� r� r r r 467 r� � s 468 z PathFinder.find_distributionsrL r )r� r� r� r� r r� r� r r� r� r� r r r� r r r r 469 r� . s$ 470 471 472 473 r� c @ sZ e Zd ZdZdd� Zdd� ZeZdd� Zdd � Z dd d �Z 474 d d� Z e dd� �Z dd� Zd 475 S )� 476 FileFinderz�File-based finder. 477 478 Interactions with the file system are cached for performance, being 479 refreshed when the directory the finder is handling has been modified. 480 481 c sp g }|D ]\� }|� � fdd�|D �� q|| _|pd| _t| j�s+tt�� | j�| _d| _t� | _ t� | _ 482 dS )z�Initialize with the path to search on and a variable number of 483 2-tuples containing the loader and the file suffixes the loader 484 recognizes.c 3 s � | ]}|� fV qd S rL r rr �r� r r 485 r � s � z&FileFinder.__init__.<locals>.<genexpr>rs r� N) r� �_loadersrG r_ rJ r r[ � _path_mtime�set� _path_cache�_relaxed_path_cache)r� rG �loader_details�loadersr r r� r 486 r! � s 487 488 zFileFinder.__init__c C s 489 d| _ dS )z Invalidate the directory mtime.r� N)r� rU r r r 490 r� � rZ z FileFinder.invalidate_cachesc C s6 t �dt� | �|�}|du rdg fS |j|jpg fS )z�Try to find a loader for the specified module, or the namespace 491 package portions. Returns (loader, list-of-portions). 492 493 This method is deprecated. Use find_spec() instead. 494 495 zeFileFinder.find_loader() is deprecated and slated for removal in Python 3.12; use find_spec() insteadN)ru rv rw r r� r� )r� r� r� r r r 496 r� � s � 497 zFileFinder.find_loaderc C s |||�}t ||||d�S )Nr� )r )r� r r� rG �smslr r� r r r 498 r� � s 499 �zFileFinder._get_specNc C sz d}|� d�d }z t| jpt�� �j}W n ty d}Y nw || jkr-| �� || _t � r8| j 500 }|� � }n| j }|}||v rlt | j|�}| jD ] \} } 501 d| } t || �} t| �rg| �| 502 || |g|� S qJt|�}| jD ]7\} } 503 z 504 t | j|| �} W n ty� Y dS w tjd| dd� || |v r�t| �r�| �| 505 || d|� S qo|r�t�d |� t�|d�} |g| _| S dS ) 506 zoTry to find a spec for the specified module. 507 508 Returns the matching spec, or None if not found. 509 Frs r2 r� r! Nz trying {})� verbosityzpossible namespace for {})rz rS rG r r[ rf rT r� � _fill_cacher r� r� r� rJ r� rY r� r\ r� r� r� r� r� )r� r� r � is_namespace� tail_moduler� �cache� cache_module� base_pathrs r � init_filename� full_pathr� r r r 510 r sV � 511 512 513 � � 514 �� zFileFinder.find_specc 515 C s� | j }z t�|p t�� �}W n tttfy g }Y nw tj� d�s)t 516 |�| _ n%t 517 � }|D ] }|� d�\}}}|rCd� ||�� �}n|}|�|� q.|| _ tj� t�r^dd� |D �| _dS dS )zDFill the cache of potential modules and packages for this directory.r rs ra c S s h | ]}|� � �qS r )r� )r �fnr r r 518 r P s z)FileFinder._fill_cache.<locals>.<setcomp>N)rG r �listdirr[ r� �PermissionError�NotADirectoryErrorr r r r� r� r� rc r� �addr! r� ) r� rG �contents�lower_suffix_contentsr� r� r� rs �new_namer r r 519 r� 3 s& � �zFileFinder._fill_cachec s � �fdd�}|S )a A class method which returns a closure to use on sys.path_hook 520 which will return an instance using the specified loaders and the path 521 called on the closure. 522 523 If the path called on the closure is not a directory, ImportError is 524 raised. 525 526 c s$ t | �s 527 td| d��� | g��R � S )z-Path hook for importlib.machinery.FileFinder.z only directories are supportedrN )r\ r� rN �r r� r r 528 �path_hook_for_FileFinder\ s z6FileFinder.path_hook.<locals>.path_hook_for_FileFinderr )r r� r� r r� r 529 � path_hookR s 530 zFileFinder.path_hookc C r� )NzFileFinder({!r}))rc rG rU r r r 531 r� d r� zFileFinder.__repr__rL )r� r� r� r� r! r� r� r r� r� r r� r r� r� r r r r 532 r� � s 533 3 534 r� c C s� | � d�}| � d�}|s!|r|j}n||kr t||�}nt||�}|s*t|||d�}z|| d< || d< || d< || d< W d S tyG Y d S w )N� 535 __loader__�__spec__r� �__file__� 536 __cached__)�getr� rn re r � Exception)�nsr� �pathname� cpathnamer� r� r r r 537 �_fix_up_modulej s$ 538 539 540 �r� c C s& t t�� f} ttf}ttf}| ||gS )z_Returns a list of file-based module loaders. 541 542 Each item is a tuple (loader, suffixes). 543 )r^ r� �extension_suffixesre r� rn r� )� 544 extensions�source�bytecoder r r 545 r� � s 546 r� c C s | a d S rL )r� )�_bootstrap_moduler r r 547 �_set_bootstrap_module� s r� c C s2 t | � t� }tj�tj|� g� tj�t � dS )z)Install the path-based import components.N) 548 r� r� r r� r� r� r� � meta_pathrC r� )r� �supported_loadersr r r 549 �_install� s r� )r` rL )NNN)r r )T)Ur� r� r� ri r ru r� r r �ntr r �posixr8 �allrA r� r? rD �_pathseps_with_colonr" �%_CASE_INSENSITIVE_PLATFORMS_BYTES_KEYr! r# r r* r0 r3 rJ rQ rS rX rY r\ r_ rp �type�__code__r� r( r� r' r- rC r� r� r� rC r� r r� �DEBUG_BYTECODE_SUFFIXES�OPTIMIZED_BYTECODE_SUFFIXESr� r� r� r� r� r� r� r� r� r� r� r� r� r� �objectr� r r r r0 rJ re rn r^ rw r� r� r� r� r� r� r� r r r r 550 �<module> s� 551 552 553 554 � 555 556 557 558 559 560 G( ! 561 562 563 564 �IC 2-5E1 565