5hE dZddlmZddlZddlZddlZddlZddlmZddl m Z ddl m Z m Z dZejd ed Zejd ed ed ZeddZGddZddZdejDZdZdZGddZedkrGdZdD]DZedeed eeeeCdSdS) a6distutils.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 ) annotationsN)Sequence)Any)DistutilsArgErrorDistutilsGetoptErrorz[a-zA-Z](?:[a-zA-Z0-9-]*)^$z^(z)=!(z)$-_creZdZdZddZdZdZddZdZdZ d Z d Z d Z d Z dddZdZddZddZdS) FancyGetoptaWrapper 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||_i|_|jr|i|_i|_g|_g|_i|_i|_i|_ g|_ dSN) option_table option_index _build_indexaliasnegative_alias short_opts long_opts short2long attr_name takes_arg option_orderselfrs Blib/python3.11/site-packages/setuptools/_distutils/fancy_getopt.py__init__zFancyGetopt.__init__1s{)         !  cl|j|jD]}||j|d<dS)Nr)rclearr)roptions rrzFancyGetopt._build_indexYsG !!!' 2 2F+1D fQi ( ( 2 2r c<||_|dSr)rrrs rset_option_tablezFancyGetopt.set_option_table^s"( r c||jvrtd|d|||f}|j|||j|<dS)Nz$option conflict: already an option '')rrrappend)r long_option short_option help_stringr#s r add_optionzFancyGetopt.add_optionbsh $+ + +&E{EEE "<=F   $ $V , , ,-3D k * * *r c||jvS)zcReturn true if the option table for this parser has an option with long name 'long_option'.)rrr)s r has_optionzFancyGetopt.has_optionlsd///r c6|tS)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_namezFancyGetopt.get_attr_nameqs$$]333r c t|tsJ|D]I\}}||jvrt d|d|d|d||jvrt d|d|d|dJdS)Nzinvalid z 'z ': option 'z ' not defined': aliased option ') isinstancedictitemsrr)raliaseswhatropts r_check_alias_dictzFancyGetopt._check_alias_dictws'4(((((!--//  JE3D---*MtMMuMMMMM$+++*StSSuSSSSS,   r c@||d||_dS)z'Set the aliases for this option parser.rN)r=r)rrs r set_aliaseszFancyGetopt.set_aliasess# ug... r c@||d||_dS)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)rrs rset_negative_aliasesz FancyGetopt.set_negative_aliasess) ~/?@@@,r cg|_g|_|ji|_|jD]'}t |dkr |\}}}d}n-t |dkr|\}}}}ntd|t|trt |dkrtd|d|;t|trt |d kstd |d ||j|<|j ||d d kr|r|dz}|dd }d|j |<nS|j |}|-|j |rtd|d|d||jd <d|j |<|j|}|2|j ||j |krtd|d|dt |std|d|||j|<|r*|j |||j|d<)dS)zPopulate the various data structures that keep tabs on the option table. Called by 'getopt()' before it can do anything worthwhile. rzinvalid option tuple: zinvalid long option 'z"': must be a string of length >= 2Nrzinvalid short option 'z"': must a single character or None=:Tzinvalid negative alias 'r6z' takes a valueFzinvalid alias 'z%': inconsistent with aliased option 'z/' (one of them takes a value, the other doesn'tzinvalid long option name 'z)' (must be letters, numbers, hyphens only)rrrr"repeatrlen ValueErrorr7strrr(rrgetr longopt_rematchr4r)rr#longshorthelprIalias_tos r_grok_option_tablezFancyGetopt._grok_option_tables   'D 1D 1F6{{a$*!eTV!!,2)eT66!!D&!D!DEEEdC(( CIIMM*TDTTT] 5#(>(>]3u::QR??*VUVVV!'DK  N ! !$ ' ' 'Bx3(!CKEAbDz'+t$$ .22488'~h/2ItII/7III *.DN2&',t$z~~d++H#>$'4>(+CCC.,$,,+3,,,##D)) *>>>> $(#5#5d#;#;DN4  1&&u---,0a)ID 1D 1r argsSequence[str] | Nonec|tjdd}|t}d}nd}|d|j} t j|||j\}}n&#t j$r}t|d}~wwxYw|D].\}}t|dkr |ddkr|j |d}n-t|dkr|ddd ksJ|dd}|j |} | r| }|j|s3|d ks Jd |j |} | r| }d}nd}|j|} |r.|j | t%|| ddz}t'|| ||j||f0|r||fS|S) aParse 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. NrTF rErr z--zboolean option can't have value)sysargv OptionDummyrTjoinrgetoptrerrorrrJrrrMrrrrIgetattrsetattrrr() rrUobjectcreated_objectroptsmsgr<valrattrs rr^zFancyGetopt.getopts <8ABB ]]F!NN"N !!!XXdo..  )tZHHJD$$| ) ) )#C(( ( ) 1 1HC3xx1}}Q3oc!f-3xx!||BQB47!""gJNN3''E >#& byyy"Cyyy+//44CCCC>#&D 3t{t,,8fdA..2 FD# & & &   $ $c3Z 0 0 0 0  < KsA::B BBc<|jtd|jS)zReturns the list of (option, value) tuples processed by the previous run of 'getopt()'. Raises RuntimeError if 'getopt()' hasn't been called yet. Nz!'getopt()' hasn't been called yet)r RuntimeError)rs rget_option_orderzFancyGetopt.get_option_orders%   $BCC C$ $r cd}|jD]A}|d}|d}t|}|ddkr|dz }||dz}||kr|}B|dzdzdz}d}||z } d |z} |r|g} nd g} |jD]}|dd \}}} t| | } |ddkr |dd}|E| r&| d |d |d| dni| d |d |nL|d|d}| r&| d |d |d| dn| d |d || ddD]}| | |z| S)zGenerate help text (a list of strings, one per suggested line of output) from the option table for this FancyGetopt object. rrrFrGNrENrXzOption summary:rCz -- !>G!>!>!>!>???ABBx / / Z#-.... / r c| tj}||D]}||dzdS)N )rZstdoutr{write)rrqfilelines r print_helpzFancyGetopt.print_helpusN <:D&&v.. $ $D JJtd{ # # # # $ $r r)NNrUrV)__name__ __module__ __qualname____doc__rrr%r,r/r4r=r?rArTr^rjr{rr rrr%s  &&&&P222 4444000 444    ---N1N1N1`;;;;;z%%%LLLL\$$$$$$r rrUrVcvt|}|||||Sr)rrAr^)options negative_optrbrUparsers r fancy_getoptr|s7  ! !F  --- ==v & &&r c.i|]}t|dS)rX)ord).0_wschars r rs ? ? ?'CLL# ? ? ?r c|gSt||kr|gS|}|t}t jd|}d|D}g}|rg}d}|r\t|d}||z|kr$||d|d=||z}n|r|dddkr|d=n|\|rQ|dkr6||dd||d|d|d<|dddkr|d=|d|||S)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( +|-+)cg|]}||Srr)rchs r zwrap_text..s ( ( (RR (b ( ( (r rrFrXrY)rJ expandtabsr2WS_TRANSresplitr(r])rywidthchunksrxcur_linecur_lenrss rrprps  |  4yyEv ??  D >>( # #D Xj$ ' 'F ( (6 ( ( (F E  ( fQi..C}%%q ***1I!C-% Q3 6 6     !||q !E' 2333"1Ieff-q ay|s""1I  RWWX&&'''A  (D Lr c6|tS)zXConvert a long option name to a valid Python identifier by changing "-" to "_". r1)r<s rtranslate_longoptrs == ' ''r ceZdZdZgfddZdS)r\z_Dummy class just used as a place to hold command-line option values as instance attributes.r Sequence[Any]c2|D]}t||ddS)zkCreate a new OptionDummy instance. The attributes listed in 'options' will be initialized to None.N)ra)rrr<s rrzOptionDummy.__init__s2 % %C D#t $ $ $ $ % %r N)rr)rrrrrrr rr\r\s<&&13%%%%%%%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?"].)) (zwidth: r}r)!r __future__rr^rstringrZcollections.abcrtypingrerrorsrr longopt_patcompilerN neg_alias_rerL maketransr3rr whitespacerrprr\rrywprintr]rr rrs #""""" $$$$$$;;;;;;;; + RZ+[+++ , , rz?{?? ???@@  c3'' T$T$T$T$T$T$T$T$n '''' @ ?V-> ? ? ?333l(((%%%%%%%% z D  mmm dii $**++,,, r