a0biF ^ S r SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK
J r J r SSK
Jr SSKJr SSKJr S rS r\R( S
:X a SqS rS rS
rS rS rS rS r \ R: " 5 S 5 r S r S r S S jr!S=q"=q#q$S r%S r&S S jr'S r( S S jr)S r*g) zudistutils.util
Miscellaneous utility functions -- anything that doesn't fit into
one of the other *util.py modules.
N )DistutilsPlatformErrorDistutilsByteCompileError)newer)spawn)logc [ R S: aZ [ R S:X aF S[ R R 5 ; a gS[ R R 5 ; a g[ R S: aZ [ R S:X aF [
[ S 5 ( a1 [ R " 5 u pp#nU S
S S :X a S
SKJ n U" XU5 $ [ R " 5 $ )z
Return a string that identifies the current platform. Use this
function to distinguish platform-specific build directories and
platform-specific built distributions.
) ntz(arm) win-arm32z(arm64) win-arm64)r
posixunameNr
aixr ) aix_platform) sys version_infoosnameversionlowerhasattrr
py38compatr sysconfig get_platform)osnamehostreleaser machiner s ړ/builddir/build/BUILDROOT/alt-python313-setuptools-69.0.2-3.el8.x86_64/opt/alt/python313/lib/python3.13/site-packages/setuptools/_distutils/util.pyget_host_platformr# s &
77d?#++++--"CKK - - //"
&
77g '"g"6"668hhj 3F'GbqzU"4#FW== ! ! ## c [ R S:X aH SSSSS.n [ R R S5 nU R U5 =( d
[ 5 $ [ 5 $ )Nr win32z win-amd64r
r )x86x64armarm64VSCMD_ARG_TGT_ARCH)r r environgetr# )TARGET_TO_PLATtargets r" r r 3 sX ww$
45 !!&)@->-@@ r$ darwinMACOSX_DEPLOYMENT_TARGETc Sq g)z For testing only. Do not call.N)_syscfg_macosx_ver r$ r" _clear_cached_macosx_verr5 E s
r$ c x [ c. SSKJn U R " [ 5 =( d SnU( a Uq [ $ )zGet the version of macOS latched in the Python interpreter configuration.
Returns the version as a string or None if can't obtain one. Cached.r )r )r3 distutilsr get_config_varMACOSX_VERSION_VAR)r vers r" !get_macosx_target_ver_from_syscfgr< K s2 !'&&'9:@b !$ r$ c [ 5 n [ R R [ 5 nU( aK U ( aB [ U 5 SS/: a1 [ U5 SS/: a S[ - SU< SU < S3- n[
U5 eU$ U $ )a Return the version of macOS for which we are building.
The target version defaults to the version in sysconfig latched at time
the Python interpreter was built, unless overridden by an environment
variable. If neither source has a value, then None is returned
r
$z mismatch: now "z" but "z*" during configure; must use 10.3 or later)r< r r, r- r:
split_versionr )
syscfg_verenv_vermy_msgs r" get_macosx_target_verrD X s 34Jjjnn /0G
j)b!W4 g&"a0 ((,3Z,A A
)0 0 r$ c b U R S5 Vs/ s H n[ U5 PM sn$ s snf )zEConvert a dot-separated string into a list of numbers for comparisons.)splitint)sns r" r@ r@ x s& GGCL )LqCFL )) )s ,c d [ R S:X a U $ U ( d U $ U S S:X a [ SU - 5 eU S S:X a [ SU - 5 eU R S5 nSU; a UR S5 SU; a M U( d [ R
$ [ R R " U6 $ )a Return 'pathname' as a name that will work on the native filesystem,
i.e. split it on '/' and put it back together again using the current
directory separator. Needed because filenames in the setup script are
always supplied in Unix style, and have to be converted to the local
convention before we can actually use them in the filesystem. Raises
ValueError on non-Unix-ish systems if 'pathname' either starts or
ends with a slash.
/r z path '%s' cannot be absolutez path '%s' cannot end with '/'rF )r sep
ValueErrorrG removecurdirpathjoin)pathnamepathss r" convert_pathrV } s
vv} {c7(BCC|s88CDD NN3 E
,
S , yy
77<< r$ c [ R S:X ae [ R R U5 ( d [ R R X5 $ [ R R XSS 5 $ [ R S:X aN [ R R U5 u p#US S:X a USS n[ R R X5 $ [
S[ R S35 e) zReturn 'pathname' with 'new_root' prepended. If 'pathname' is
relative, this is equivalent to "os.path.join(new_root,pathname)".
Otherwise, it requires making 'pathname' relative and then joining the
two, which is tricky on DOS/Windows and Mac OS.
r r Nr r \z nothing known about platform '')r r rR isabsrS
splitdriver )new_rootrT driverR s r" change_rootr^ s
ww'ww}}X&&77<<3 377<<12,7 7 D **84
7d?8Dww||H++
#A"''!!L
MMr$ c Z [ R S:X aQ S[ R ; a= SSKn U R [ R
" 5 5 S [ R S' S[ R ; a [ 5 [ R S' gg! [ [ 4 a NCf = f)a4 Ensure that 'os.environ' has all the environment variables we
guarantee that users can use in config files, command-line options,
etc. Currently this includes:
HOME - user's home directory (Unix only)
PLAT - description of the current platform, including hardware
and OS (see 'get_platform()')
r HOMEr N PLAT) r r r, pwdgetpwuidgetuid ImportErrorKeyErrorr )rc s r"
check_environrh s
ww'fBJJ 6 !$ biik!:1!=BJJv RZZ )^
6 X&
s subst_vars.. s K8J4U$8Js zinvalid variable N)
rh dictr r, updateitems
_subst_compat
format_maprg rO )rI
local_varslookupvars r"
subst_varsrz sp O
"**
F
MMK
8H8H8JKK4 Q **622 4,SE2334s A% %
B/A==Bc x S n[ R " SX5 nX :w a SSKnUR S[ 5 U$ )zV
Replace shell/Perl-style variable substitution with
format-style. For compatibility.
c , SU R S5 S3$ )N{r })group)matchs r" _subst _subst_compat.._subst s EKKN#2&&r$ z\$([a-zA-Z_][a-zA-Z_0-9]*)r Nz-shell/Perl-style substitutions are deprecated)resubwarningswarnDeprecationWarning)rI r replr s r" ru ru s; ' 66/ ;D y
;
Kr$ c U[ U 5 - $ rk rl )excprefixs r" grok_environment_errorr s CH r$ c [ R " S[ R - 5 q[ R " S5 q[ R " S5 qg )Nz
[^\\\'\"%s ]*z'(?:[^'\\]|\\.)*'z"(?:[^"\\]|\\.)*")r compilestring
whitespace
_wordchars_re
_squote_re
_dquote_rer4 r$ r" _init_regexr s: JJ /&2C2C CDM 01J 01Jr$ c 6 [ c
[ 5 U R 5 n / nSnU ( Gak [ R X5 nUR 5 nU[ U 5 :X a UR
U SU 5 U$ X [ R ; a) UR
U SU 5 XS R 5 n SnOX S:X a U SU XS- S - n US- nOX S:X a [ R X5 nO.X S:X a [ R X5 nO[ SX - 5 eUc [ SX - 5 eUR 5 u pTU SU XS- US-
- XS - n UR 5 S -
nU[ U 5 : a UR
U 5 U$ U ( a GMk U$ )
a Split a string up according to Unix shell-like rules for quotes and
backslashes. In short: words are delimited by spaces, as long as those
spaces are not escaped by a backslash, or inside a quoted string.
Single and double quotes are equivalent, and the quote characters can
be backslash-escaped. The backslash is stripped from any two-character
escape sequence, leaving only the escaped character. The quote
characters are stripped from any quoted string. Returns a list of
words.
Nr rX r rY "z!this can't happen (bad char '%c')z"bad string (mismatched %s quotes?) )r r stripr endlenappendr r lstripr r RuntimeErrorrO span)rI wordsposmr begs r" split_quotedr s
A E
C
'eeg #a&= LL4C ! D LA
6V&& &
LL4C !$ AC
Vt^ $3!!GI,&A'C v} $$Q,3 $$Q,"#F#OPPy !E!NOOJS$3!!GcAg..48A%%'A+C #a&= LLO LO !N Lr$ c Uc- SR U R U5 nUSS S:X a USS S- n[ R " U5 U( d U " U6 gg)a Perform some action that affects the outside world (eg. by
writing to the filesystem). Such actions are special because they
are disabled by the 'dry_run' flag. This method takes care of all
that bureaucracy for you; all you have to do is supply the
function to call and an argument tuple for it (to embody the
"external action" being performed), and an optional message to
print.
Nz{}{!r}z,)r ))format__name__r info)funcargsmsgverbosedry_runs r" executer A sT {oodmmT2 rs8t a)c/CHHSM d r$ c r U R 5 n U S; a gU S; a g[ SR U 5 5 e)zConvert a string representation of truth to true (1) or false (0).
True values are 'y', 'yes', 't', 'true', 'on', and '1'; false values
are 'n', 'no', 'f', 'false', 'off', and '0'. Raises ValueError if
'val' is anything else.
)yyesttrueon1r )rJ noffalseoff0r zinvalid truth value {!r})r rO r )vals r" strtoboolr T s> ))+C
22 5 53::3?@@r$ c [ R ( a [ S5 eUc US:H nU( Gd7 SSKJn U" S5 u p[ R " SU
5 U( d U b [ R " U S5 n O [ U
S5 n U U R S 5 U R S
R [ [ U 5 5 S - 5 U R S U< S
U< SU< SU< SU< S3 5 SSS5 [ R /n
U
R# [$ R& " 5 5 U
R) U
5 [+ XS9 [- [ R. U
4SU
- US9 gSSKJn U GHG nUSS S:w a M US: a) US:X a SOUn[4 R6 R9 UUS9nO [4 R6 R9 U5 nUnU( a3 US[; U5 U:w a [= SU< SU< 35 eU[; U5 S nU( a [ R> R UU5 n[ R> RA U5 nU( d M U( d [C UU5 ( a/ [ R " SUU5 U( d
U" UUU5 GM, GM/ [ RD " SUU5 GMJ g! [
a SSKJn SU " S5 p GNf = f! , ( d f GN= f) a Byte-compile a collection of Python source files to .pyc
files in a __pycache__ subdirectory. 'py_files' is a list
of files to compile; any files that don't end in ".py" are silently
skipped. 'optimize' must be one of the following:
0 - don't optimize
1 - normal optimization (like "python -O")
2 - extra optimization (like "python -OO")
If 'force' is true, all files are recompiled regardless of
timestamps.
The source filename encoded in each bytecode file defaults to the
filenames listed in 'py_files'; you can modify these with 'prefix' and
'basedir'. 'prefix' is a string that will be stripped off of each
source filename, and 'base_dir' is a directory name that will be
prepended (after 'prefix' is stripped). You can supply either or both
(or neither) of 'prefix' and 'base_dir', as you wish.
If 'dry_run' is true, doesn't actually do anything that would
affect the filesystem.
Byte-compilation is either done directly in this interpreter process
with the standard py_compile module, or indirectly by writing a
temporary script and executing it. Normally, you should let
'byte_compile()' figure out to use direct compilation or not (see
the source for details). The 'direct' flag is used by the script
generated in indirect mode; unless you know what you're doing, leave
it set to None.
zbyte-compiling is disabled.Nr )mkstempz.py)mktempz$writing byte-compilation script '%s'wz2from distutils.util import byte_compile
files = [
z,
z]
z
byte_compile(files, optimize=z, force=z,
prefix=z , base_dir=z,
verbose=z$, dry_run=0,
direct=1)
)r z removing %s)r r7 ) optimizationzinvalid prefix: filename z doesn't start with zbyte-compiling %s to %sz%skipping byte-compilation of %s to %s)#r dont_write_bytecoder tempfiler rf r r r r fdopenopenwriterS maprepr
executableextend
subprocess"_optim_args_from_interpreter_flagsr r r rP
py_compiler importlibutilcache_from_sourcer rO rR basenamer debug)py_filesoptimizeforcer base_dirr r directr script_fd script_namer scriptcmdr fileoptcfiledfile
cfile_bases r" byte_compiler d sn P '(EFF ~ '1} ; ('.u~ $Y
7E$9c2 k3/ " UZZD((; =;+FPWX ' DBCyE!
1} $Mbx!88C8P!88>E
#f+&&0$ ) c&km, Xu5))%0JvE$ . .HH 6jI" eU3 # II EtZXA k ; ''+VE] ; s J= A)K =KK
K,c J U R S5 nSnUR U5 $ )zReturn a version of the string escaped for inclusion in an
RFC-822 header, by ensuring there are 8 spaces space after each newline.
z
)rG rS )headerlinesrN s r"
rfc822_escaper s%
LL E
C 88E?r$ )zerror: )Nr r )r r NNr r N)+__doc__importlib.utilr r r r r r r functoolserrorsr r _modifiedr r _logr r# r platformr3 r: r5 r< rD r@ rV r^ lru_cacherh rz ru r r r r r r r r r r r4 r$ r" r s
E $:
<<8 /
@*
:N* , ,,4&( +/ .
.
Z2<D&
A$
TYnr$