o
0¦ixE ã @ sä d Z ddlZddlZddlZddlZddlT dZe de ¡Ze deef ¡Z e
dd¡Z G d d
„ d
ƒZ
d d „ Zd
d„ ejD ƒZdd„ Zdd„ ZG dd„ dƒZedkrndZdD ]Zede ƒ ed eeeƒ¡ƒ eƒ qXdS dS )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)Ú*z[a-zA-Z](?:[a-zA-Z0-9-]*)z^%s$z ^(%s)=!(%s)$ú-Ú_c @ sŠ e Zd ZdZd dd„Zdd„ Zdd„ Zd d d
„Zd d „ Zd
d„ Z dd„ Z
dd„ Z dd„ Z dd„ Z
d dd„Zdd„ Zd dd „Zd d d „ZdS )!Ú FancyGetoptaÕ 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 C sN || _ i | _| j r
| ¡ i | _i | _g | _g | _i | _i | _i | _ g | _
d S ©N) Ú option_tableÚ option_indexÚ _build_indexÚaliasÚnegative_aliasÚ
short_optsÚ long_optsÚ
short2longÚ attr_nameÚ takes_argÚ option_order©Úselfr © r ú=/opt/alt/python310/lib64/python3.10/distutils/fancy_getopt.pyÚ__init__) s
zFancyGetopt.__init__c C s( | j ¡ | jD ] }|| j |d < qd S )Nr )r Úclearr )r Úoptionr r r r Q s
ÿzFancyGetopt._build_indexc C s || _ | ¡ d S r )r r r r r r Úset_option_tableV s z FancyGetopt.set_option_tablec C s: || j v r td| ƒ‚|||f}| j |¡ || j |< d S )Nz'option conflict: already an option '%s')r ÚDistutilsGetoptErrorr Úappend)r Ú long_optionZ short_optionZ help_stringr r r r Ú
add_optionZ s
ÿ
zFancyGetopt.add_optionc C s
|| j v S )zcReturn true if the option table for this parser has an
option with long name 'long_option'.)r ©r r r r r Ú
has_optionc s
zFancyGetopt.has_optionc C s
| t¡S )z’Translate long option name 'long_option' to the form it
has as an attribute of some object: ie., translate hyphens
to underscores.©Ú translateÚ
longopt_xlater r r r Ú
get_attr_nameh ó
zFancyGetopt.get_attr_namec C s\ t |tƒsJ ‚| ¡ D ] \}}|| jvr td|||f ƒ‚|| jvr+td|||f ƒ‚q d S )Nz(invalid %s '%s': option '%s' not definedz0invalid %s '%s': aliased option '%s' not defined)Ú
isinstanceÚdictÚitemsr r )r ÚaliasesZwhatr
Úoptr r r Ú_check_alias_dictn s
ÿ
ÿÿüz FancyGetopt._check_alias_dictc C ó | |d¡ || _dS )z'Set the aliases for this option parser.r
N)r* r
)r r
r r r Ú set_aliasesx s
zFancyGetopt.set_aliasesc C r+ )zÚSet 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 r r r Úset_negative_aliases} s
z FancyGetopt.set_negative_aliasesc C sÀ g | _ g | _| j ¡ i | _| jD ]Ì}t|ƒdkr!|\}}}d}nt|ƒdkr.|\}}}}ntd|f ƒ‚t|t ƒr@t|ƒdk rFt
d| ƒ‚|du s[t|t ƒrUt|ƒdks[t
d | ƒ‚|| j|< | j |¡ |d
d kr~|rr|d }|dd
… }d| j |< n!| j
|¡}|durš| j | r•t
d
||f ƒ‚|| j d
< d| j |< | j |¡}|dur»| j | | j | kr»t
d||f ƒ‚t |¡sÆt
d| ƒ‚| |¡| j|< |rÝ| j |¡ || j|d < qdS )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 >= 2Né z:invalid short option '%s': must a single character or Noneéÿÿÿÿú=ú:z>invalid negative alias '%s': aliased option '%s' takes a valuezginvalid alias '%s': inconsistent with aliased option '%s' (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Ú
ValueErrorr% Ústrr r r r Úgetr
Ú
longopt_reÚmatchr# r )r r ÚlongÚshortÚhelpr5 Zalias_tor r r Ú_grok_option_table… st
ÿÿ ÿ
þÿ
ýÿ
ÿÿ €¿z FancyGetopt._grok_option_tablec
C s† |du r t jdd… }|du rtƒ }d}nd}| ¡ d | j¡}z t ||| j¡\}}W n tjy> } zt |ƒ‚d}~ww |D ]y\}}t
|ƒdkrY|d dkrY| j |d }nt
|ƒdkrg|dd… d ksiJ ‚|dd… }| j
|¡} | ry| }| j| s•|d
ks†J d ƒ‚| j
|¡} | r“| }d}nd}| j| }
|r¬| j
|
¡dur¬t||
dƒd }t||
|ƒ | j ||f¡ qA|rÁ||fS |S ) 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.
Nr1 TFú r0 r r z--Ú z boolean option can't have value)ÚsysÚargvÚ OptionDummyr? Újoinr Úgetoptr
ÚerrorZDistutilsArgErrorr6 r r
r9 r r r r5 ÚgetattrÚsetattrr r ) r ÚargsÚobjectZcreated_objectr ZoptsÚmsgr) Úvalr
Úattrr r r rF Ò sJ €ÿ
zFancyGetopt.getoptc C s | j du r tdƒ‚| j S )z«Returns 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)r r r r Úget_option_order s
z FancyGetopt.get_option_orderc C sd d}| j D ]&}|d }|d }t|ƒ}|d dkr |d }|dur%|d }||kr+|}q|d d d }d}|| } d | }
|rD|g} nd
g} | j D ]e}|dd … \}}} t| | ƒ}
|d dkrf|dd… }|du rƒ|
ry| d |||
d f ¡ n&| d
||f ¡ n d||f }|
r˜| d |||
d f ¡ n| d| ¡ |
dd… D ] }| |
| ¡ q¥qJ| S )zŒGenerate help text (a list of strings, one per suggested line of
output) from the option table for this FancyGetopt object.
r r1 r2 r3 Né r0 éN r@ zOption summary:r. z --%-*s %sz
--%-*s z%s (-%s)z --%-*s)r r6 Ú wrap_textr )r ÚheaderZmax_optr r< r= ÚlZ opt_widthZ
line_widthZ
text_widthZ
big_indentÚlinesr> ÚtextZ opt_namesr r r Ú
generate_help sL
€
ÿÿzFancyGetopt.generate_helpc C s0 |d u rt j}| |¡D ] }| |d ¡ q d S )NÚ
)rB ÚstdoutrX Úwrite)r rT ÚfileÚliner r r Ú
print_helph s
ÿzFancyGetopt.print_helpr )NN)Ú__name__Ú
__module__Ú __qualname__Ú__doc__r r r r r r# r* r, r- r? rF rP rX r^ r r r r r s
(
M=
Or c C s t | ƒ}| |¡ | ||¡S r )r r- rF )ÚoptionsZ negative_optrK rJ Úparserr r r Ú fancy_getopto s
re c C s i | ]}t |ƒd “qS )r@ )Úord)Ú.0Z_wscharr r r Ú
u s rh c C s | du rg S t | ƒ|kr| gS | ¡ } | t¡} t d| ¡}dd„ |D ƒ}g }|rŠg }d}|rZt |d ƒ}|| |krJ| |d ¡ |d= || }n|rW|d d dkrW|d= n|s/|r€|dkru| |d d|… ¡ |d |d… |d< |d d dkr€|d= | d |¡¡ |s)|S ) z¶wrap_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( +|-+)c S s g | ]}|r|‘qS r r )rg Zchr r r Ú
… s z wrap_text..r r2 r@ rA )r6 Ú
expandtabsr! ÚWS_TRANSÚreÚsplitr rE )rW ÚwidthZchunksrV Zcur_lineZcur_lenrU r r r rS w s>
ö à"rS c C s
| t¡S )zXConvert a long option name to a valid Python identifier by
changing "-" to "_".
r )r) r r r Útranslate_longopt r$ ro c @ s e Zd ZdZg fdd„ZdS )rD z_Dummy class just used as a place to hold command-line option
values as instance attributes.c C s |D ]}t | |dƒ qdS )zkCreate a new OptionDummy instance. The attributes listed in
'options' will be initialized to None.N)rI )r rc r) r r r r ¸ s ÿzOptionDummy.__init__N)r_ r` ra rb r r r r r rD ´ s rD Ú__main__z¢Tra-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: %drY )rb rB Ústringrl rF Zdistutils.errorsZ longopt_patÚcompiler: Z neg_alias_rer8 Ú maketransr" r re Z
whitespacerk rS ro rD r_ rW ÚwÚprintrE r r r r Ú s0
T6 ö