misc_util.pyc
1 o 2 [��c�f � @ s^ d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl 3 Z 4 d dl Z d dl mZ d dlmZ d dlZd dlmZ e� Zg Zdd� Ze�e� g d�ZG dd � d �Zd 5 d � Zd d � Z dd� Z dd� Z d�dd�Z dd� Z d�dd�Z!dd� Z"dd� Z#d d � Z$d�d d!�Z%d�d"d#�Z&d$d%� Z'e'� r�e(d d&d'd(d)d*d+d,d-d.� Z)d�d0d1�Z*nd�d2d1�Z*d3d4� Z+d5d6� Z,d7d8� Z-d9d:� Z.d;d<� Z/d=d>� Z0d?e1d@e1fdAdB�Z2dCdD� Z3dEdF� Z4dGdH� Z5dIdJ� Z6e�7dKej8�j9Z:e�7dLej8�j9Z;e�7dMej8�j9Z<e�7dNej8�j9Z=dOdP� Z>dQdR� Z?dSdT� Z@dUdV� ZAdWdX� ZBdYdZ� ZCd[d\� ZDd]d^� ZEd_d`� ZFdadb� ZGdcdd� ZHdedf� ZIdgdh� ZJdidj� ZKdkdl� ZLdmdn� ZMdodp� ZNdqdr� ZOdsdt� ZPdudv� ZQd�dwdx�ZRdydz� ZSd{d|� ZTd�d}d~�ZUG dd�� d��ZVi fd�d��ZWd�d�� ZXd�d�� ZYd�d�d��ZZd�d�d��Z[d�d�� Z\d�d�d��Z]d�d�� Z^d�d�� Z_d�d�� Z`d�d�� Zad�d�� Zbd�d�hZcd�d�� Zdd�d�� ZedS )�� N)�local)�reduce)�DistutilsErrorc C s: t d urt D ]} zt�| � W q ty Y qw d S d S �N)�_tmpdirs�shutil�rmtree�OSError)�d� r ��C:\Users\Jacks.GUTTSPC\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.10_qbz5n2kfra8p0\LocalCache\local-packages\Python310\site-packages\numpy\distutils\misc_util.py� clean_up_temporary_directory s ��r )*� Configuration�get_numpy_include_dirs�default_config_dict� dict_append� 6 appendpath�generate_config_py�get_cmd�allpath� get_mathlibs�terminal_has_colors�red_text� 7 green_text� yellow_text� blue_text� cyan_text� cyg2win32�mingw32� all_strings� has_f_sources�has_cxx_sources�filter_sources�get_dependencies�is_local_src_dir�get_ext_source_files�get_script_files�get_lib_source_files�get_data_files�dot_join� get_frame� 8 minrelpath�njoin� is_sequence� is_string�as_list�gpaths� get_language�get_build_architecture�get_info� get_pkg_info�get_num_build_jobs�sanitize_cxx_flags�exec_mod_from_locationc @ s e Zd ZdZdd� ZdS )�InstallableLiba� 9 Container to hold information on an installable library. 10 11 Parameters 12 ---------- 13 name : str 14 Name of the installed library. 15 build_info : dict 16 Dictionary holding build information. 17 target_dir : str 18 Absolute path specifying where to install the library. 19 20 See Also 21 -------- 22 Configuration.add_installed_library 23 24 Notes 25 ----- 26 The three parameters are stored as attributes with the same names. 27 28 c C s || _ || _|| _d S r )�name� 29 build_info� 30 target_dir)�selfr9 r: r; r r r �__init__F s 31 zInstallableLib.__init__N)�__name__� 32 __module__� __qualname__�__doc__r= r r r r r8 0 s r8 c C s� ddl m} z tt�d��}W n ty t�� }Y nw t|d�}t tj 33 � d|��}| � }|du r4|S t |� d�dd�t |� d�dd�t |� d �dd�f}td 34 d � |D ��rY|S td d � |D ��S ) a� 35 Get number of parallel build jobs set by the --parallel command line 36 argument of setup.py 37 If the command did not receive a setting the environment variable 38 NPY_NUM_BUILD_JOBS is checked. If that is unset, return the number of 39 processors on the system, with a maximum of 8 (to prevent 40 overloading the system if there a lot of CPUs). 41 42 Returns 43 ------- 44 out : int 45 number of parallel jobs that can be run 46 47 r ��get_distribution� ZNPY_NUM_BUILD_JOBSN�build�parallel� build_ext� 48 build_clibc s s � | ]}|d u V qd S r r ��.0�xr r r � <genexpr>k s � z%get_num_build_jobs.<locals>.<genexpr>c s s � | ] }|d ur|V qd S r r rI r r r rL n s � )�numpy.distutils.corerC �len�osZsched_getaffinity�AttributeError�multiprocessing� cpu_count�min�int�environ�get�getattr�get_command_obj�all�max)rC rR Zenvjobs�distZcmdattrr r r r5 L s$ � 49 �r5 c C s^ ddl }|jdtdd� t| �} tt| ��D ]}| | }d|v r,|d dvr,d| | |< q| S ) z8Quote list of arguments. 50 51 .. deprecated:: 1.22. 52 r Nz"quote_args" is deprecated.� �� 53 stacklevel� z"'z"%s")�warnings�warn�DeprecationWarning�list�rangerN )�argsr` �i�ar r r � 54 quote_argsp s � �rh c C s | � d�}tjj|� S )zDConvert a /-separated pathname to one using the OS's path separator.�/)�splitrO �path�join)r9 rj r r r r � s 55 r c C s� t j�t j�|��}t j�t j�| ��}t|�t|�k r | S ||kr$dS ||dt|�� krN|t|� t jfv sDJ t| |t|� f���|t|�d d� } | S )z$Return path relative to parent_path.� N� )rO rk �realpath�abspathrN �sep�repr)rk � parent_path�pd�apathr r r �rel_path� s ,rv c C s� zt d| j| j�}tj�tj�|��}W n1 tyE t d| j| j�}t|� t j 56 | }t |d�r=tj�tj�|j ��}ntj�d�}Y nw |durOt ||�}|pRdS )z�Return path of the module given a frame object from the call stack. 57 58 Returned path is relative to parent_path when given, 59 otherwise it is absolute path. 60 �__file__r> �.N)�eval� f_globals�f_localsrO rk �dirnamerp � NameError� 61 __import__�sys�modules�hasattrrw rv )�framers Z caller_filer 62 � caller_name�modr r r �get_path_from_frame� s 63 64 �� 65 r� c G sz g }| D ]}t |�r|�t|� � qt|�sJ �|�|� q|} | s%d}ntjj| � }tjjdkr9|�dtjj�}t |�S )a2 Join two or more pathname components + 66 - convert a /-separated pathname to one using the OS's path separator. 67 - resolve `..` and `.` from path. 68 69 Either passing n arguments as in njoin('a','b'), or a sequence 70 of n names as in njoin(['a','b']) is handled, or a mixture of such arguments. 71 rm ri ) 72 r- �appendr, r. rO rk rl rq �replacer+ )rk �paths�p�joinedr r r r, � s r, c C s� | dur t j�| d�}n t� }|D ]} t j�| d�}t j�|�r$|} nqtd|f ��t|��+}g }d}|D ]}|�|�rR|t|�d� � � }|rR|� 73 |� d�� q7W d � |S 1 s^w Y |S )z/Return the MATHLIB line from numpyconfig.h 74 Nz_numpyconfig.hz1_numpyconfig.h not found in numpy include dirs %rz#define MATHLIB�,) rO rk rl r �existsr �open� 75 startswithrN �strip�extendrj ) rk � config_file�dirs�fn�fid�mathlibs�s�line�valuer r r r � s4 �� 76 77 �� 78 ��r c C s� t | �s| S d| vr | S | �tj�}|r+z|�dd�}W n ty% Y nw ||= |sd}|rZz|�d|�}W n ty@ Y nw ||d dkrN|d7 }n 79 ||= ||d = d}|s/|s^dS tj�|�S )z$Resolve `..` and '.' from path. 80 rx rn z..rm )r. rj rO rq �index� 81 ValueErrorrl )rk �lrf �jr r r r+ � s8 �� � 82 � 83 r+ c C s t t�| ��S )z}sorts output of python glob for https://bugs.python.org/issue30461 84 to allow extensions to have reproducible build results)�sorted�glob)Zfileglobr r r � sorted_glob s r� c C sB t | �s J tt| ����g }t| �rJ t| ���| D ]}t|�r�d|v s(d|v rSt|�}tt||��}|r;|�|� q|rC|�|� q|rJ|�|� td||f � qt||�}t j 85 � |�rd|�|� qt j 86 � |�rp|�|� n|rw|�|� t j 87 � |�s�td||f � qt |�r�|�t |||�� q|�|� qdd� |D �S )N�*�?z#could not resolve pattern in %r: %rznon-existing path in %r: %rc S s g | ]}t |��qS r )r+ �rJ r� r r r � 88 <listcomp>- � z _fix_paths.<locals>.<listcomp>) r- rr �typer. r� r, r� r� �printrO rk r� � 89 _fix_paths)r� � 90 local_path�include_non_existingZ new_paths�nr� �p2�n2r r r r� 91 sB 92 � 93 94 �� r� rm Tc C s t | �r| f} t| ||�S )z:Apply glob to paths and prepend local_path if needed. 95 )r. r� )r� r� r� r r r r0 / s r0 c C sL t td�st�� t_t�tj� tj| |tj|d�\}}t� |d�}||fS )N�tempdir)�suffix�prefix�dir�text�w) 96 r� �_tdata�tempfile�mkdtempr� r r� �mkstemprO �fdopen)r� r� r� r� r9 �for r r �make_temp_file6 s 97 98 99 � r� c C s� t jdkr dtjvr dS tt jd�rgt j�� rgzEdd l} | �� | � d�dkrT| � d�dkrW| � 100 d�d ur<| � 101 d�d usQ| � 102 d �d urJ| � 103 d 104 �d usQ| � 105 d �d urZW d S W dS W dS W dS t yf Y dS w dS ) N�cygwinZ USE_COLORr �isatty�colors�pairs�setf�setb�setafZsetabZscprn ) r �platformrO rU r� �stdoutr� �curses� setupterm�tigetnum�tigetstr� Exception)r� r r r r C s2 � 106 � � ��r rn r\ � � � � � � ) �black�red�green�yellow�blue�magenta�cyan�white�defaultFc C sx g }|r |� d� |r dt�|�� d� }|� t|�� |r/dt�|�� d� }|� t|�� |r:dd�|�| f S | S )N�1� r �( r� z [%sm%s[0m�;)r� � _colour_codesrV �lower�strrl )r� �fg�bg�bold�seqZfgcodeZbgcoder r r � colour_texta s 107 r� c C s | S r r )r� r� r� r r r r� p s c C � 108 t | d�S )Nr� �r� �r� r r r � default_texts � 109 r� c C r� )Nr� r� r� r r r r u r� r c C r� )Nr� r� r� r r r r w r� r c C r� )Nr� r� r� r r r r y r� r c C r� )Nr� r� r� r r r r { r� r c C r� )Nr� r� r� r r r r } r� r rk �returnc C s" t jdkr| S tjdd| gdd�S )a( Convert a path from Cygwin-native to Windows-native. 110 111 Uses the cygpath utility (part of the Base install) to do the 112 actual conversion. Falls back to returning the original path if 113 this fails. 114 115 Handles the default ``/cygdrive`` mount prefix as well as the 116 ``/proc/cygdrive`` portable prefix, custom cygdrive prefixes such 117 as ``/`` or ``/mnt``, and absolute paths such as ``/usr/src/`` or 118 ``/home/username`` 119 120 Parameters 121 ---------- 122 path : str 123 The path to convert 124 125 Returns 126 ------- 127 converted_path : str 128 The converted path 129 130 Notes 131 ----- 132 Documentation for cygpath utility: 133 https://cygwin.com/cygwin-ug-net/cygpath.html 134 Documentation for the C function it wraps: 135 https://cygwin.com/cygwin-api/func-cygwin-conv-path.html 136 137 r� z/usr/bin/cygpathz --windowsT)r� )r r� � 138 subprocess� check_output)rk r r r r � s 139 140 141 �r c C s: t jdkrtj�dd�dkrdS tj�dd�dkrdS dS ) z0Return true when using mingw32 environment. 142 �win32ZOSTYPErm ZmsysTZMSYSTEMZMINGW32F)r r� rO rU rV r r r r r � s 143 r c C s: t j�d�} | dkrtt j| d | d � �}|S d}|S )zGReturn version of MSVC runtime library, as defined by __MSC_VER__ macrozMSC v.�����r� � 144 N)r �version�findrT )�msc_pos�msc_verr r r �msvc_runtime_version� s �r� c C s& t � } | r| dk r d| S d| S dS )zFReturn name of MSVC runtime library if Python was built with MSVC >= 7� zmsvcr%iz vcruntime%iN)�msvc_runtime_major)�verr r r �msvc_runtime_library� s r� c C s ddddddd�� t� d�} | S ) zFReturn major version of MSVC runtime coded like get_build_msvc_version�F �G �P �Z �d r� )i i ix i� i@ il N)rV r� )�majorr r r r� � s � 145 �r� z.*\.(cpp|cxx|cc)\Zz .*\.(f90|f95|f77|for|ftn|f)\Zz.*\.(f90|f95)\Zz \s*module\s*(?P<name>[\w_]+)c C sj t | �sg S g }t| d�� }|D ]}t|�}|r"|�d�}|�|� qW d � |S 1 s.w Y |S )zRReturn a list of Fortran f90 module names that 146 given source file defines. 147 �rr9 N)� f90_ext_matchr� �f90_module_name_match�groupr� )�sourcer� �fr� �mr9 r r r �_get_f90_modules� s 148 149 �� 150 ��r c C s 151 t | t�S r )� 152 isinstancer� r� r r r r. � r� r. c C s | D ] }t |�s dS qdS )z4Return True if all items in lst are string objects. FT�r. )�lst�itemr r r r � � 153 �r c C s0 t | �rdS zt| � W dS ty Y dS w )NFT)r. rN r� �r� r r r r- � s 154 ��r- c C s t | �o d| v p d| v S )Nr� r� r r� r r r �is_glob_pattern� s r c C s t | �rt| �S | gS r )r- rc r 155 r r r r/ � s r/ c C s: d}| D ]}t |t�rt|�rd} |S t|�rd}q|S )z2Determine language value (c,f77,f90) from sources N�f90�f77)r r� r� �fortran_ext_match)�sources�languager r r r r1 s 156 ��r1 c C � | D ] }t |�r dS qdS )z.Return True if sources contains Fortran files TF)r �r r r r r r r r c C r )z*Return True if sources contains C++ files TF)� cxx_ext_matchr r r r r! r r! c C sp g }g }g }g }| D ]'}t |�r"t|�}|r |�|� q 157 |�|� q 158 t|�r,|�|� q 159 |�|� q 160 ||||fS )ztReturn four lists of filenames containing 161 C, C++, Fortran, and Fortran 90 module sources, 162 respectively. 163 )r r r� r )r � c_sources� cxx_sources� f_sources�fmodule_sourcesr r� r r r r" s r" c C s. g }| D ]}t tj�|d��}|�|� q|S )Nz*.h)r� rO rk rl r� )�directory_list�headersr 164 �headr r r � _get_headers5 s 165 r c C sD g }| D ]}t j�|�}|d dkr |d |vr |�|d � q|S )Nr rm )rO rk rj r� )Zlist_of_sourcesZdirecsr r 166 r r r �_get_directories= s �r c C s6 d}|d� | �7 }|d� |�7 }|d� |�d 7 }|S )zb 167 Return commandline representation used to determine if a file needs 168 to be recompiled 169 z commandline: r_ � 170 �rl )�cc_args�extra_postargs�pp_opts�cmdliner r r �_commandline_dep_stringF s 171 r# c C s t t| ��S r )r r )r r r r r# R s r# c C s� t | �sdS tj�| �}tj�t�� |g�}|t|�d� �tj�}|r.|d s.|dd� }|r8|d dkr8dS tj� |�}tj� 172 |�S )z1Return true if directory is local directory. 173 FNr rn rE ) r. rO rk rp � commonprefix�getcwdrN rj rq rl �isdir)� directoryZabs_dir�c�new_dirr r r r$ V s r$ c # sx � dddd�� t �d�}tj| dd�D ]&\}}}� fdd�|D �}||d d �< |D ]}|�|�s8tj�||�V q)qd S )Nrn ��CVS�.svnrE �(?:[~#]|\.py[co]|\.o)$T��topdownc � g | ]}|� vr|�qS r r �rJ r 174 ��pruned_directoriesr r r� i � z(general_source_files.<locals>.<listcomp>)�re�compilerO �walk�searchrk rl )�top_path�prune_file_pat�dirpath�dirnames� filenames�prunedr r r2 r �general_source_filese s � 175 176 ���r? c 177 # s� � g d��t �d��tj| dd�D ]K\}}}�fdd�|D �}||dd�< |D ]4}tj�||�� t� | �}g }t�� �D ]}tj�� |�} tj�| �rU�� | �sU|� 178 | � q<||fV q'q| � t� | �}� �fdd�t�� �D �}d d� |D �}||fV dS ) 179 zJReturn a directory name relative to top_path and 180 files contained. 181 r* r- Tr. c r0 r r r1 r2 r r r� v r4 z4general_source_directories_files.<locals>.<listcomp>Nc s$ g | ]}�� |�stj�� |��qS r )r8 rO rk rl �rJ r )�dpathr: r r r� � s �c S � g | ] 182 }t j�|�r|�qS r )rO rk �isfiler@ r r r r� � � ) r5 r6 rO r7 rk rl rv �listdirrC r8 r� ) 183 r9 r; r< r= r> r 184 �rpath�filesr r� r )rA r: r3 r � general_source_directories_fileso s, � 185 186 187 � � 188 rH c C sn g }dd� | j D �}|�|� |�t|�� | jD ]}t|�r)|�tt|��� qtj� |�r4|� 189 |� q|S )Nc S � g | ]}t |�r|�qS r r �rJ �_mr r r r� � r4 z(get_ext_source_files.<locals>.<listcomp>) r r� r# �dependsr$ rc r? rO rk rC r� )�extr= r r 190 r r r r% � s 191 192 193 �r% c C s dd� | D �} | S )Nc S rI r r rJ r r r r� � r4 z$get_script_files.<locals>.<listcomp>r )�scriptsr r r r& � s r& c C s� g }| d � dg �}dd� |D �}|�|� |�t|�� | d � dg �}|D ]}t|�r7|�tt|��� q'tj�|�rB|� |� q'|S )Nrn r c S rI r r rJ r r r r� � r4 z(get_lib_source_files.<locals>.<listcomp>rL ) 194 rV r� r# r$ rc r? rO rk rC r� )�libr= r rL r 195 r r r r' � s 196 197 �r' c C s� t j�� }|�dd�}| sAtj�d�stj�d�r d}|S tj�d�r'd}|S tj�d�r1d }|S d 198 |v rA|�d |�d 199 � dd �}|S ) a� Return the correct file extension for shared libraries. 200 201 Parameters 202 ---------- 203 is_python_ext : bool, optional 204 Whether the shared library is a Python extension. Default is False. 205 206 Returns 207 ------- 208 so_ext : str 209 The shared library extension. 210 211 Notes 212 ----- 213 For Python shared libs, `so_ext` will typically be '.so' on Linux and OS X, 214 and '.pyd' on Windows. For Python >= 3.2 `so_ext` has a tag prepended on 215 POSIX systems according to PEP 3149. 216 217 � 218 EXT_SUFFIXrm �linux� gnukfreebsdz.so�darwinz.dylib�winz.dll�SOABIrx rn )� distutils� sysconfig�get_config_varsrV r r� r� r� )� is_python_extZconfvars�so_extr r r �get_shared_lib_extension� s" 219 220 � � 221 ��r[ c C s� t | �r| gS | d }g }|D ]1}t|d�rqt|�r%|�tt|��� qt |�r;tj�|�r5|� |� qt 222 d|� qt t |���|S )Nrn �__call__zNot existing data file:) r. r� r$ r� rc r? rO rk rC r� r� � TypeErrorrr )�datar r= r� r r r r( � s 223 r( c G s d� dd� | D ��S )Nrx c S s g | ]}|r|�qS r r )rJ rg r r r r� � r� z dot_join.<locals>.<listcomp>r )re r r r r) � s r) c C sN zt �| d �W S ty& t �� d j}t| d �D ]}|j}q | Y S w )z:Return frame object from call stack with given level. 224 rn r\ )r � _getframerP �exc_info�tb_framerd �f_back)�levelr� �_r r r r* � s �r* c @ s� e Zd Zg d�ZddgZddgZg Z dXd d 225 �Zd d � Zd d� Z dd� Z 226 dd� Z dd� Z dYdd�Z dYdd�Z dZdd�Z d[d d �Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Zd2d3� Zd\d4d5�Z d\d6d7�Z d8d9� Z d:d;� Z d<d=� Z d>d?� Z!d@dA� Z"dBdC� Z#dDdE� Z$dFdG� Z%dHdI� Z&dJdK� Z'd]dLdM�Z(d^dOdP�Z)d^dQdR�Z*d_dTdU�Z+dVdW� Z,dS )`r ) 227 �packages� ext_modules� 228 data_files� include_dirs� librariesr rN � 229 py_modules�installed_libraries� define_macros� package_dir�installed_pkg_configr9 r� Nrn �setup.pyc K s| t ||�| _d| _t|�}t||�| _|du r | j}d| _|du r%| j}ntj�t | j|��r5t | j|�}tj�|p;d�sDt 230 d|f ��|| _ || _ tjj | j�d�� | _| jdd� | _| jdd� | _| jD ]} t�|�| g ��} 231 t| | t| 232 �� qh| jD ]} t�|�| i ��} 233 t| | | 234 � q| j| j } | jdd� | _|�� D ]/} | | v r�q�|| } t| | | � t| t �r�| j� | � q�t| t �r�| j� | � q�| j� | � q�tj� t |d��r�| j � | j� || j!| j< t ddddd�| _"d} t#dd �D ])}zt|�}W n t 235 �y Y nw z t$d 236 |j%|j&�} W n 237 t'�y" Y q�w t| | j(��r9| j"d �r9| j)d i | j"�� || _*dS ) a� Construct configuration instance of a package. 238 239 package_name -- name of the package 240 Ex.: 'distutils' 241 parent_name -- name of the parent package 242 Ex.: 'numpy' 243 top_path -- directory of the toplevel package 244 Ex.: the directory where the numpy package source sits 245 package_path -- directory of package. Will be computed by magic from the 246 directory of the caller module if not specified 247 Ex.: the directory where numpy.distutils is 248 caller_level -- frame level to caller namespace, internal parameter. 249 Nrm rx z%r is not a directory� __init__.pyF)�ignore_setup_xxx_py� assume_default_configuration� delegate_options_to_subpackages�quietrn r� r< rs r )+r) r9 r� r* r� r� rO rk r& r, r� r9 � package_pathrl rj �path_in_package� 250 _list_keys� list_keys� 251 _dict_keys� dict_keys�copyrV �setattrr/ � _extra_keys� 252 extra_keys�keysr rc r� �dictr� re rm �optionsrd ry rz r{ r} � __class__� set_options� 253 setup_name)r< � package_name� parent_namer9 ru � caller_levelr� �attrs� caller_framer� �v� 254 known_keysrg Zcaller_instancerf r r r r r= s| 255 256 257 258 � �� 259 zConfiguration.__init__c C sB | � � i }| j| j | j }|D ] }t| |�}|r |||< q|S )z� 260 Return a dictionary compatible with the keyword arguments of distutils 261 setup function. 262 263 Examples 264 -------- 265 >>> setup(**config.todict()) #doctest: +SKIP 266 )�_optimize_data_filesrx rz r~ rW )r< r 267 r� r� rg r r r �todictb s 268 269 �zConfiguration.todictc C s | j d s t|� d S d S )Nrt )r� r� �r< �messager r r �infou s 270 �zConfiguration.infoc C s t j�d|f � d S )Nz Warning: %s 271 )r �stderr�writer� r r r ra y s zConfiguration.warnc K s6 |� � D ]\}}|| jv r|| j|< qtd| ��dS )z� 272 Configure Configuration instance. 273 274 The following options are available: 275 - ignore_setup_xxx_py 276 - assume_default_configuration 277 - delegate_options_to_subpackages 278 - quiet 279 280 zUnknown option: N)�itemsr� r� )r< r� �keyr� r r r r� | s 281 282 �zConfiguration.set_optionsc C s ddl m} |� S )z2Return the distutils distribution object for self.r rB )rM rC )r< rC r r r rC � s z Configuration.get_distributionc C s� |� d�}t| jg| �}dd� t|�D �}g }|D ]4}tj�t|d��s&qd|� tj�v r/qd�|� tj�t |� d � �} | j 283 | ||d d�} 284 |� | 285 � q|S )Nrx c S rB r )rO rk r& rJ r r r r� � rD z:Configuration._wildcard_get_subpackage.<locals>.<listcomp>rp rE rn �r� r� ) rj r, r� r� rO rk rC rq rl rN �get_subpackager� ) r< �subpackage_namer� r� r� �subpackage_pathr� � config_listr 286 r� r( r r r �_wildcard_get_subpackage� s 287 � z&Configuration._wildcard_get_subpackagec C s& t j�dtj�|�� z�tj�tj�|��d }t| j||�}t d� 288 |� d��|�}t |d�sH| j d s;| �d| � t||| j||d d�} n#t|g|� d�d d � � } 289 | 290 f} |jjjdkrf| | jf } |j| � } | jt||�kr�| �d 291 t||�| jf � W t jd= | S W t jd= | S t jd= w ) Nr rd rx � configurationrr zCAssuming default configuration (%s does not define configuration())rn �r� r� z*Subpackage %r configuration returned as %r)r rk �insertrO r| �splitext�basenamer) r9 r7 rl rj r� r� ra r r9 r� �__code__� co_argcount) r< �setup_pyr� r� r� r� r� r� � setup_module�configZpnre r r r � _get_configuration_from_setup_py� s> � 292 293 �� 294 �� 295 �z.Configuration._get_configuration_from_setup_pyc C sL |du r|du r t d��tj�|�}|�d�}|du r)d|v r)| j|||d d�S d|vs6J t|||f���|du rCt| jg| �}nt|g|dd� �}| � |g�d }t|| j 296 �}| j d sntj� |�snt|d 297 | �}tj� |�s�| j d s�| � d tj�|�|f � t||| j||d d�}n | j|||||d d�}|r�|gS g S ) a Return list of subpackage configurations. 298 299 Parameters 300 ---------- 301 subpackage_name : str or None 302 Name of the subpackage to get the configuration. '*' in 303 subpackage_name is handled as a wildcard. 304 subpackage_path : str 305 If None, then the path is assumed to be the local path plus the 306 subpackage_name. If a setup.py file is not found in the 307 subpackage_path, then a default configuration is used. 308 parent_name : str 309 Parent name. 310 Nz;either subpackage_name or subpackage_path must be specifiedrx r� rn r� r� r rq z setup_%s.pyrr zEAssuming default configuration (%s/{setup_%s,setup}.py was not found))r� rO rk r� rj r� rr r, r� r� r� r� rC ra r| r r9 r� )r< r� r� r� r� r� r� r� r r r r� � sT � 311 � 312 � 313 ���z Configuration.get_subpackageFc C s� |rd}n| j }| j|||dd�}|s| �d� |D ]/}|}t|t�r'|�� }t|t�s4J tt|����| � d|� 314 d�| j f � | j di |�� q| � � }|dur[| �d| � dS dS ) a Add a sub-package to the current Configuration instance. 315 316 This is useful in a setup.py script for adding sub-packages to a 317 package. 318 319 Parameters 320 ---------- 321 subpackage_name : str 322 name of the subpackage 323 subpackage_path : str 324 if given, the subpackage path such as the subpackage is in 325 subpackage_path / subpackage_name. If None,the subpackage is 326 assumed to be located in the local path / subpackage_name. 327 standalone : bool 328 Nr\ r� z0No configuration returned, assuming unavailable.z Appending %s configuration to %sr9 zTdistutils distribution has been initialized, it may be too late to add a subpackage r ) r9 r� ra r r r� r� rr r� r� rV r rC ) r< r� r� � 329 standaloner� r� r� r 330 r[ r r r �add_subpackage s0 � 331 332 � 333 ��z Configuration.add_subpackagec 334 s� t |�r |\� }nd� t |�r� �fdd�|D � dS t|�s&td|f ��� du rBtj�|�r;��tj�|�|f�S ��||f�S �j|dd�}t |��rt � �r�t 335 � �� tj �}|� � ttt|�d ��}|� � |D ] }|| sw||= qn|D ]|}tj�|�s�td|� qzt|�j�}|� tj �}|� � g } d }|D ]9} 336 t | 337 �r�|t|�kr�td 338 � |f ��| �|| � n| 339 || ks�J t| 340 || |� ||f���| �| 341 � |d7 }q�||d� r��d ||f � | � � ��tj �| �|f� qzdS |D ] }��� |f� q�dS t � ��rJ t� ������ } | du�r%| jdu�r%| j} n�j} |D ] }tt |��D ]\} }tj��j � | �}| �||f� �q2�q*dS ) a� Recursively add files under data_path to data_files list. 342 343 Recursively add files under data_path to the list of data_files to be 344 installed (and distributed). The data_path can be either a relative 345 path-name, or an absolute path-name, or a 2-tuple where the first 346 argument shows where in the install directory the data directory 347 should be installed to. 348 349 Parameters 350 ---------- 351 data_path : seq or str 352 Argument can be either 353 354 * 2-sequence (<datadir suffix>, <path to data directory>) 355 * path to data directory where python datadir suffix defaults 356 to package dir. 357 358 Notes 359 ----- 360 Rules for installation paths:: 361 362 foo/bar -> (foo/bar, foo/bar) -> parent/foo/bar 363 (gun, foo/bar) -> parent/gun 364 foo/* -> (foo/a, foo/a), (foo/b, foo/b) -> parent/foo/a, parent/foo/b 365 (gun, foo/*) -> (gun, foo/a), (gun, foo/b) -> gun 366 (gun/*, foo/*) -> parent/gun/a, parent/gun/b 367 /foo/bar -> (bar, /foo/bar) -> parent/bar 368 (gun, /foo/bar) -> parent/gun 369 (fun/*/gun/*, sun/foo/bar) -> parent/fun/foo/gun/bar 370 371 Examples 372 -------- 373 For example suppose the source directory contains fun/foo.dat and 374 fun/bar/car.dat: 375 376 >>> self.add_data_dir('fun') #doctest: +SKIP 377 >>> self.add_data_dir(('sun', 'fun')) #doctest: +SKIP 378 >>> self.add_data_dir(('gun', '/full/path/to/fun'))#doctest: +SKIP 379 380 Will install data-files to the locations:: 381 382 <package install directory>/ 383 fun/ 384 foo.dat 385 bar/ 386 car.dat 387 sun/ 388 foo.dat 389 bar/ 390 car.dat 391 gun/ 392 foo.dat 393 car.dat 394 395 Nc s g | ] }�� � |f��qS r )� add_data_dirr� �r 396 r< r r r� k s z.Configuration.add_data_dir.<locals>.<listcomp>znot a string: %rF�r� rn zNot a directory, skippingr z cannot fill pattern %r with %rz,mismatch of pattern_list=%s and path_list=%s) r- r. r] rO rk �isabsr� r� r� r r rj rq �reverserc rd rN r& r� rv r� r� r� rr ra rl rC rg rH rv )r< � data_pathr� � pattern_list�rlrf rk rF � path_list� target_listr� r[ rg �d1r � target_pathr r� r r� . s| 8 397 398 � 399 �( 400 401 ����zConfiguration.add_data_dirc C s^ i }| j D ]\}}||vrt� ||< |D ] }|| �|� qqdd� |�� D �| j d d �< d S )Nc S s g | ] 402 \}}|t |�f�qS r )rc )rJ r� rG r r r r� � rD z6Configuration._optimize_data_files.<locals>.<listcomp>)rg �set�addr� )r< � data_dictr� rG r r r r r� � s 403 � z"Configuration._optimize_data_filesc G s t |�dkr|D ]}| �|� qdS t |�dksJ �t|d �r'|d \}}nd}t|�r0|}n%t|�rMt |�dkr?|d }n|D ] }| �||f� qAdS ttt|����|du ryt|d�rad}ntj � 404 |�rjd}ntj � |�}| �||f� dS | j |dd�}t |�r�t |�r�|�tj�}|�� |D ]=}|�tj�}|�� |�� g } d} 405 |D ]} t | �r�| �|| 406 � | 407 d7 } 408 q�| �| � q�| �� | �tj�| �|f� q�dS | �||f� dS t |�r�J t||f���| �� } | dur�| jdur�| j} n| j} | �tj �| j|�|f� dS )a� Add data files to configuration data_files. 409 410 Parameters 411 ---------- 412 files : sequence 413 Argument(s) can be either 414 415 * 2-sequence (<datadir prefix>,<path to data file(s)>) 416 * paths to data files where python datadir prefix defaults 417 to package dir. 418 419 Notes 420 ----- 421 The form of each element of the files sequence is very flexible 422 allowing many combinations of where to get the files from the package 423 and where they should ultimately be installed on the system. The most 424 basic usage is for an element of the files argument sequence to be a 425 simple filename. This will cause that file from the local path to be 426 installed to the installation path of the self.name package (package 427 path). The file argument can also be a relative path in which case the 428 entire relative path will be installed into the package directory. 429 Finally, the file can be an absolute path name in which case the file 430 will be found at the absolute path name but installed to the package 431 path. 432 433 This basic behavior can be augmented by passing a 2-tuple in as the 434 file argument. The first element of the tuple should specify the 435 relative path (under the package install directory) where the 436 remaining sequence of files should be installed to (it has nothing to 437 do with the file-names in the source distribution). The second element 438 of the tuple is the sequence of files that should be installed. The 439 files in this sequence can be filenames, relative paths, or absolute 440 paths. For absolute paths the file will be installed in the top-level 441 package installation directory (regardless of the first argument). 442 Filenames and relative path names will be installed in the package 443 install directory under the path name given as the first element of 444 the tuple. 445 446 Rules for installation paths: 447 448 #. file.txt -> (., file.txt)-> parent/file.txt 449 #. foo/file.txt -> (foo, foo/file.txt) -> parent/foo/file.txt 450 #. /foo/bar/file.txt -> (., /foo/bar/file.txt) -> parent/file.txt 451 #. ``*``.txt -> parent/a.txt, parent/b.txt 452 #. foo/``*``.txt`` -> parent/foo/a.txt, parent/foo/b.txt 453 #. ``*/*.txt`` -> (``*``, ``*``/``*``.txt) -> parent/c/a.txt, parent/d/b.txt 454 #. (sun, file.txt) -> parent/sun/file.txt 455 #. (sun, bar/file.txt) -> parent/sun/file.txt 456 #. (sun, /foo/bar/file.txt) -> parent/sun/file.txt 457 #. (sun, ``*``.txt) -> parent/sun/a.txt, parent/sun/b.txt 458 #. (sun, bar/``*``.txt) -> parent/sun/a.txt, parent/sun/b.txt 459 #. (sun/``*``, ``*``/``*``.txt) -> parent/sun/c/a.txt, parent/d/b.txt 460 461 An additional feature is that the path to a data-file can actually be 462 a function that takes no arguments and returns the actual path(s) to 463 the data-files. This is useful when the data files are generated while 464 building the package. 465 466 Examples 467 -------- 468 Add files to the list of data_files to be included with the package. 469 470 >>> self.add_data_files('foo.dat', 471 ... ('fun', ['gun.dat', 'nun/pun.dat', '/tmp/sun.dat']), 472 ... 'bar/cat.dat', 473 ... '/full/path/to/can.dat') #doctest: +SKIP 474 475 will install these data files to:: 476 477 <package install directory>/ 478 foo.dat 479 fun/ 480 gun.dat 481 nun/ 482 pun.dat 483 sun.dat 484 bar/ 485 car.dat 486 can.dat 487 488 where <package install directory> is the package (or sub-package) 489 directory such as '/usr/lib/python2.4/site-packages/mypackage' ('C: 490 \Python2.4 \Lib \site-packages \mypackage') or 491 '/usr/lib/python2.4/site- packages/mypackage/mysubpackage' ('C: 492 \Python2.4 \Lib \site-packages \mypackage \mysubpackage'). 493 rn Nr r\ rm Fr� )rN �add_data_filesr- r. r] rr r� r� rO rk r� r| r� r rj rq r� �popr� rl rC rg rv )r< rG r r 494 Zfilepatr� r� rk r� r� rf r� r[ rg r r r r� � sh X 495 496 497 � z Configuration.add_data_filesc C s@ | � � }|durt|d�sg |_|j�|� dS | j�|� dS )z�Add define macros to configuration 498 499 Add the given sequence of macro name and value duples to the beginning 500 of the define_macros list This list will be visible to all extension 501 modules of the current package. 502 Nrl )rC r� rl r� )r< �macrosr[ r r r �add_define_macrosI s 503 z Configuration.add_define_macrosc G �J | � |�}| �� }|dur |jdu rg |_|j�|� dS | j�|� dS )z�Add paths to configuration include directories. 504 505 Add the given sequence of paths to the beginning of the include_dirs 506 list. This list will be visible to all extension modules of the 507 current package. 508 N)r� rC rh r� )r< r� rh r[ r r r �add_include_dirsY � 509 510 z Configuration.add_include_dirsc s� g � |D ]6�t ��r� �fdd�����D � qt�ttf�r%t��dkr+tt����� �fdd����d �D � q��� }|durS|j du rKg |_ |j � 511 � � dS �j � 512 � � dS )a� Add installable headers to configuration. 513 514 Add the given sequence of files to the beginning of the headers list. 515 By default, headers will be installed under <python- 516 include>/<self.name.replace('.','/')>/ directory. If an item of files 517 is a tuple, then its first argument specifies the actual installation 518 location relative to the <python-include> path. 519 520 Parameters 521 ---------- 522 files : str or seq 523 Argument(s) can be either: 524 525 * 2-sequence (<includedir suffix>,<path to header file(s)>) 526 * path(s) to header file(s) where python includedir suffix will 527 default to package name. 528 c s g | ] 529 }� � �j|f��qS r )r� r9 r� )r r< r r r� ~ rD z-Configuration.add_headers.<locals>.<listcomp>r\ c s g | ] }� � �d |f��qS �r )r� r� )r rk r r r� � s rn N) r. r� r �tuplerc rN r] rr rC r r� )r< rG r[ r )r rk r< r � add_headersi s 530 zConfiguration.add_headersc O s |� dd�}t|| j|d�S )a� Apply glob to paths and prepend local_path if needed. 531 532 Applies glob.glob(...) to each path in the sequence (if needed) and 533 pre-pends the local_path if needed. Because this is called on all 534 source lists, this allows wildcard characters to be specified in lists 535 of sources for extension modules and libraries and scripts and allows 536 path-names be relative to the source directory. 537 538 r� T)r� r� )rV r0 r� )r< r� �kwsr� r r r r� � s 539 540 �zConfiguration.pathsc C s4 |� � D ]}|| }|dv r| �|�}|||< qd S )N)r rL rh � library_dirs� module_dirs� extra_objects)r r� )r< �kw�kr� �new_vr r r �_fix_paths_dict� s 541 ��z Configuration._fix_paths_dictc K s� t � |�}t| j|�|d< ||d< d|v r<|d }|d= t|t�r$|g}|D ]}t|t�s3J t|���t|fi |�� q&| �|� |�dg �}g }g |d< |D ]k} t| t �r]| �| d � d| v r�| � 542 dd�\} 543 } t j � t| j| ��} t j �| �r�| jd| dd �} t| t�r�| �� } d 544 d � | �dg �D �D ] } | � 545 d d�d }|| 546 kr�| �dd� t|fi | �� nq�qO|�| � qO||d |d< | j|�dg � |d< d dlm} |di |��}| j�|� | �� }|dur�| �d| � |S )a� Add extension to configuration. 547 548 Create and add an Extension instance to the ext_modules list. This 549 method also takes the following optional keyword arguments that are 550 passed on to the Extension constructor. 551 552 Parameters 553 ---------- 554 name : str 555 name of the extension 556 sources : seq 557 list of the sources. The list of sources may contain functions 558 (called source generators) which must take an extension instance 559 and a build directory as inputs and return a source file or list of 560 source files or None. If None is returned then no sources are 561 generated. If the Extension instance has no sources after 562 processing all source generators, then no extension module is 563 built. 564 include_dirs : 565 define_macros : 566 undef_macros : 567 library_dirs : 568 libraries : 569 runtime_library_dirs : 570 extra_objects : 571 extra_compile_args : 572 extra_link_args : 573 extra_f77_compile_args : 574 extra_f90_compile_args : 575 export_symbols : 576 swig_opts : 577 depends : 578 The depends list contains paths to files or directories that the 579 sources of the extension module depend on. If any path in the 580 depends list is newer than the extension module, then the module 581 will be rebuilt. 582 language : 583 f2py_options : 584 module_dirs : 585 extra_info : dict or list 586 dict or list of dict of keywords to be appended to keywords. 587 588 Notes 589 ----- 590 The self.paths(...) method is applied to all lists that may contain 591 paths. 592 r9 r � 593 extra_infori rn �@Nr\ r� c S s g | ]}|d �qS r� r )rJ r� r r r r� � r� z/Configuration.add_extension.<locals>.<listcomp>Z__OF__r rl �� ExtensionzTdistutils distribution has been initialized, it may be too late to add an extension r ) r{ r) r9 r r� rr r r� rV r� rj rO rk rp r, r� r& r� r r� r� r� rl rM r� rf rC ra )r< r9 r r� �ext_argsr� r� ri �libnames�libname�lnameZlpathr( r� Zllnamer� rM r[ r r r � add_extension� s` 594 0 595 596 597 � 598 � � �zConfiguration.add_extensionc K s6 | � ||d|� | �� }|dur| �d| � dS dS )a� 599 Add library to configuration. 600 601 Parameters 602 ---------- 603 name : str 604 Name of the extension. 605 sources : sequence 606 List of the sources. The list of sources may contain functions 607 (called source generators) which must take an extension instance 608 and a build directory as inputs and return a source file or list of 609 source files or None. If None is returned then no sources are 610 generated. If the Extension instance has no sources after 611 processing all source generators, then no extension module is 612 built. 613 build_info : dict, optional 614 The following keys are allowed: 615 616 * depends 617 * macros 618 * include_dirs 619 * extra_compiler_args 620 * extra_f77_compile_args 621 * extra_f90_compile_args 622 * f2py_options 623 * language 624 625 NzQdistutils distribution has been initialized, it may be too late to add a library )� _add_libraryrC ra )r< r9 r r: r[ r r r � add_library s 626 ��zConfiguration.add_libraryc C s@ t � |�}||d< d|vrg |d< | �|� | j�||f� dS )z\Common implementation for add_library and add_installed_library. Do 627 not use directlyr rL N)r{ r� ri r� �r< r9 r � install_dirr: r r r r� - s 628 629 zConfiguration._add_libraryc C s@ |si }t j�| j|�}| �||||� | j�t|||�� dS )aQ 630 Similar to add_library, but the specified library is installed. 631 632 Most C libraries used with `distutils` are only used to build python 633 extensions, but libraries built through this method will be installed 634 so that they can be reused by third-party packages. 635 636 Parameters 637 ---------- 638 name : str 639 Name of the installed library. 640 sources : sequence 641 List of the library's source files. See `add_library` for details. 642 install_dir : str 643 Path to install the library, relative to the current sub-package. 644 build_info : dict, optional 645 The following keys are allowed: 646 647 * depends 648 * macros 649 * include_dirs 650 * extra_compiler_args 651 * extra_f77_compile_args 652 * extra_f90_compile_args 653 * f2py_options 654 * language 655 656 Returns 657 ------- 658 None 659 660 See Also 661 -------- 662 add_library, add_npy_pkg_config, get_info 663 664 Notes 665 ----- 666 The best way to encode the options required to link against the specified 667 C libraries is to use a "libname.ini" file, and use `get_info` to 668 retrieve the required options (see `add_npy_pkg_config` for more 669 information). 670 671 N)rO rk rl ru r� rk r� r8 r� r r r �add_installed_library= s 672 ,z#Configuration.add_installed_libraryc C s\ |du ri }t j�| j|�}| j| jv r"| j| j �|||f� dS |||fg| j| j< dS )a 673 Generate and install a npy-pkg config file from a template. 674 675 The config file generated from `template` is installed in the 676 given install directory, using `subst_dict` for variable substitution. 677 678 Parameters 679 ---------- 680 template : str 681 The path of the template, relatively to the current package path. 682 install_dir : str 683 Where to install the npy-pkg config file, relatively to the current 684 package path. 685 subst_dict : dict, optional 686 If given, any string of the form ``@key@`` will be replaced by 687 ``subst_dict[key]`` in the template file when installed. The install 688 prefix is always available through the variable ``@prefix@``, since the 689 install prefix is not easy to get reliably from setup.py. 690 691 See also 692 -------- 693 add_installed_library, get_info 694 695 Notes 696 ----- 697 This works for both standard installs and in-place builds, i.e. the 698 ``@prefix@`` refer to the source directory for in-place builds. 699 700 Examples 701 -------- 702 :: 703 704 config.add_npy_pkg_config('foo.ini.in', 'lib', {'foo': bar}) 705 706 Assuming the foo.ini.in file has the following content:: 707 708 [meta] 709 Name=@foo@ 710 Version=1.0 711 Description=dummy description 712 713 [default] 714 Cflags=-I@prefix@/include 715 Libs= 716 717 The generated file will have the following content:: 718 719 [meta] 720 Name=bar 721 Version=1.0 722 Description=dummy description 723 724 [default] 725 Cflags=-Iprefix_dir/include 726 Libs= 727 728 and will be installed as foo.ini in the 'lib' subpath. 729 730 When cross-compiling with numpy distutils, it might be necessary to 731 use modified npy-pkg-config files. Using the default/generated files 732 will link with the host libraries (i.e. libnpymath.a). For 733 cross-compilation you of-course need to link with target libraries, 734 while using the host Python installation. 735 736 You can copy out the numpy/core/lib/npy-pkg-config directory, add a 737 pkgdir value to the .ini files and set NPY_PKG_CONFIG_PATH environment 738 variable to point to the directory with the modified npy-pkg-config 739 files. 740 741 Example npymath.ini modified for cross-compilation:: 742 743 [meta] 744 Name=npymath 745 Description=Portable, core math library implementing C99 standard 746 Version=0.1 747 748 [variables] 749 pkgname=numpy.core 750 pkgdir=/build/arm-linux-gnueabi/sysroot/usr/lib/python3.7/site-packages/numpy/core 751 prefix=${pkgdir} 752 libdir=${prefix}/lib 753 includedir=${prefix}/include 754 755 [default] 756 Libs=-L${libdir} -lnpymath 757 Cflags=-I${includedir} 758 Requires=mlib 759 760 [msvc] 761 Libs=/LIBPATH:${libdir} npymath.lib 762 Cflags=/INCLUDE:${includedir} 763 Requires=mlib 764 765 N)rO rk rl ru r9 rn r� )r< �templater� � 766 subst_dictr r r �add_npy_pkg_configp s _ 767 ��z Configuration.add_npy_pkg_configc G r� )z�Add scripts to configuration. 768 769 Add the sequence of files to the beginning of the scripts list. 770 Scripts will be installed under the <prefix>/bin/ directory. 771 772 N)r� rC rN r� )r< rG rN r[ r r r � add_scripts� r� zConfiguration.add_scriptsc 773 K s | j D ]}t| |�}|�|�|g �� q| jD ]}t| |�}|�|�|i �� q| j | j | j }|�� D ]S}||vrit| |d �}|rJ||| krJq5| �d||| |�dd�f � t | ||| � | j� 774 |� q5|| jv r~| � d|t| |�|| f � q5||v r�q5t d| ��d S )Nz"Inheriting attribute %r=%r from %rr9 r� z*Ignoring attempt to set %r (from %r to %r)zDon't know about key=%r) rx rW r� rV rz �updater~ r ra r| r� r� r� )r< r� r� rg r� r r r r � s0 775 776 777 778 � 779 � �zConfiguration.dict_appendc C sv ddl m} | j| j | j }d}|d| j d 7 }|�� |D ]}t| |d �}|r4|d|||�f 7 }q |d7 }|S )Nr )�pformatz<----- 780 zConfiguration of z: 781 z%s = %s 782 z----->)�pprintr� rx rz r~ r9 �sortrW )r< r� r� r� r� rg r r r �__str__ s �zConfiguration.__str__c C sJ t d�}|�� d|_d|_tj�d�}|r#tj�d|g�}|tjd< |S )zF 783 Returns the numpy.distutils config command instance. 784 r� r �PATHrx ) r �ensure_finalized� dump_source�noisyrO rU rV �pathseprl )r< �cmd�old_pathrk r r r �get_config_cmd s 785 z Configuration.get_config_cmdc C s t d�}|�� |jS )zh 786 Return a path to a temporary directory where temporary files should be 787 placed. 788 rE )r r� � 789 build_temp)r< r� r r r �get_build_temp_dir s z Configuration.get_build_temp_dirc C � d}| � � }|j|dd�}|S )aS Check for availability of Fortran 77 compiler. 790 791 Use it inside source generating function to ensure that 792 setup distribution instance has been initialized. 793 794 Notes 795 ----- 796 True if a Fortran 77 compiler is available (because a simple Fortran 77 797 code was able to be compiled successfully). 798 �/ 799 subroutine simple 800 end 801 r ��lang�r� � try_compile�r< Zsimple_fortran_subroutine� 802 config_cmd�flagr r r � have_f77c( � zConfiguration.have_f77cc C r� )aR Check for availability of Fortran 90 compiler. 803 804 Use it inside source generating function to ensure that 805 setup distribution instance has been initialized. 806 807 Notes 808 ----- 809 True if a Fortran 90 compiler is available (because a simple Fortran 810 90 code was able to be compiled successfully) 811 r� r r� r� r� r r r � have_f90c; r� zConfiguration.have_f90cc C sh t |�r|\}}t|| j| jd� dS ddlm} t||�s$J t|���|j�| j� |j�| j� dS )zEAppend libraries, include_dirs to extension or library item. 812 )ri rh r r� N) r- r ri rh rM r� r rr r� )r< Zextlib�lib_namer: r� r r r � append_toN s 813 � zConfiguration.append_toc C s z 814 t jdg|d�}W n t jtfy Y nw t�d|�}|r&t|�d��S tj dkr9t 815 j � dd�r9t |dd �}nt |d 816 d �}t 817 j�|�r�t|�� }|�� }W d � n1 sXw Y |dd � d krvt�d |�}|rtt|�d��S dS t�d|�}|r�t|�d��S dS )z+Return path's SVN revision number. 818 Z 819 svnversion��cwd� (?P<revision>\d+)�revisionr� ZSVN_ASP_DOT_NET_HACKNZ_svn�entriesr, r� z<?xmlz revision="(?P<revision>\d+)"zdir[\n\r]+(?P<revision>\d+))r� r� �CalledProcessErrorr r5 �matchrT r r r� rO rU rV r, rk rC r� �readr8 )r< rk �outputr r� r Zfstrr r r �_get_svn_revision\ s0 � 820 821 � �z Configuration._get_svn_revisionc 822 C s8 z t jg d�|d�}W n t jtfy Y nw t�d|�}|r't|�d��S t|dd�}t|dd�}t j 823 � |�r�d}t |��}|� � �� }W d � n1 sPw Y i } t |d ��1}|D ]&} 824 | 825 �� dd 826 � \} } | |krq| }zt| �} W n ty� Y q_w | | | < q_W d � n1 s�w Y | �|�S dS ) z1Return path's Mercurial revision number. 827 )�hg�identifyz--numr� r� r� z.hg�branchz branch.cacheNr� r\ )r� r� r� r r5 r� rT r r, rO rk rC r� r� r� rj r� rV ) r< rk r r Z branch_fnZbranch_cache_fnZbranch0r Z revision0Z 828 branch_mapr� Zbranch1Z revision1r r r �_get_hg_revisiony sB 829 �� 830 � � 831 � � 832 z Configuration._get_hg_revisionc C s� t | dd�}|dur |S |du r d| j�d�d d ddd g}n|g}|du r5dd 833 | j�d�d d g}n|g}|D ]y}t| j|�}tj�|�r�d }tj�tj� |��d } t 834 | j| �} 835 z t d� | 836 �d��|�} W n t y� } z| �t| �� d} W Y d} ~ nd} ~ ww | du r�q:|D ]} t | | d�}|dur� nq�z| �� d }W n ty� Y nw |dur� nq:|dur�|| _|S | �| j�}|du r�| �| j�}|dur�t|�}|| _|S )a� Try to get version string of a package. 837 838 Return a version string of the current package or None if the version 839 information could not be detected. 840 841 Notes 842 ----- 843 This method scans files named 844 __version__.py, <packagename>_version.py, version.py, and 845 __svn_version__.py for string variables version, __version__, and 846 <packagename>_version, until a version number is found. 847 r� Nz__version__.pyrx r� z _version.pyz 848 version.py�__svn_version__.py�__hg_version__.py� __version__�_version)z.py�Urn r rd )rW r9 rj r, r� rO rk rC r� r� r) r7 rl � ImportErrorra r� � get_versionsrP r� r r )r< Z version_fileZversion_variabler� rG Z version_varsr r� r� r9 r� �version_module�erg r� r r r � get_version� sr �� ��� � �� zConfiguration.get_versionTc �V t �jd�����j��tj���s�du rdS � ���fdd�}��d|� f� dS )a Appends a data function to the data_files list that will generate 849 __svn_version__.py file to the current package directory. 850 851 Generate package __svn_version__.py file from SVN revision number, 852 it will be removed after python exits but will be available 853 when sdist, etc commands are executed. 854 855 Notes 856 ----- 857 If __svn_version__.py existed before, nothing is done. 858 859 This is 860 intended for working with source directories that are in an SVN 861 repository. 862 r Nc � t j���s/t��} ��d�| f � t�d��}|�d| � W d � n1 s*w Y ��jf� fdd� }t�|� �S )N�Creating %s (version=%r)r� � version = %r 863 c �p � r6z t �| � |d| � W n ty Y nw zt �| d � |d| d � W d S ty5 Y d S w d S �Nzremoved r( �rO �remover �r r� ��deleter r �rm_file � &�zSConfiguration.make_svn_version_py.<locals>.generate_svn_version_py.<locals>.rm_file� rO rk rC r� r� r� r� �atexit�register�r� r r �r r� r< �targetr r �generate_svn_version_py � � 864 zBConfiguration.make_svn_version_py.<locals>.generate_svn_version_pyrm )r, r� r rO rk rC r� )r< r r# r r! r �make_svn_version_py� s z!Configuration.make_svn_version_pyc r )a Appends a data function to the data_files list that will generate 865 __hg_version__.py file to the current package directory. 866 867 Generate package __hg_version__.py file from Mercurial revision, 868 it will be removed after python exits but will be available 869 when sdist, etc commands are executed. 870 871 Notes 872 ----- 873 If __hg_version__.py existed before, nothing is done. 874 875 This is intended for working with source directories that are 876 in an Mercurial repository. 877 r Nc r )Nr r� r c r r r r r r r r / r zQConfiguration.make_hg_version_py.<locals>.generate_hg_version_py.<locals>.rm_filer r r! r r �generate_hg_version_py( r$ z@Configuration.make_hg_version_py.<locals>.generate_hg_version_pyrm )r, r� r rO rk rC r� )r< r r& r r! r �make_hg_version_py s z Configuration.make_hg_version_py� 878 __config__c C s | j �| j|tf� dS )z�Generate package __config__.py file containing system_info 879 information used during building the package. 880 881 This file is installed to the 882 package installation directory. 883 884 N)rj r� r9 r )r< r9 r r r �make_config_py< s z Configuration.make_config_pyc G s6 ddl m}m} i }|D ] }||fi ||��� q |S )z�Get resources information. 885 886 Return information (from system_info.get_info) for all of the names in 887 the argument list in a single dictionary. 888 rn )r3 r )� system_infor3 r )r< �namesr3 r � info_dictrg r r r r3 F s 889 zConfiguration.get_info)NNNNrn ro )rn )NNrn )NFr �NN)T)r( )-r> r? r@ rw ry r} �numpy_include_dirsr= r� r� ra r� rC r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r� r� r� r� r� r� r r r r% r' r) r3 r r r r r � sr 890 �a 891 � 892 �" 893 �> 894 �+y "g$ 895 896 3k 897 & 898 L 899 ) 900 ( 901 r c C sN | |vr#dd l }|jj}|d u rddlm} |d��|�| �}||| < || S )Nr )�DistutilsInternalErrorz+setup distribution instance not initialized)�distutils.core�core�_setup_distribution�distutils.errorsr/ rX )�cmdname�_cacherV r[ r/ r� r r r r S s � 902 r c C s( t jd d � } | sdd l}|�� g} | S )Nr )r r. �numpy� get_include)rh r6 r r r r _ s 903 904 r c C sD t j�d�} | dur | S tj�d�}t j�t j�|j �ddd�} | S )a� Return the path where to find the npy-pkg-config directory. 905 906 If the NPY_PKG_CONFIG_PATH environment variable is set, the value of that 907 is returned. Otherwise, a path inside the location of the numpy module is 908 returned. 909 910 The NPY_PKG_CONFIG_PATH can be useful when cross-compiling, maintaining 911 customized npy-pkg-config .ini files for the cross-compilation 912 environment, and using them when cross-compiling. 913 914 �NPY_PKG_CONFIG_PATHNr6 r1 rO znpy-pkg-config) 915 rO rU rV � importlib�util� find_specrk rl r| �origin)r 916 �specr r r �get_npy_pkg_dirh s �r> c C s0 ddl m} |r|�t� � nt� g}|| |�S )a� 917 Return library info for the given package. 918 919 Parameters 920 ---------- 921 pkgname : str 922 Name of the package (should match the name of the .ini file, without 923 the extension, e.g. foo for the file foo.ini). 924 dirs : sequence, optional 925 If given, should be a sequence of additional directories where to look 926 for npy-pkg-config files. Those directories are searched prior to the 927 NumPy directory. 928 929 Returns 930 ------- 931 pkginfo : class instance 932 The `LibraryInfo` instance containing the build information. 933 934 Raises 935 ------ 936 PkgNotFound 937 If the package is not found. 938 939 See Also 940 -------- 941 Configuration.add_npy_pkg_config, Configuration.add_installed_library, 942 get_info 943 944 r )� read_config)� numpy.distutils.npy_pkg_configr? r� r> )�pkgnamer� r? r r r r4 | s 945 946 r4 c C sf ddl m} t| |�}||�� �}||�� ��� D ] \}}|| �|� q|d |d< |d= |d= |S )a9 947 Return an info dict for a given C library. 948 949 The info dict contains the necessary options to use the C library. 950 951 Parameters 952 ---------- 953 pkgname : str 954 Name of the package (should match the name of the .ini file, without 955 the extension, e.g. foo for the file foo.ini). 956 dirs : sequence, optional 957 If given, should be a sequence of additional directories where to look 958 for npy-pkg-config files. Those directories are searched prior to the 959 NumPy directory. 960 961 Returns 962 ------- 963 info : dict 964 The dictionary with build information. 965 966 Raises 967 ------ 968 PkgNotFound 969 If the package is not found. 970 971 See Also 972 -------- 973 Configuration.add_npy_pkg_config, Configuration.add_installed_library, 974 get_pkg_info 975 976 Examples 977 -------- 978 To get the necessary information for the npymath library from NumPy: 979 980 >>> npymath_info = np.distutils.misc_util.get_info('npymath') 981 >>> npymath_info #doctest: +SKIP 982 {'define_macros': [], 'libraries': ['npymath'], 'library_dirs': 983 ['.../numpy/core/lib'], 'include_dirs': ['.../numpy/core/include']} 984 985 This info dict can then be used as input to a `Configuration` instance:: 986 987 config.add_extension('foo', sources=['foo.c'], extra_info=npymath_info) 988 989 r )� parse_flagsr� rl �ignored)r@ rB r4 �cflags�libsr� r� )rA r� rB �pkg_infor� r� r� r r r r3 � s - 990 r3 c C s* dd l } z| j W dS ty Y dS w )Nr TF)�builtins�__NUMPY_SETUP__rP )rG r r r �is_bootstrapping� s �rI c C s: ddl }|jd| ||| ||f dd� t| ||�}|�� S )zqReturn a configuration dictionary for usage in 991 configuration() function defined in file setup_<name>.py. 992 r NzXUse Configuration(%r,%r,top_path=%r) instead of deprecated default_config_dict(%r,%r,%r)r\ r] )r` ra r r� )r9 r� r� r` r( r r r r � s ��� r c K sR |� � D ]"\}}|| v r"| | }t|t�r|| |< q| | �|� q|| |< qd S r )r� r r� r� )r 993 r� r� r� �ovr r r r � s 994 995 996 �r c C s( t jjdkr| �dt jj�} |�dt jj�}d}t j�|�r�t j�| �d }t j�t j�| ��d }t j�|�\}}t j�||g�}t j�|d t |�� |t |�d � �|kslt j�|d t |�� |t |�d � �|krrt j� 997 |�}|t |�d � }t j�|�r�|dd � }n|}t j� t || |��S )Nri rm r rn ) rO rk rq r� r� � 998 splitdriverp r$ rl rN r| �normpathr, )r� rk �driveZ absprefixZ pathdriver 999 �subpathr r r r s$ ** �r c C s� ddl m} ddlm} |tj�| �� t| d��D}|�dtj� t 1000 j d � � |�d� |�d� |�t � d�� |j�� D ] \}}|�d ||f � q?|�t � d 1001 �� W d � | S 1 s`w Y | S ) z�Generate config.py file containing system_info information 1002 used during building the package. 1003 1004 Usage: 1005 config['py_modules'].append((packagename, '__config__',generate_config_py)) 1006 r )r* )�mkpathr� z'# This file is generated by numpy's %s 1007 zH# It contains system_info results at the time of building this package. 1008 z __all__ = ["get_info","show"] 1009 1010 a 1011 import os 1012 import sys 1013 1014 extra_dll_dir = os.path.join(os.path.dirname(__file__), '.libs') 1015 1016 if sys.platform == 'win32' and os.path.isdir(extra_dll_dir): 1017 os.add_dll_directory(extra_dll_dir) 1018 1019 z%s=%r 1020 a} 1021 def get_info(name): 1022 g = globals() 1023 return g.get(name, g.get(name + "_info", {})) 1024 1025 def show(): 1026 """ 1027 Show libraries in the system on which NumPy was built. 1028 1029 Print information about various resources (libraries, library 1030 directories, include directories, etc.) in the system on which 1031 NumPy was built. 1032 1033 See Also 1034 -------- 1035 get_include : Returns the directory containing NumPy C 1036 header files. 1037 1038 Notes 1039 ----- 1040 1. Classes specifying the information to be printed are defined 1041 in the `numpy.distutils.system_info` module. 1042 1043 Information may include: 1044 1045 * ``language``: language used to write the libraries (mostly 1046 C or f77) 1047 * ``libraries``: names of libraries found in the system 1048 * ``library_dirs``: directories containing the libraries 1049 * ``include_dirs``: directories containing library header files 1050 * ``src_dirs``: directories containing library source files 1051 * ``define_macros``: preprocessor macros used by 1052 ``distutils.setup`` 1053 * ``baseline``: minimum CPU features required 1054 * ``found``: dispatched features supported in the system 1055 * ``not found``: dispatched features that are not supported 1056 in the system 1057 1058 2. NumPy BLAS/LAPACK Installation Notes 1059 1060 Installing a numpy wheel (``pip install numpy`` or force it 1061 via ``pip install numpy --only-binary :numpy: numpy``) includes 1062 an OpenBLAS implementation of the BLAS and LAPACK linear algebra 1063 APIs. In this case, ``library_dirs`` reports the original build 1064 time configuration as compiled with gcc/gfortran; at run time 1065 the OpenBLAS library is in 1066 ``site-packages/numpy.libs/`` (linux), or 1067 ``site-packages/numpy/.dylibs/`` (macOS), or 1068 ``site-packages/numpy/.libs/`` (windows). 1069 1070 Installing numpy from source 1071 (``pip install numpy --no-binary numpy``) searches for BLAS and 1072 LAPACK dynamic link libraries at build time as influenced by 1073 environment variables NPY_BLAS_LIBS, NPY_CBLAS_LIBS, and 1074 NPY_LAPACK_LIBS; or NPY_BLAS_ORDER and NPY_LAPACK_ORDER; 1075 or the optional file ``~/.numpy-site.cfg``. 1076 NumPy remembers those locations and expects to load the same 1077 libraries at run-time. 1078 In NumPy 1.21+ on macOS, 'accelerate' (Apple's Accelerate BLAS 1079 library) is in the default build-time search order after 1080 'openblas'. 1081 1082 Examples 1083 -------- 1084 >>> import numpy as np 1085 >>> np.show_config() 1086 blas_opt_info: 1087 language = c 1088 define_macros = [('HAVE_CBLAS', None)] 1089 libraries = ['openblas', 'openblas'] 1090 library_dirs = ['/usr/local/lib'] 1091 """ 1092 from numpy.core._multiarray_umath import ( 1093 __cpu_features__, __cpu_baseline__, __cpu_dispatch__ 1094 ) 1095 for name,info_dict in globals().items(): 1096 if name[0] == "_" or type(info_dict) is not type({}): continue 1097 print(name + ":") 1098 if not info_dict: 1099 print(" NOT AVAILABLE") 1100 for k,v in info_dict.items(): 1101 v = str(v) 1102 if k == "sources" and len(v) > 200: 1103 v = v[:60] + " ...\n... " + v[-60:] 1104 print(" %s = %s" % (k,v)) 1105 1106 features_found, features_not_found = [], [] 1107 for feature in __cpu_dispatch__: 1108 if __cpu_features__[feature]: 1109 features_found.append(feature) 1110 else: 1111 features_not_found.append(feature) 1112 1113 print("Supported SIMD extensions in this NumPy install:") 1114 print(" baseline = %s" % (','.join(__cpu_baseline__))) 1115 print(" found = %s" % (','.join(features_found))) 1116 print(" not found = %s" % (','.join(features_not_found))) 1117 1118 N)�numpy.distutils.system_infor* �distutils.dir_utilrO rO rk r| r� r� r� r �argv�textwrap�dedent� saved_resultsr� )r" r* rO r r� rf r r r r s 1119 1120 1121 �w�wr c C s | j dks td| j ��| jS )zdReturn version major and minor of compiler instance if it is 1122 MSVC, raise an exception otherwise.�msvcz"Compiler instance is not msvc (%s))� compiler_typer� �_MSVCCompiler__version)�compilerr r r � msvc_version� s 1123 1124 �rZ c C s ddl m} | � S )Nr �r2 )�distutils.msvccompilerr2 r[ r r r r2 � s r2 z%-Werror=implicit-function-declarationz-std=c99c C s dd� | D �S )z= 1125 Some flags are valid for C but not C++. Prune them. 1126 c S s g | ]}|t vr|�qS r )�_cxx_ignore_flags)rJ r� r r r r� � r4 z&sanitize_cxx_flags.<locals>.<listcomp>r )Zcxxflagsr r r r6 � s r6 c C s* t j�| |�}t j�|�}|j�|� |S )z� 1127 Use importlib machinery to import a module `modname` from the file 1128 `modfile`. Depending on the `spec.loader`, the module may not be 1129 registered in sys.modules. 1130 )r9 r: �spec_from_file_location�module_from_spec�loader� exec_module)�modnameZmodfiler= �foor r r r7 � s r7 r )rm T)rm rm T)NNFr- )Fr� )NNN)frO r5 r r{ r� r r� r� r rQ rS �importlib.utilr9 � threadingr �tlocal� functoolsr rV r3 r r� r r r �__all__r8 r5 rh r rv r� r, r r+ r� r� r0 r� r r� r� r� r� r r r r r r� r r r� r� r� r6 �Ir� r r r� r� r r. r r- r r/ r1 r r! r" r r r# r# r$ r? rH r% r& r' r[ r( r) r* r r r r> r4 r3 rI r r r r rZ r2 r] r6 r7 r r r r �<module> s� 1131 $ 1132 1133 1134 % 1135 1136 1137 � 1138 % 1139 1140 1141 + 1142 f 1143 1144 &< 1145