a0bi< S r SSKrSSKrSSKrSSKrSSKrSSKJr SSKJ r SSK
J r J r J
r
SSKJrJrJrJr SSKJr SS KJr S
rS rS r " S
S\ 5 rg)a9 distutils.unixccompiler
Contains the UnixCCompiler class, a subclass of CCompiler that handles
the "typical" Unix-style command-line C compiler:
* macros defined with -Dname[=value]
* macros undefined with -Uname
* include search directories specified with -Idir
* libraries specified with -lllib
* library search directories specified with -Ldir
* compile handled by 'cc' (or similar) executable with -c option:
compiles .c to .o
* link static library handled by 'ar' command (possibly with 'ranlib')
* link shared library handled by 'cc -shared'
N ) sysconfig)newer) CCompilergen_preprocess_optionsgen_lib_options)DistutilsExecError CompileErrorLibError LinkError)log)compiler_fixupc Sn[ R R U S 5 S:X a SnSX ; a US-
nSX ; a M U SU XS 4$ )z
For macOS, split command into 'env' portion (if any)
and the rest of the linker command.
>>> _split_env(['a', 'b', 'c'])
([], ['a', 'b', 'c'])
>>> _split_env(['/usr/bin/env', 'A=3', 'gcc'])
(['/usr/bin/env', 'A=3'], ['gcc'])
r envr =Nospathbasenamecmdpivots ڜ/builddir/build/BUILDROOT/alt-python313-setuptools-69.0.2-3.el8.x86_64/opt/alt/python313/lib/python3.13/site-packages/setuptools/_distutils/unixccompiler.py
_split_envr - s]
E wwA 5(SZ QJE SZ v;F ## c ^ [ R R U S 5 S:H nU SU XS 4$ )z
AIX platforms prefix the compiler with the ld_so_aix
script, so split that from the linker command.
>>> _split_aix(['a', 'b', 'c'])
([], ['a', 'b', 'c'])
>>> _split_aix(['/bin/foo/ld_so_aix', 'gcc'])
(['/bin/foo/ld_so_aix'], ['gcc'])
r ld_so_aixNr r s r
_split_aixr ? s6
GG SV $ 3E v;F ##r c : [ U5 nU SU U:X a UOSnXS $ )a
The linker command usually begins with the compiler
command (possibly multiple elements), followed by zero or more
params for shared library building.
If the LDSHARED env variable overrides the linker command,
however, the commands may not match.
Return the best guess of the linker parameters by stripping
the linker command. If the compiler command does not
match the linker command, assume the linker command is
just the first element.
>>> _linker_params('gcc foo bar'.split(), ['gcc'])
['foo', 'bar']
>>> _linker_params('gcc foo bar'.split(), ['other'])
['foo', 'bar']
>>> _linker_params('ccache gcc foo bar'.split(), 'ccache gcc'.split())
['foo', 'bar']
>>> _linker_params(['gcc'], ['gcc'])
[]
Nr )len)
linker_cmd compiler_cmdc_lenr s r _linker_paramsr$ M s. .
E '<7EQE f r c 6 \ rS rSrSrSS/S/S/SS/S/SS/SS.r\R SS S
:X a S /\S ' / S QrS
r Sr
Sr Sr Sr
S=r=rr\r\R S:X a Sr S S jrS r S!S jr S"S jrS rS rS rS r\S 5 r S#S jr S r g)$
UnixCCompileri unixNccz-sharedarz-cr) preprocessorcompiler compiler_so compiler_cxx linker_so
linker_exearchiverranlib darwinr2 )z.cz.Cz.ccz.cxxz.cppz.mz.oz.az.soz.dylibz.tbdzlib%s%scygwinz.exec , U R S X45 nUu pn[ X45 n U R U - n
U( a U
R SU/5 U( a XZS S& U( a U
R U5 U
R U5 U R
=( d US L =( d [
X5 n U ( d g U( a. U R [ R R U5 5 U R U
5 g ! [ a n [ U 5 eS n A ff = f)N-or )_fix_compile_argsr r+ extendappendforcer mkpathr r dirnamespawnr r
)
selfsource output_filemacros include_dirs
extra_preargsextra_postargs
fixed_argsignorepp_optspp_args
preprocessmsgs
r rJ UnixCCompiler.preprocess s ++D&G
'1$ (>##g- NND+. / 'BQK NN> *v ZZT;$#6T%:T
KK 4 5 $ JJw ! $ s# # $s 'C9 9
D DDc [ U R XE- 5 n U R Xt- USU/- U- 5 g ! [ a n[ U5 eS nAff = f)Nr7 )r r- r> r r
) r? objsrcextcc_argsrE rH r- rK s r _compileUnixCCompiler._compile sW $T%5%5w7OP $ JJ{,T3/??.P Q! $ s# # $s 7
A A Ac U R X5 u pU R X#S9nU R X5 ( a U R [ R
R
U5 5 U R U R U/- U- U R - 5 U R ( a! U R U R U/- 5 g g [ R " SU5 g ! [ a n[ U5 eS nAff = f)N)
output_dirskipping %s (up-to-date))_fix_object_argslibrary_filename
_need_linkr< r r r= r> r1 objectsr2 r r r
debug)r? rZ output_libnamerU r[ target_langoutput_filenamerK s r create_static_lib UnixCCompiler.create_static_lib s # 3 3G H ///V ??7 4 4 KK8 9 JJt}}'887BT\\Q R {{(JJt{{o-> >?
II0/ B * ("3-'(s ( C! !
C;+ C66C;c , U R X$5 u p$U R XVU5 nUu pVn[ XXu5 n[ U[ [ S 5 45 ( d [
S5 eUb [ R R XC5 nU R X#5 ( GaF X R - U- SU/- nU ( a S/US S& U
( a U
US S& U ( a UR U 5 U R [ R R U5 5 U[ R :H nU( a U R" O U R$ S S nU
S:X at U R& ( ac [) U5 u nn[+ U5 u nn[) U R& 5 u nn[) U R" 5 u nn[- UU5 nUU- U- U- n[/ UU5 nU R1 UU- 5 g [6 R8 " SU5 g ! [2 a n[5 U5 eS nAff = f)Nz%'output_dir' must be a string or Noner7 z-gr zc++rV ) rW
_fix_lib_argsr
isinstancestrtype TypeErrorr r joinrY rZ r9 r< r= r
EXECUTABLEr0 r/ r. r r r$ r r> r r r
r[ ) r? target_descrZ r^ rU libraries library_dirsruntime_library_dirsexport_symbolsr[ rD rE
build_tempr] rF lib_optsld_args building_exelinkerr linker_neaix linker_na_compiler_cxx_ne
linker_exe_neparamsrK s r linkUnixCCompiler.link s # 3 3G H'' AUV
8B5 !5"47KW*sDJ&788 CD D ! ggll: GO ??7 4 4 ,x74 :QQG #f + ~. KK8 9
% +i.B.B B -9$//t~~qQ %'D,=,=%/%7NC%/ %:NC)3D4E4E)F&A'1$//'B$A} +I} EF 3Y 86 AF'8
6G+,
II0/ B &
% n$
%s CG9 9
H HHc SU- $ )N-L )r? dirs r library_dir_option UnixCCompiler.library_dir_option czr c [ R " S5 n[ R R [
R " U5 S 5 nSU; =( d SU; $ )NCCr gcczg++)r get_config_varr r r shlexsplit)r? cc_varr, s r _is_gccUnixCCompiler._is_gcc sI ))$/77##EKK$7$:; 5EX$55r c v [ R S S S:X a. SSKJnJn U" 5 nU( a U" U5 SS/: a SU- $ SU- $ [ R S S S
:X a S U- $ [ R S S S :X a U R 5 ( a S
OSSU- /$ [ R " S5 S:X a SU- $ SU- $ )Nr3 r4 r )get_macosx_target_ver
split_version
z -Wl,-rpath,r} freebsdz -Wl,-rpath=zhp-uxz-Wl,+sz+sGNULDyesz-Wl,--enable-new-dtags,-Rz-Wl,-R)sysplatformdistutils.utilr r r r r )r? r r r macosx_target_vers r runtime_library_dir_option(UnixCCompiler.runtime_library_dir_option s << x ' K 5 7 ]3D%E"a%P$s**cz!
\\"1
* 3& &
\\"1
( LLNNs
# #G , 5 /4 4c> !r c SU- $ )Nz-lr~ )r? libs r library_option UnixCCompiler.library_optionD r r c [ R " S5 n[ R " SU5 n[ R
S:H =( aO U=( aF U R
S5 =( d. U R
S5 =( a U R
S5 ( + nU( a2 [ R R UR S5 U SS 5 $ U $ ) a(
macOS users can specify an alternate SDK using'-isysroot'.
Calculate the SDK root if it is specified.
Note that, as of Xcode 7, Apple SDKs may contain textual stub
libraries with .tbd extensions rather than the normal .dylib
shared libraries installed in /. The Apple compiler tool
chain handles this transparently but it can cause problems
for programs that are being built with an SDK and searching
for specific libraries. Callers of find_library_file need to
keep in mind that the base filename of the returned SDK library
file might have a different extension from that of the library
file installed on the running system, for example:
/Applications/Xcode.app/Contents/Developer/Platforms/
MacOSX.platform/Developer/SDKs/MacOSX10.11.sdk/
usr/lib/libedit.tbd
vs
/usr/lib/libedit.dylib
CFLAGSz-isysroot\s*(\S+)r4 z/System/z/usr/z /usr/local/r N) r r researchr r
startswithr r rg group)r cflagsmatch
apply_roots r
_library_rootUnixCCompiler._library_rootG s * ))(3 .7
LLH $
z* SNN7+QCNN=4Q0Q 9Crww||EKKNCG4KKr c ^ ^ UU 4S jSR 5 5 n[ T R U5 nS [ R " XT5 5 n[ [ R R U5 n[ US5 $ )a
Second-guess the linker with not much hard
data to go on: GCC seems to prefer the shared library, so
assume that *all* Unix C compilers do,
ignoring even GCC's "-static" option.
>>> compiler = UnixCCompiler()
>>> compiler._library_root = lambda dir: dir
>>> monkeypatch = getfixture('monkeypatch')
>>> monkeypatch.setattr(os.path, 'exists', lambda d: 'existing' in d)
>>> dirs = ('/foo/bar/missing', '/foo/bar/existing')
>>> compiler.find_library_file(dirs, 'abc').replace('\\', '/')
'/foo/bar/existing/libabc.dylib'
>>> compiler.find_library_file(reversed(dirs), 'abc').replace('\\', '/')
'/foo/bar/existing/libabc.dylib'
>>> monkeypatch.setattr(os.path, 'exists',
... lambda d: 'existing' in d and '.a' in d)
>>> compiler.find_library_file(dirs, 'abc').replace('\\', '/')
'/foo/bar/existing/libabc.a'
>>> compiler.find_library_file(reversed(dirs), 'abc').replace('\\', '/')
'/foo/bar/existing/libabc.a'
c 3 D ># U H nTR TUS 9v M g7f))lib_typeN)rX ).0re r r? s r 2UnixCCompiler.find_library_file.. s(
@
! !# ! 5@s z dylib xcode_stub shared staticc 3 d # U H& u p[ R R X5 v M( g 7f)N)r r rg )r rootlib_names r r r s)
"E
GGLL ( ("Es .0N)
r mapr itertoolsproductfilterr r existsnext)r? dirsr r[ lib_namesrootssearchedfounds ` ` r find_library_file UnixCCompiler.find_library_filej sn .
8>>@
D&&-
"+"3"3E"E
rww~~x0 E4 r r~ )NNNNN)Nr N)
NNNNNr NNNN)r ) __name__
__module__ __qualname____firstlineno__
compiler_type executablesr r src_extensions
obj_extensionstatic_lib_extensionshared_lib_extensiondylib_lib_extensionxcode_stub_lib_extensionstatic_lib_formatshared_lib_formatdylib_lib_formatxcode_stub_lib_format
exe_extensionrJ rR r_ rz r r r r staticmethodr r __static_attributes__r~ r r r& r& i s( M F v I&f5M K ||BQ8#!)
H ?NM " % ?HHH),< ,
||x
#$J$ NRC: ! 9C~6
&"P L LD&!r r& )__doc__r r r r r r _modifiedr ccompilerr r r errorsr r
r r _logr
_macos_compatr r r r$ r& r~ r r r sP
I I I I )$$$ $ 8g!I g!r