editable_wheel.pyc
1 o 2 ���c�y � 3 @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z ddl 4 m Z ddl m Z ddlmZ ddlmZ ddlmZ dd lmZmZmZmZmZmZmZm Z m Z m Z dd 5 l m Z m!Z!m"Z"m#Z# dd l$m%Z& dd l'm(Z( dd l)m*Z* er�ddl+m,Z, ej-dkr�ddlm.Z. ner�ddl/m.Z. nddl0m1Z. e e2ef Z3e de3d�Z4e�5e6�Z7G dd� de �Z8dZ9dZ:G dd� de �Z;G dd� de.�Z<G d d � d �Z=G d d � d e=�Z>G d d!� d!�Z?d"ed#e@fd$d%�ZAd&ee2 d'ee2e2f d(ed#e@fd)d*�ZBd+d,� ZCd-e*d#ee2 fd.d/�ZDd-e*d#ee2 fd0d1�ZEd&ee2 d'ee2e2f d2e3d#ee2e2f fd3d4�ZFd5e3d#e2fd6d7�ZGd8ee2e2f d#ee2 fd9d:�ZHd&ee2 d8ee2e2f d#ee e2ee2 f fd;d<�ZId8ee2e2f d#ee2e2f fd=d>�ZJd?e2d@e2dAe2dBe2d#e@f 6 dCdD�ZKdEe3d#e2fdFdG�ZLdHe4d#e4fdIdJ�ZMdKe2d#e2fdLdM�ZNG dNdO� dOe#jO�ZPdPZQdKe2dQee2e2f dRee2ee2 f d#e2fdSdT�ZRG dUdV� dVeS�ZTG dWdX� dXe"jU�ZVdS )Ya� 7 Create a wheel that, when installed, will make the source package 'editable' 8 (add it to the interpreter's path, including metadata) per PEP 660. Replaces 9 'setup.py develop'. 10 11 .. note:: 12 One of the mechanisms briefly mentioned in PEP 660 to implement editable installs is 13 to create a separated directory inside ``build`` and use a .pth file to point to that 14 directory. In the context of this file such directory is referred as 15 *auxiliary build directory* or ``auxiliary_dir``. 16 � N)�suppress)�Enum)�cleandoc)�chain)�Path)�TemporaryDirectory) 17 � TYPE_CHECKING�Dict�Iterable�Iterator�List�Mapping�Optional�Tuple�TypeVar�Union)�Command� SetuptoolsDeprecationWarning�errors� 18 namespaces)�build_py��find_package_path)� Distribution�� WheelFile)� � )�Protocol)�ABC�_P)�boundc @ s6 e Zd ZdZdZdZdZedee dd fdd��Z 19 d S ) 20 � _EditableModea 21 Possible editable installation modes: 22 `lenient` (new files automatically added to the package - DEFAULT); 23 `strict` (requires a new installation when files are added/removed); or 24 `compat` (attempts to emulate `python setup.py develop` - DEPRECATED). 25 �strict�lenient�compat�mode�returnc C sN |st jS |�� }|t jvrt�d|�d���|dkr#d}t�|t� t | S )NzInvalid editable mode: z. Try: 'strict'.�COMPATax 26 The 'compat' editable mode is transitional and will be removed 27 in future versions of `setuptools`. 28 Please adapt your code accordingly to use either the 'strict' or the 29 'lenient' modes. 30 31 For more information, please check: 32 https://setuptools.pypa.io/en/latest/userguide/development_mode.html 33 ) r" �LENIENT�upper� __members__r � OptionError�warnings�warnr )�clsr& �_mode�msg� r2 ��C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.10_3.10.2800.0_x64__qbz5n2kfra8p0\lib\site-packages\setuptools\command\editable_wheel.py�convertG s 34 z_EditableMode.convertN) �__name__� 35 __module__� __qualname__�__doc__�STRICTr) r( � classmethodr �strr4 r2 r2 r2 r3 r" ; s r" zU 36 New or renamed files may not be automatically picked up without a new installation. 37 zt 38 Options like `package-data`, `include/exclude-package-data` or 39 `packages.find.exclude/include` may have no effect. 40 c @ s$ e Zd ZdZdZddddeejpd�fgZdd � Zd 41 d � Z d d � Z 42 dd� Z dd� Z de e fdd�Zdedededefdd�Zdd � Zdeee eeef f fd d �Zd ededededeee eeef f f 43 d d!�Zd"d#� Zd$efd%d&�Zd'd(� Zd)efd*d+�Zded,ededd-fd.d/�Z dS )0�editable_wheelzkBuild 'editable' wheel for development. 44 (This command is reserved for internal use of setuptools). 45 z!create a PEP 660 'editable' wheel)z dist-dir=�dz-directory to put final built distributions in)zdist-info-dir=�Iz(path to a pre-build .dist-info directoryzmode=N� c C s d | _ d | _d | _d | _d S �N)�dist_dir� dist_info_dir� project_dirr& ��selfr2 r2 r3 �initialize_optionsv s 46 z!editable_wheel.initialize_optionsc C s@ | j }|jptj| _|jpi | _t| jptj� | jd��| _d S )N�dist) 47 � distribution�src_root�os�curdirrC � package_dirr rA �path�join)rE rG r2 r2 r3 �finalize_options| s z editable_wheel.finalize_optionsc 48 C s| z#| j jdd� | �� | �d� | �d�}|�| j� | �|� W d S ty= } zt � 49 � d}t � t |��|�d }~ww )NT)�exist_ok� bdist_wheela� 50 Support for editable installs via PEP 660 was recently introduced 51 in `setuptools`. If you are seeing this error, please report to: 52 53 https://github.com/pypa/setuptools/issues 54 55 Meanwhile you can try the legacy behavior by setting an 56 environment variable and trying to install again: 57 58 SETUPTOOLS_ENABLE_FEATURES="legacy-editable" 59 )rA �mkdir�_ensure_dist_info�reinitialize_command�get_finalized_commandZwrite_wheelfilerB �_create_wheel_file� Exception� traceback� print_excr � InternalErrorr )rE rQ �exr1 r2 r2 r3 �run� s 60 61 ��zeditable_wheel.runc C sd | j d u r | �d�}| j|_|�� |�� |j | _ d S t| j ��d�s&J �t| j d�� � s0J �d S )N� dist_infoz 62 .dist-info�METADATA) 63 rB rT rA � 64 output_dir�ensure_finalizedr\ r; �endswithr �exists)rE r] r2 r2 r3 rS � s 65 66 z editable_wheel._ensure_dist_infoc C sD | j }|jsd S t| j| j�dd���� }t||||�}|�� d S )Nr? �.) rH �namespace_packagesr rC rL �get�resolve�_NamespaceInstaller�install_namespaces)rE �installation_dirZ 67 pth_prefixrG rI � installerr2 r2 r3 �_install_namespaces� s z"editable_wheel._install_namespacesr' c C s2 | j r t| j �jnt� }tt|�d��}t|d �S )Nz 68 *.egg-info)rB r �parent�mapr; �glob�next)rE � 69 parent_dir� 70 candidatesr2 r2 r3 �_find_egg_info_dir� s 71 z!editable_wheel._find_egg_info_dir�name�unpacked_wheel� build_lib�tmp_dirc C s | j }t|�}t|�}tt||� d�d��}tt||� d�d��}tt||� d�d��} |jddd�} 72 t|�| 73 _d| 74 _|jddd�} |jd dd�} | | _ | _| _| | _ | _ 75 | _ | | _ | _ || _|| _|�d 76 �} d| _t|�| _|�d �}d |_| �� |_| �� | �� | �� d S )a� Configure commands to behave in the following ways: 77 78 - Build commands can write to ``build_lib`` if they really want to... 79 (but this folder is expected to be ignored and modules are expected to live 80 in the project directory...) 81 - Binary extensions should be built in-place (editable_mode = True) 82 - Data/header/script files are not part of the "editable" specification 83 so they are written directly to the unpacked_wheel directory. 84 z.data�data�headers�scripts�egg_infoT)�reinit_subcommands�build�install�install_scriptsr FN)rH r; r rT �egg_base�ignore_egg_info_in_manifest� build_platlib� build_purelibru �install_purelib�install_platlib� install_libr~ � build_scripts�install_headers� install_data�get_command_obj�no_ep� 85 build_temp�compilerr �existing_egg_info_dir�_set_editable_moder` )rE rs rt ru rv rG �wheelrw rx ry rz r| r} r~ r r2 r2 r3 �_configure_build� s2 86 87 88 89 90 z editable_wheel._configure_buildc C sN | j }|�d�}|�� D ]}|�|�}t|d�r d|_q t|d�r$d|_q dS )z8Set the ``editable_mode`` flag in the build sub-commandsr| � editable_modeT�inplaceN)rH r� �get_sub_commands�hasattrr� r� )rE rG r| �cmd_name�cmdr2 r2 r3 r� � s 91 92 93 94 ��z!editable_wheel._set_editable_modec C sj g }i }| � d�}|�� D ]#}| � |�}t|d�r"|�|�� p g � t|d�r0|�|�� p.i � q ||fS )Nr| � get_outputs�get_output_mapping)rU r� r� �extendr� �updater� )rE �files�mappingr| r� r� r2 r2 r3 �_collect_build_outputs� s 95 96 97 98 �z%editable_wheel._collect_build_outputs� dist_namec C sJ | � ||||� | �� | �� \}}| �d� | �d� | �d� ||fS )Nrx ry rw )r� �_run_build_subcommandsr� � _run_install)rE r� rt ru rv r� r� r2 r2 r3 �_run_build_commands s 99 100 101 z"editable_wheel._run_build_commandsc C sP | � d�}|�� D ] }| � |�}|dkr t|�tkr | �|� q | �|� q dS )a} 102 Issue #3501 indicates that some plugins/customizations might rely on: 103 104 1. ``build_py`` not running 105 2. ``build_py`` always copying files to ``build_lib`` 106 107 However both these assumptions may be false in editable_wheel. 108 This method implements a temporary workaround to support the ecosystem 109 while the implementations catch up. 110 r| r N)rU r� �type� build_py_cls� _safely_run� run_command)rE r| rs r� r2 r2 r3 r� s 111 112 �z%editable_wheel._run_build_subcommandsr� c C sL z| � |�W S ty% t�� � d|� d|� d�}tj|tdd� Y d S w )Nz� 113 114 If you are seeing this warning it is very likely that a setuptools 115 plugin or customization overrides the `z�` command, without 116 taking into consideration how editable installs run build steps 117 starting from v64.0.0. 118 119 Plugin authors and developers relying on custom build steps are encouraged 120 to update their `aO ` implementation considering the information in 121 https://setuptools.pypa.io/en/latest/userguide/extension.html 122 about editable installs. 123 124 For the time being `setuptools` will silence this error and ignore 125 the faulty command, but this behaviour will change in future versions. 126 127 � )� 128 stacklevel)r� rW rX � 129 format_excr- r. r )rE r� r1 r2 r2 r3 r� " s 130 ���zeditable_wheel._safely_runc C s� ddl m} | �d�}|j}d�|�� �}d}|� d|� d|� d�}t| j|�}|�� r0|� � t 131 |d�} t 132 dd�} 133 t 134 d d�} | ��} | 135 �t} | �b}t| t| j �j�}t � | j |� | �| |j� | �|| | |�\}}| �||| �}|�( ||d 136 ��}||||� |�| � W d � n1 s�w Y W d � n1 s�w Y W d � n1 s�w Y W d � n1 s�w Y W d � |S W d � |S 1 s�w Y |S ) Nr r r] �-z 137 0.editablez.whl)�suffixz 138 .build-libz .build-temp�w)�wheel.wheelfiler rU rs rN �get_tagr rA rb �unlinkr rB �shutil�copytreerk r� �_select_strategyZ write_files)rE rQ r r] r� �tagZ build_tag� archive_name� 139 wheel_pathrt ru Z build_tmp�unpacked�lib�tmpZunpacked_dist_infor� r� �strategyZ wheel_objr2 r2 r3 rV 6 sB 140 141 142 143 �� � ��( 144 � 145 � 146 z!editable_wheel._create_wheel_file�categoryc C sL t | jd|� �d �}|r"|� r$t�d|� d�� | �d|� �� d S d S d S )NZhas_z Installing z as non editable�install_)�getattrrH �_logger�infor� )rE r� Z has_categoryr2 r2 r3 r� R s 147 148 �zeditable_wheel._run_installr� �EditableStrategyc C s� d|� d|� �}t | j�}t�| j�}|tju r)tt | jd|��}t| j|||�S t | j�}t 149 || j |�} |tj u } 150 t | j �dhkrD| sF| 151 rX| j �dd�} t| j|t || �g�S t| j|�S )zDDecides which strategy to use to implement an editable installation.� __editable__.r� r| r? rc )r rC r" r4 r& r9 � 152 _empty_dir� _LinkTreerH �_find_packages�_simple_layoutrL r( �setre � 153 _StaticPth�_TopLevelFinder) rE rs r� ru Z 154 build_namerC r& � auxiliary_dir�packagesZhas_simple_layoutZis_compat_mode�src_dirr2 r2 r3 r� X s 155 156 157 158 z editable_wheel._select_strategy) r5 r6 r7 r8 � descriptionr r" � user_optionsrF rO r\ rS rk r r; rr �_Pathr� r� r r r r� r� r� r� rV r� r� r2 r2 r2 r3 r< i s` � 159 ��� 160 �2" ���� 161 � ����r< c @ s> e Zd Zdddee deeef fdd�Zdd� Zd d 162 � Zd S ) r� r� r r� r� c C � d S r@ r2 �rE r� r� r� r2 r2 r3 �__call__t � zEditableStrategy.__call__c C r� r@ r2 rD r2 r2 r3 � __enter__w r� zEditableStrategy.__enter__c C r� r@ r2 �rE � _exc_type� 163 _exc_value� 164 _tracebackr2 r2 r3 �__exit__z r� zEditableStrategy.__exit__N) r5 r6 r7 r r; r r� r� r� r2 r2 r2 r3 r� s s " r� c @ sX e Zd Zdededee fdd�Zdddee d eeef fd 165 d �Z d d � Z 166 dd� Z dS )r� rG rs � path_entriesc C s || _ || _|| _d S r@ )rG rs r� )rE rG rs r� r2 r2 r3 �__init__ s 167 z_StaticPth.__init__r� r r� r� c C s@ d� dd� | jD ��}t|� d�d�}|�d| j� d�|� d S )N� 168 c s s � | ] }t |�� �V qd S r@ )r; rf )�.0�pr2 r2 r3 � <genexpr>� � � z&_StaticPth.__call__.<locals>.<genexpr>�utf-8r� �.pth)rN r� �bytes�writestrrs )rE r� r� r� �entries�contentsr2 r2 r3 r� � s z_StaticPth.__call__c C s, dt ttj| j���d�}t�|t � | S )Nz_ 169 Editable install will be performed using .pth file to extend `sys.path` with: 170 z 171 )�listrm rJ �fspathr� r� �warning�_LENIENT_WARNING�rE r1 r2 r2 r3 r� � s 172 �z_StaticPth.__enter__c C r� r@ r2 r� r2 r2 r3 r� � r� z_StaticPth.__exit__N) r5 r6 r7 r r; r r r� r r� r� r� r2 r2 r2 r3 r� ~ s 173 " r� c s� e Zd ZdZdedededef� fdd� Zdd d 174 ee d e eef f� fd d � Z 175 dede e fdd�Z d dedefdd�Z dd� Zdd� Zdd � Z� ZS ) r� a` 176 Creates a ``.pth`` file that points to a link tree in the ``auxiliary_dir``. 177 178 This strategy will only link files (not dirs), so it can be implemented in 179 any OS, even if that means using hardlinks instead of symlinks. 180 181 By collocating ``auxiliary_dir`` and the original source code, limitations 182 with hardlinks should be avoided. 183 rG rs r� ru c s> t |�| _t |��� | _|�d�j| _t� �||| jg� d S )Nr ) r r� rf ru r� � copy_file�_file�superr� )rE rG rs r� ru �� __class__r2 r3 r� � s 184 z_LinkTree.__init__r� r r� r� c s | � ||� t� �|||� d S r@ )� _create_linksr� r� r� r� r2 r3 r� � s z_LinkTree.__call__�filer' c C sR t t�� t|��� �| j�}t|��tj d�W d � S 1 s"w Y d S )N�/) 185 r � 186 ValueErrorr rf � relative_toru r; �replacerJ �sep)rE r� rM r2 r2 r3 �_normalize_output� s 187 188 �z_LinkTree._normalize_outputN�relative_output�src_filec C s6 | j | }|j�� s|jjdd� | j|||d� d S )NT)�parents��link)r� rl �is_dirrR r� )rE r� r� r� �destr2 r2 r3 � _create_file� s 189 190 z_LinkTree._create_filec s� � j jddd� t� j �rdnd}� fdd�|�� D �}|�d d � |D ]}� �|�}|r7||vr7� �||� q$|�� D ] \}}� j|||d� q<d S )NT)r� rP �sym�hardc s i | ] 191 \}}� � |�|�qS r2 )r� �r� �k�vrD r2 r3 � 192 <dictcomp>� s 193 ��z+_LinkTree._create_links.<locals>.<dictcomp>r� )r� rR �_can_symlink_files�items�popr� r� )rE �outputsZoutput_mapping� link_type�mappings�output�relative�srcr2 rD r3 r� � s 194 � 195 ��z_LinkTree._create_linksc C � d}t �|t � | S )Nz=Strict editable install will be performed using a link tree. 196 )r� r� �_STRICT_WARNINGr� r2 r2 r3 r� � � z_LinkTree.__enter__c C s d| j � d�}t�|t� d S )Nz\ 197 198 Strict editable installation performed using the auxiliary directory: 199 z� 200 201 Please be careful to not remove this directory, otherwise you might not be able 202 to import/use your package. 203 )r� r- r. �InformationOnly�rE r� r� r� r1 r2 r2 r3 r� � s �z_LinkTree.__exit__r@ )r5 r6 r7 r8 r r; r� r� r r r� r r� r� r� r� r� � __classcell__r2 r2 r� r3 r� � s" ����& r� c @ sP e Zd Zdedefdd�Zdddee deeef fd d 204 �Zd d � Z d d� Z 205 dS )r� rG rs c C s || _ || _d S r@ )rG rs )rE rG rs r2 r2 r3 r� � s 206 z_TopLevelFinder.__init__r� r r� r� c C s� | j jptj}tt| j �t| j ��}| j jpi }t|||�}t tt 207 | j j p&g |�dd� t |�D ���}d| j � d�} t| �} 208 tt| ||�d�} |�| 209 � d�| � td| 210 � d| 211 � d �d�} |�d| j � d 212 �| � d S ) Nc s s � | ]}|g fV qd S r@ r2 )r� �nsr2 r2 r3 r� � s � z+_TopLevelFinder.__call__.<locals>.<genexpr>r� z.finderr� z.pyzimport z; z 213 .install()r� )rG rI rJ rK r r� �_find_top_level_modulesrL �_find_package_roots�dict�_find_namespacesr� �_find_virtual_namespacesrs �_make_identifierr� �_finder_templater� ) rE r� r� r� rI � top_levelrL �rootsZ namespaces_rs �finder�contentr2 r2 r3 r� � s �z_TopLevelFinder.__call__c C r )Nz=Editable install will be performed using a meta path finder. 214 )r� r� r� r� r2 r2 r3 r� � r z_TopLevelFinder.__enter__c C s d}t �|t� d S )Nz� 215 216 Please be careful with folders in your working directory with the same 217 name as your package as they may take precedence during imports. 218 )r- r. r r r2 r2 r3 r� � s z_TopLevelFinder.__exit__N) r5 r6 r7 r r; r� r r r� r� r� r2 r2 r2 r3 r� � s 219 " r� �base_dirr' c C s t t| �� �d��o}t|d�t|d�}}|jddd� tttt��) t � 220 ||� |� � rD|j dd�dkrD W d � W d � dS W d � n1 sNw Y zt � ||� W n tyn } zd}t|�|�d }~ww W d � d S 1 s{w Y d S ) 221 N)�dirz file1.txtz file2.txtZfile1r� )�encodingTz�File system does not seem to support either symlinks or hard links. Strict editable installs require one of them to be supported.F)r r; rf r � 222 write_textr �AttributeError�NotImplementedError�OSErrorrJ �symlink� 223 is_symlink� read_textr� rW �LinksNotSupported)r r� Zpath1�path2r[ r1 r2 r2 r3 r s* ��� � 224 ��$�r r� rL rC c s^ � �fdd�| D �}|st � �i dhfv S tj�dd� |�� D ���t�fdd�|�� D ��S )a[ Return ``True`` if: 225 - all packages are contained by the same parent directory, **and** 226 - all packages become importable if the parent directory is added to ``sys.path``. 227 228 >>> _simple_layout(['a'], {"": "src"}, "/tmp/myproj") 229 True 230 >>> _simple_layout(['a', 'a.b'], {"": "src"}, "/tmp/myproj") 231 True 232 >>> _simple_layout(['a', 'a.b'], {}, "/tmp/myproj") 233 True 234 >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"": "src"}, "/tmp/myproj") 235 True 236 >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a": "a", "b": "b"}, ".") 237 True 238 >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a": "_a", "b": "_b"}, ".") 239 False 240 >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a": "_a"}, "/tmp/myproj") 241 False 242 >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a.a1.a2": "_a2"}, ".") 243 False 244 >>> _simple_layout(['a', 'a.b'], {"": "src", "a.b": "_ab"}, "/tmp/myproj") 245 False 246 >>> # Special cases, no packages yet: 247 >>> _simple_layout([], {"": "src"}, "/tmp/myproj") 248 True 249 >>> _simple_layout([], {"a": "_a", "": "src"}, "/tmp/myproj") 250 False 251 c s i | ] }|t |� ���qS r2 r �r� �pkg)rL rC r2 r3 r 4 s ��z"_simple_layout.<locals>.<dictcomp>r? c S s g | ] \}}t ||��qS r2 )� _parent_pathr r2 r2 r3 � 252 <listcomp>: s z"_simple_layout.<locals>.<listcomp>c 3 s6 � | ]\}}t t� g|�d ��R � �t |�kV qdS �rc N)�_normalize_pathr �split)r� �key�value)rl r2 r3 r� ; s 253 � � 254 �z!_simple_layout.<locals>.<genexpr>)r� rJ rM � 255 commonpathr �all)r� rL rC �layoutr2 )rL rl rC r3 r� s � �r� c C s0 |� | �r|dt| � � n|}|�dtj �S )a7 Infer the parent path containing a package, that if added to ``sys.path`` would 256 allow importing that package. 257 When ``pkg`` is directly mapped into a directory with a different name, return its 258 own path. 259 >>> _parent_path("a", "src/a") 260 'src' 261 >>> _parent_path("b", "src/c") 262 'src/c' 263 Nr� )ra �len�rstriprJ r� )r, �pkg_pathrl r2 r2 r3 r- A s 264 r- rG c c s~ � t | jpg �E d H | jpg }dd� |D �}| jr | jV n| jp#g }|dd� |D �7 }|D ] }|�d�\}}}|V q/d S )Nc S s g | ]}d |v r|�qS �rc r2 �r� �modr2 r2 r3 r. S s z"_find_packages.<locals>.<listcomp>c S s g | ] 265 }d |j v r|j �qS r: �rs �r� �xr2 r2 r3 r. X s rc )�iterr� � 266 py_modules� ext_package� ext_modules� 267 rpartition)rG rA Znested_modulesrC �module�package�_r2 r2 r3 r� O s � 268 269 270 �r� c c sL � | j pg }dd� |D �E d H | js$| jpg }dd� |D �E d H d S d S )Nc s s � | ] }d |vr|V qdS r/ r2 r; r2 r2 r3 r� a r� z*_find_top_level_modules.<locals>.<genexpr>c s s � | ] }d |j vr|j V qdS r/ r= r> r2 r2 r3 r� e s � )rA rB rC )rG rA rC r2 r2 r3 r _ s � 271 272 �r rI c s � �fdd�t | �D �}t|�S )Nc s i | ] }|t t|� ����qS r2 )�_absolute_rootr r+ �rL rI r2 r3 r m s ��z'_find_package_roots.<locals>.<dictcomp>)�sorted�_remove_nested)r� rL rI � pkg_rootsr2 rI r3 r h s �r rM c C s4 t | �}|j}|�� rt|�� �S t|�� |j �S )z(Works for packages and top-level modules)r rl rb r; rf rs )rM Zpath_rl r2 r2 r3 rH u s 273 rH rL c c sv � | D ]5}d|vr 274 q|� d�}tt|�d dd�D ] }d�|d|� �}tt|| d��}|�� r4|| vr7|V qqdS )a8 By carefully designing ``package_dir``, it is possible to implement the logical 275 structure of PEP 420 in a package without the corresponding directories. 276 277 Moreover a parent package can be purposefully/accidentally skipped in the discovery 278 phase (e.g. ``find_packages(include=["mypkg.*"])``, when ``mypkg.foo`` is included 279 by ``mypkg`` itself is not). 280 We consider this case to also be a virtual namespace (ignoring the original 281 directory) to emulate a non-editable installation. 282 283 This function will try to find these kinds of namespaces. 284 rc � r �����Nr? )r1 �ranger7 rN r r rb )rL r, �parts�i� partial_namerM r2 r2 r3 r � s � 285 ���r c c sB � | D ]}t ||d�}t|��� r t|d��� s ||gfV qd S )Nr? z __init__.py)r r rb )r� rL r, rM r2 r2 r3 r � s � ��r c sP t | �� �}tt| �� ��D ]\�� t� �fdd�| �� D ��r%|��� q|S )Nc 3 s* � | ]\}}�|kot �� ||�V qd S r@ )� 286 _is_nested)r� �other� 287 other_path�rM r, r2 r3 r� � s 288 � � 289 �z!_remove_nested.<locals>.<genexpr>)r �copy�reversedr� r �anyr )rL r 290 r2 rV r3 rK � s � 291 �rK r, r9 rl � parent_pathc C sD t |�}| �|dd��d��d�}| �|�o!|t t|g|�R � �kS )a� 292 Return ``True`` if ``pkg`` is nested inside ``parent`` both logically and in the 293 file system. 294 >>> _is_nested("a.b", "path/a/b", "a", "path/a") 295 True 296 >>> _is_nested("a.b", "path/a/b", "a", "otherpath/a") 297 False 298 >>> _is_nested("a.b", "path/a/b", "c", "path/c") 299 False 300 >>> _is_nested("a.a", "path/a/a", "a", "path/a") 301 True 302 >>> _is_nested("b.a", "path/b/a", "a", "path/a") 303 False 304 r? rM rc )r0 r� �stripr1 � 305 startswithr )r, r9 rl rZ Z norm_pkg_path�restr2 r2 r3 rS � s 306 307 �rS �filenamec C s6 t jdkr tj�| �n| }tj�tj�tj�|���S )z1Normalize a file/dir name for comparison purposes�cygwin)�sys�platformrJ rM �abspath�normcase�realpath�normpath)r^ r� r2 r2 r3 r0 � s r0 �dir_c C s t j| dd� t�| � | S )zFCreate a directory ensured to be empty. Existing files may be removed.T)� ignore_errors)r� �rmtreerJ �makedirs)rf r2 r2 r3 r� � s 308 r� rs c C s t �dd| �}|�� s J �|S )z�Make a string safe to be used as Python identifier. 309 >>> _make_identifier("12abc") 310 '_12abc' 311 >>> _make_identifier("__editable__.myns.pkg-78.9.3_local") 312 '__editable___myns_pkg_78_9_3_local' 313 z 314 \W|^(?=\d)rG )�re�sub� isidentifier)rs �safer2 r2 r3 r � s r c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )rg c C s( || _ || _|| _|| _g | _d| _d S )NF)rH rI ri � editable_namer �dry_run)rE rH ri rn rI r2 r2 r3 r� � s 315 z _NamespaceInstaller.__init__c C s t j�| j| j�S )zInstallation target.)rJ rM rN ri rn rD r2 r2 r3 � _get_target� s z _NamespaceInstaller._get_targetc C s t t| j��S )z1Where the modules/packages should be loaded from.)�reprr; rI rD r2 r2 r3 � _get_root� s z _NamespaceInstaller._get_rootN)r5 r6 r7 r� rp rr r2 r2 r2 r3 rg � s rg a< import sys 316 from importlib.machinery import ModuleSpec 317 from importlib.machinery import all_suffixes as module_suffixes 318 from importlib.util import spec_from_file_location 319 from itertools import chain 320 from pathlib import Path 321 322 MAPPING = {mapping!r} 323 NAMESPACES = {namespaces!r} 324 PATH_PLACEHOLDER = {name!r} + ".__path_hook__" 325 326 327 class _EditableFinder: # MetaPathFinder 328 @classmethod 329 def find_spec(cls, fullname, path=None, target=None): 330 for pkg, pkg_path in reversed(list(MAPPING.items())): 331 if fullname == pkg or fullname.startswith(f"{{pkg}}."): 332 rest = fullname.replace(pkg, "", 1).strip(".").split(".") 333 return cls._find_spec(fullname, Path(pkg_path, *rest)) 334 335 return None 336 337 @classmethod 338 def _find_spec(cls, fullname, candidate_path): 339 init = candidate_path / "__init__.py" 340 candidates = (candidate_path.with_suffix(x) for x in module_suffixes()) 341 for candidate in chain([init], candidates): 342 if candidate.exists(): 343 return spec_from_file_location(fullname, candidate) 344 345 346 class _EditableNamespaceFinder: # PathEntryFinder 347 @classmethod 348 def _path_hook(cls, path): 349 if path == PATH_PLACEHOLDER: 350 return cls 351 raise ImportError 352 353 @classmethod 354 def _paths(cls, fullname): 355 # Ensure __path__ is not empty for the spec to be considered a namespace. 356 return NAMESPACES[fullname] or MAPPING.get(fullname) or [PATH_PLACEHOLDER] 357 358 @classmethod 359 def find_spec(cls, fullname, target=None): 360 if fullname in NAMESPACES: 361 spec = ModuleSpec(fullname, None, is_package=True) 362 spec.submodule_search_locations = cls._paths(fullname) 363 return spec 364 return None 365 366 @classmethod 367 def find_module(cls, fullname): 368 return None 369 370 371 def install(): 372 if not any(finder == _EditableFinder for finder in sys.meta_path): 373 sys.meta_path.append(_EditableFinder) 374 375 if not NAMESPACES: 376 return 377 378 if not any(hook == _EditableNamespaceFinder._path_hook for hook in sys.path_hooks): 379 # PathEntryFinder is needed to create NamespaceSpec without private APIS 380 sys.path_hooks.append(_EditableNamespaceFinder._path_hook) 381 if PATH_PLACEHOLDER not in sys.path: 382 sys.path.append(PATH_PLACEHOLDER) # Used just to trigger the path hook 383 r� r c C s( t t|�� dd� d��}tj| ||d�S )z_Create a string containing the code for the``MetaPathFinder`` and 384 ``PathEntryFinder``. 385 c S s | d S )Nr r2 )r� r2 r2 r3 �<lambda>? s z"_finder_template.<locals>.<lambda>)r2 �rs r� r )r rJ r �_FINDER_TEMPLATE�formatrt r2 r2 r3 r 9 s r c @ � e Zd ZdZdS )r z�Currently there is no clear way of displaying messages to the users 386 that use the setuptools backend directly via ``pip``. 387 The only thing that might work is a warning, although it is not the 388 most appropriate tool for the job... 389 N�r5 r6 r7 r8 r2 r2 r2 r3 r C � r c @ rw )r) zCFile system does not seem to support either symlinks or hard links.Nrx r2 r2 r2 r3 r) K ry r) )Wr8 �loggingrJ rj r� r` rX r- � 390 contextlibr �enumr �inspectr � itertoolsr �pathlibr �tempfiler �typingr r r 391 r r r r r r r � 392 setuptoolsr r r r Zsetuptools.command.build_pyr r� �setuptools.discoveryr �setuptools.distr r� r � version_infor �typing_extensions�abcr r; r� r � getLoggerr5 r� r" r r� r< r� r� r� r� �boolr r� r- r� r r rH r r rK rS r0 r� r � Installerrg ru r � UserWarningr � FileErrorr) r2 r2 r2 r3 �<module> s� 0 393 394 $ G%� 395 �� 396 �, � 397 �� 398 399 � � 400 � 401 �" H� 402 �� 403 � 404