a0biE S r SSKrSSKrSSKrSSKrSSKJrJr Sr\R " S\- 5 r
\R " SR \\5 5 r \
R SS 5 r " S
S 5 rS r\R$ V s0 s H n \" U 5 S
_M sn rS rS r " S S5 r\S:X a< SrS H3 r\" S\- 5 \" SR9 \" \\5 5 5 \" 5 M5 ggs sn f )a6 distutils.fancy_getopt
Wrapper around the standard getopt module that provides the following
additional features:
* short and long options are tied together
* options have help strings, so fancy_getopt could potentially
create a complete usage summary
* options set attributes of a passed-in object
N )DistutilsGetoptErrorDistutilsArgErrorz[a-zA-Z](?:[a-zA-Z0-9-]*)z^%s$z ^({})=!({})$-_c \ rS rSrSrSS jrS rS rSS jrS r S r
S
r S r S r
S
rSS jrS rSS jrSS jrSrg) FancyGetopt a Wrapper around the standard 'getopt()' module that provides some
handy extra functionality:
* short and long options are tied together
* options have help strings, and help text can be assembled
from them
* options set attributes of a passed-in object
* boolean options can have "negative aliases" -- eg. if
--quiet is the "negative alias" of --verbose, then "--quiet"
on the command line sets 'verbose' to false
Nc Xl 0 U l U R ( a U R 5 0 U l 0 U l / U l / U l 0 U l 0 U l 0 U l / U l
g N) option_table option_index _build_indexaliasnegative_alias
short_opts long_opts
short2long attr_name takes_arg option_orderselfr
s ڛ/builddir/build/BUILDROOT/alt-python313-setuptools-69.0.2-3.el8.x86_64/opt/alt/python313/lib/python3.13/site-packages/setuptools/_distutils/fancy_getopt.py__init__FancyGetopt.__init__, sk )
!
c U R R 5 U R H nXR US ' M g )Nr )r clearr
)r options r r FancyGetopt._build_indexT s6 !''F+1 fQi ( (r c 0 Xl U R 5 g r )r
r r s r set_option_table FancyGetopt.set_option_tableY s ( r c XR ; a [ SU- 5 eXU4nU R R U5 X@R U' g )Nz'option conflict: already an option '%s')r r r
append)r long_option short_option help_stringr s r
add_optionFancyGetopt.add_option] sQ ++ +&9KG
"=F $ $V ,-3 k *r c XR ; $ )z[Return true if the option table for this parser has an
option with long name 'long_option'.)r r r' s r
has_optionFancyGetopt.has_optiong s / ///r c , UR [ 5 $ )zTranslate long option name 'long_option' to the form it
has as an attribute of some object: ie., translate hyphens
to underscores. translate
longopt_xlater- s r
get_attr_nameFancyGetopt.get_attr_namel s $$]33r c
[ U[ 5 ( d eUR 5 HS u p4X0R ; a [ SU< SU< SU< S35 eX@R ; d M= [ SU< SU< SU< S35 e g )Nzinvalid z 'z ': option 'z
' not defined': aliased option ')
isinstancedictitemsr r )r aliaseswhatr opts r _check_alias_dict FancyGetopt._check_alias_dictr ss '4((((!--/JE - --*UE+ +++*UC) *r c 4 U R US5 Xl g)z'Set the aliases for this option parser.r N)r> r )r r s r set_aliasesFancyGetopt.set_aliases s ug.
r c 4 U R US5 Xl g)zSet the negative aliases for this option parser.
'negative_alias' should be a dictionary mapping option names to
option names, both the key and value must already be defined
in the option table.znegative aliasN)r> r )r r s r set_negative_aliases FancyGetopt.set_negative_aliases s
~/?@ ,r c / U l / U l U R R 5 0 U l U R
GH5 n[
U5 S:X a Uu p#nSnO/[
U5 S:X a Uu p#pEO[ SR U5 5 e[ U[ 5 ( a [
U5 S: a [ SU- 5 eUb2 [ U[ 5 ( a [
U5 S:X d [ S U- 5 eXPR U' U R R U5 US
S :X a! U( a US - nUSS
nSU R U' OcU R R U5 nUb6 U R U ( a [ S
U< SU< S35 eX R S
' SU R U' U R R U5 nUb4 U R U U R U :w a [ SU< SU< S35 e[" R% U5 ( d [ SU- 5 eU R' U5 U R( U' U( d GM U R R U5 X R US ' GM8 g)zPopulate the various data structures that keep tabs on the
option table. Called by 'getopt()' before it can do anything
worthwhile.
r zinvalid option tuple: {!r} z9invalid long option '%s': must be a string of length >= 2Nr z:invalid short option '%s': must a single character or None=:zinvalid negative alias 'r7 z' takes a valuezinvalid alias 'z%': inconsistent with aliased option 'z/' (one of them takes a value, the other doesn'tzEinvalid long option name '%s' (must be letters, numbers, hyphens only)r r r r repeatr
len
ValueErrorformatr8 strr r& r r getr
longopt_rematchr4 r )r r longshorthelprM alias_tos r _grok_option_table FancyGetopt._grok_option_table sZ
''F6{a $*!TV!,2)T6 !!=!D!DV!LMM dC((CIM*S
]
5#(>(>3u:QR?*68=>
!'KK NN ! !$ 'Bx3 !CKEAbz'(t$ ..2248'~~h/ 2CG S
*.NN2&'(t$ zz~~d+H#>>$'4>>(+CC. 04X? ##D))*>@DE
$(#5#5d#;DNN4 u&&u-,0a)M (r c Uc [ R SS nUc
[ 5 nSnOSnU R 5 SR U R
5 n [ R " XU R 5 u pQU GH' u px[ U5 S:X a US S:X a U R US nO [ U5 S: a USS S :X d eUSS nU R R U5 n U ( a U nU R U ( d6 US
:X d S 5 eU R R U5 n U ( a U nSnOSnU R U n
U( a+ U R" R U
5 b [% X*S5 S- n[' X*U5 U R( R+ Xx45 GM* U( a X4$ U$ ! [ R a n[ U5 eSnAff = f) a Parse command-line options in args. Store as attributes on object.
If 'args' is None or not supplied, uses 'sys.argv[1:]'. If
'object' is None or not supplied, creates a new OptionDummy
object, stores option values there, and returns a tuple (args,
object). If 'object' is supplied, it is modified in place and
'getopt()' just returns 'args'; in both cases, the returned
'args' is a modified copy of the passed-in 'args' list, which
is left untouched.
Nr TF rI r r z-- z boolean option can't have value)sysargv OptionDummyrY joinr getoptr errorr rN r r rR r r r rM getattrsetattrr r& ) r argsobjectcreated_objectr optsmsgr= valr attrs r rb FancyGetopt.getopt s <88AB ]F !N "N !XXdoo.
) t HJD HC3x1}Q3 ooc!f-3x!|BQ477!"gJJNN3'E>>#&byC"CCy ++//4 CCC>>#&D t{{t,8 fA.2 F# & $ $cZ 05 : < KG || )#C( ( )s #F2 2G GGc J U R c [ S5 eU R $ )zReturns the list of (option, value) tuples processed by the
previous run of 'getopt()'. Raises RuntimeError if
'getopt()' hasn't been called yet.
z!'getopt()' hasn't been called yet)r RuntimeError)r s r get_option_order FancyGetopt.get_option_order s(
$ BC C$$ $r c SnU R H7 nUS nUS n[ U5 nUS S:X a US-
nUb US- nXb: d M5 UnM9 US- S- S- nSnX-
n S U- n
U( a U/n OS
/n U R H nUSS u pEn [ X5 n
US S:X a USS nUc7 U
( a U R S X$U
S 4- 5 O\U R S
X$4- 5 OFSR XE5 nU
( a U R S X.U
S 4- 5 OU R SU- 5 U
SS H nU R X- 5 M M U $ )z|Generate help text (a list of strings, one per suggested line of
output) from the option table for this FancyGetopt object.
r r rJ rK N rI N r\ zOption summary:rG z --%-*s %sz
--%-*s z{} (-{})z --%-*s)r
rN wrap_textr& rP )r headermax_optr rU rV ell opt_width
line_width
text_width
big_indentlinesrW text opt_namess r
generate_helpFancyGetopt.generate_help& s| ''F!9D1IEd)CBx3Ag Ag} ( aK!Oa' 0
+
9_
HE&'E''F &r
D T.DBx3Abz }LL 7$q'2J!JKLL !?@
' - -d : LL 7tAw2O!OPLLi!78ABx Z -. - (0 r c Uc [ R nU R U5 H nUR US- 5 M g )N
)r^ stdoutr write)r rv filelines r
print_helpFancyGetopt.print_helpt s5 <::D&&v.D JJtd{ # /r ) r r r r r r r
rM r r r r )NN)__name__
__module__ __qualname____firstlineno____doc__r r r# r* r. r4 r> rA rD rY rb rp r r __static_attributes__ r r r r sS & P2
40
4
-P1d;z%L\$r r c \ [ U 5 nUR U5 UR X25 $ r )r rD rb )options negative_optrg rf parsers r fancy_getoptr { s)
!F
- == &&r r\ c U c / $ [ U 5 U:: a U /$ U R 5 n U R [ 5 n [ R
" SU 5 nU Vs/ s H
o3( d M UPM nn/ nU( a / nSnU( aR [ US 5 nXg- U:: a UR
US 5 US Xg- nOU( a US S S:X a US O U( a MR U( a7 US:X a" UR
US SU 5 US US US' US S S:X a US UR
SR U5 5 U( a M U$ s snf )zwrap_text(text : string, width : int) -> [string]
Split 'text' into multiple lines of no more than 'width' characters
each, and return the list of strings that results.
Nz( +|-+)r rJ r\ r] )rN
expandtabsr2 WS_TRANSresplitr& ra )r~ widthchunkschr} cur_linecur_lenrx s r ru ru sO |
4yEv
?? D >>( #D
XXj$
'F!
(6RRb6F
( E
fQi.C}%q *1I!- Q3 6 f !|q !E 23 "1Ief -q
ay|s"1I RWWX&'A &D LK )s
D=&D=c , U R [ 5 $ )zPConvert a long option name to a valid Python identifier by
changing "-" to "_".
r1 )r= s r translate_longoptr s == ''r c $ \ rS rSrSr/ 4S jrSrg)r` i z[Dummy class just used as a place to hold command-line option
values as instance attributes.c . U H n[ XS5 M g)zcCreate a new OptionDummy instance. The attributes listed in
'options' will be initialized to None.N)re )r r r= s r r OptionDummy.__init__ s C Dt $ r r N)r r r r r r r r r r r` r` s & " %r r` __main__zTra-la-la, supercalifragilisticexpialidocious.
How *do* you spell that odd word, anyways?
(Someone ask Mary -- she'll know [or she'll
say, "How should I know?"].))
( z width: %dr ) r r^ stringr rb errorsr r longopt_patcompilerS rP neg_alias_rerQ maketransr3 r r
whitespaceordr ru r r` r r~ wprintra )_wschars 0r r s
; +
ZZ+-
.
zz.// [IJ
c3'
X$ X$v
' .4->-> ?->'CL# -> ?3l(% % z D
kAo
dii $*+,
W @s C*