JtpAE d Z ddlZddlZdgZdZ G d de Z G d de Z G d d
e Z
G d d e
Z G d
de
Z G d de Z
G d de
Z G d de Z G d de Z G d de Z G d de Z G d d e Z G d d e Z G d d e Zd! Zd" Zd# Zd$ Zd% Zd& Z d1d(Z d) Z d* Z d+ Z d, Z! G d- d.e" Z#d2d0Z$dS )3a Pythonic command-line interface parser that will make you smile.
* http://docopt.org
* Repository and issue-tracker: https://github.com/docopt/docopt
* Licensed under terms of MIT license (see LICENSE-MIT)
* Copyright (c) 2013 Vladimir Keleshev, vladimir@keleshev.com
Ndocoptz0.6.2c e Zd ZdZdS )DocoptLanguageErrorz4Error in construction of usage-message by developer.N__name__
__module__ __qualname____doc__ X/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/docopt.pyr r s >>>>r r c e Zd ZdZdZddZdS )
DocoptExitz;Exit in case user invoked program with incorrect arguments. c v t | |dz | j z d S )N
)
SystemExit__init__usagestrip)selfmessages r
r zDocoptExit.__init__ s5 D7T>DJ#>"E"E"G"GHHHHHr N)r )r r r r
r r r r r
r r s9 EE EI I I I I Ir r c D e Zd Zd Zd Zd ZddZd Zed Z dS ) Patternc B t | t | k S Nrepr)r others r
__eq__zPattern.__eq__" s DzzT%[[((r c : t t | S r )hashr r s r
__hash__zPattern.__hash__% s DJJ r c V | | | S r )fix_identitiesfix_repeating_argumentsr# s r
fixz Pattern.fix( s+ $$&&& r Nc ` t | d s| S |.t t | n|}t | j D ]T\ }}t |d s*||v sJ || | | j |< ?| | UdS )z>Make pattern-tree tips point to same object if they are equal.childrenN)hasattrlistsetflat enumerater* indexr& )r uniqics r
r& zPattern.fix_identities- s tZ(( K)- tC $$%%%4 dm,, ' 'DAq1j))
'Dyyyy#'
1
#6
a &&&& ' 'r c d | j j D }|D ]̊fdD D ]}t | t u s t | t u rO|j rH|j g |_ n9t |j t ur |j |_ t | t u s!t | t u r|j dk rd|_ | S )z5Fix elements that should accumulate/increment values.c 6 g | ]}t |j S r r, r* .0r3 s r
z3Pattern.fix_repeating_arguments..; s" AAAq$qz""AAAr c F g | ] } | d k | S ) )count)r8 r3 cases r
r9 z3Pattern.fix_repeating_arguments..= s- ;;;AA ):):a):):):r Nr )
eitherr* typeArgumentOptionargcountvaluer, splitCommand)r r> er= s @r
r' z Pattern.fix_repeating_arguments9 s AADK,@AAA D;;;;;;;
77h&&$q''V*;*;
*;w"$ ag d22"#'--//77g%%aF):):qzQ AG
r c g }| gg}|r]| d }d |D }t |v r_d |D d }| | | |j D ]}| |g|z nt
|v rfd |D d }| | | | t
|j |z nbt |v red |D d }| | | | t
|j |z nt |v red |D d }| | | | t
|j |z nt |v rhd |D d } | | | | t
| j dz |z n| | |]t d |D S )
zATransform pattern into an equivalent, with only top-level Either.r c , g | ]}t | S r r? r7 s r
r9 z"Pattern.either..P s ///T!WW///r c > g | ]}t | t u |S r )r? Eitherr7 s r
r9 z"Pattern.either..R s( CCCaF1B1B!1B1B1Br c > g | ]}t | t u |S r )r? Requiredr7 s r
r9 z"Pattern.either..W ( GGG!477h3F3FA3F3F3Fr c > g | ]}t | t u |S r )r? Optionalr7 s r
r9 z"Pattern.either..[ rN r c > g | ]}t | t u |S r )r?
AnyOptionsr7 s r
r9 z"Pattern.either.._ s( III!477j3H3HA3H3H3Hr c > g | ]}t | t u |S r )r? OneOrMorer7 s r
r9 z"Pattern.either..c s( I I I1DGGy4H4HQ4H4H4Hr c g | ] }t | S r )rM )r8 rF s r
r9 z"Pattern.either..h s 222! 222r )
poprK r0 r* appendrM r, rP rR rT )
r retgroupsr* typesr> r3 requiredoptional oneormores
r
r> zPattern.eitherG s
& % zz!}}H//h///ECCXCCCAF X^^F 3 3444 2 2AMM1#.11112U""GGxGGGJ X^^H 5 5666
d8#4 5 5 @AAAAU""GGxGGGJ X^^H 5 5666
d8#4 5 5 @AAAAu$$IIxIII!L X^^H 5 5666
d8#4 5 5 @AAAAe## I I I I I! L X^^I 6 6777
d9#5 6 6 :X EFFFF
8$$$3 %4 22c22233r r )
r r r r r$ r( r& r' propertyr> r r r
r r s ) ) )
'
'
'
' 4 4 X 4 4 4r r c * e Zd ZddZd Zd ZddZdS ) ChildPatternNc " || _ || _ d S r namerC r rd rC s r
r zChildPattern.__init__m
r c @ | j j d| j d| j dS )N(, )) __class__r rd rC r# s r
__repr__zChildPattern.__repr__q s& #~ 6 6 6 4:::NNr c 2 |rt | |v r| gng S r rI r r[ s r
r. zChildPattern.flatt s# "Ad4jjE&9&9vvrAr c |g n|} | \ }}|d||fS |d | ||dz d z } fd|D }t j t t fv rut j t u rd}n*t |j t
u r|j gn|j }|s||_ d|||gz fS |d xj |z
c_ d||fS d|||gz fS )NFr; c 4 g | ]}|j j k |S r )rd )r8 ar s r
r9 z&ChildPattern.match..} s' AAA1QVty-@-@Q-@-@-@r Tr ) single_matchr? rC intr, str)r left collectedposmatchleft_ same_name increments ` r
rx zChildPattern.matchw s) #+BB &&t,,
U =$ ) )TcT
T#'((^+AAAA AAA
T{ * *DJ 3&& .25;.?.?3.F.Fek]]"'+
8 ' UI$777 aL ) + ) )UI ///r r )r r r r rl r. rx r r r
ra ra k s` O O OB B B0 0 0 0 0 0r ra c e Zd Zd Zd Zd ZdS )
ParentPatternc . t | | _ d S r r6 )r r* s r
r zParentPattern.__init__ s X
r c j | j j dd d | j D dS )Nrh ri c 3 4 K | ]}t | V d S r r r8 rq s r
z)ParentPattern.__repr__.. s( $D$DT!WW$D$D$D$D$D$Dr rj )rk r joinr* r# s r
rl zParentPattern.__repr__ sB >222 99$D$Ddm$D$D$DDDDDF Fr c n t | v r| gS t fd| j D g S )Nc $ g | ] } |j
S r )r. )r8 r3 r[ s r
r9 z&ParentPattern.flat.. s! :::qFAFEN:::r )r? sumr* rn s `r
r. zParentPattern.flat sB :: 6M::::DM:::B???r N)r r r r rl r. r r r
r} r} sI ' ' 'F F F@ @ @ @ @r r} c * e Zd Zd Zed ZdS )r@ c t | D ]9\ }}t | t u r |t | j |j fc S :dS NNN)r/ r? r@ rd rC r ru nps r
rr zArgument.single_match sU dOO 7 7DAqAww(""(49ag666666 #zr c t j d| d }t j d|t j } | ||r|d nd S )Nz(<\S*?>)r \[default: (.*)\]flags)refindallI)class_sourcerd rC s r
parsezArgument.parse sP z*f--a0
.bdCCCvd 7E!HH4888r N)r r r rr classmethodr r r r
r@ r@ s> 9 9 [9 9 9r r@ c e Zd ZddZd ZdS )rE Fc " || _ || _ d S r rc re s r
r zCommand.__init__ rf r c t | D ]F\ }}t | t u r+|j | j k r|t | j d fc S nGdS )NTr )r/ r? r@ rC rd rE r s r
rr zCommand.single_match si dOO DAqAww(""7di'' gdi 6 66666E #
zr NF)r r r r rr r r r
rE rE s7 r rE c N e Zd Zd dZed Zd Zed Zd Z dS )
rA Nr Fc l |dv sJ ||c| _ | _ ||c| _ | _ |du r|rd n|| _ d S )N)r r; FshortlongrB rC )r r r rB rC s r
r zOption.__init__ sN 6!!!! %t
DI$,e!
tz "e^^^TTe
r c d\ }}}}| d \ }}}| dd dd }| D ]4} | d r| }| d r| }2d}5|r-t j d |t
j
}
|
r|
d nd } | |||| S ) NNNr Fz , =---r; r r r )r partitionreplacerD
startswithr r r ) r option_descriptionr r rB rC options_ descriptionsmatcheds r
r z Option.parse s ';$tXu"4":":"<"<"F"Ft"L"L K//#s++33C== A||D!!
c""
4j!4kNNNG")3GAJJtEveT8U333r c \ t | D ]\ }}| j |j k r||fc S dS r )r/ rd r s r
rr zOption.single_match sA dOO DAqyAF""!t #zr c | j p| j S r )r r r# s r
rd z Option.name s y&DJ&r c H d| j d| j d| j d| j d S )NzOption(ri rj r r# s r
rl zOption.__repr__ s2 +/:::tyyy+/===$***F Fr r )
r r r r r r rr r_ rd rl r r r
rA rA s D D D D 4 4 [4 ' ' X'F F F F Fr rA c e Zd ZddZdS )rM Nc z |g n|}|}|}| j D ]%}| || \ }}}|sd||fc S &d||fS )NFTr* rx )r ru rv lr3 r r s r
rx zRequired.match sn #+BB . .A GGAqMMMGQ
. dI----
.Qzr r r r r rx r r r
rM rM s( r rM c e Zd ZddZdS )rP Nc ` |g n|}| j D ] }| || \ }}} d||fS )NTr )r ru rv r ms r
rx zOptional.match sJ #+BB : :A!"y!9!9 AtYYT9$$r r r r r r
rP rP s( % % % % % %r rP c e Zd ZdZdS )rR z*Marker/placeholder for [options] shortcut.Nr r r r
rR rR s 4444r rR c e Zd ZddZdS )rT Nc t | j dk sJ |g n|}|}|}d }d}d}|r9| j d || \ }}}||rdndz
}||k rn|}|9|dk rd||fS d||fS )Nr; Tr F)lenr* rx )r ru rv r r3 l_r timess r
rx zOneOrMore.match s 4=!!Q&&&&#+BB
M! , 2 21a 8 8MGQ '(QQq (EQwwB
A::A: dI%%r r r r r r
rT rT s( & & & & & &r rT c e Zd ZddZdS )rK Nc |g n|}g }| j D ]5}| || x\ }}}}|r| | 6|rt |d S d||fS )Nc , t | d S )Nr; r )outcomes r
z Either.match.. s S__ r )keyF)r* rx rX min)r ru rv outcomesr r r r s r
rx z Either.match s #+BB ) )A&'ggdI&>&> >MGQG
)((( Fx%D%DEEE EdI%%r r r r r r
rK rK s( & & & & & &r rK c e Zd Zd Zd Zd ZdS ) TokenStreamc f | t |d r| n|z
} || _ d S )NrD )r+ rD error)r r r s r
r zTokenStream.__init__# s2 '&'":":F F
r c N t | r| d nd S Nr )r rW r# s r
movezTokenStream.move' s! !$ii1txx{{{T1r c 4 t | r| d nd S r r r# s r
currentzTokenStream.current* s d))-tAww-r N)r r r r r r r r r
r r ! sA 2 2 2. . . . .r r c | d \ }} d sJ ||cxk rdk rn ndn|}fd|D }| j t u r|g k rfd|D }t | dk r8| dd d
|D d t | dk rU|dk rdnd }t d| }| | | j t u rt d||r|nd
}nt |d j |d j
|d j |d j }|j d k r | | d|j
z nG|E|
| d|j
z | }| j t u r ||nd
|_ |gS )z-long ::= '--' chars [ ( ' ' | '=' ) chars ] ;r r r Nc * g | ]}|j k
|S r r r8 or s r
r9 z parse_long..3 s 444QQVt^^q^^^r c V g | ]%}|j |j #|&S r )r r r s r
r9 z parse_long..5 s5 LLLLAF4E4Ed4K4KL1LLLr r; z is not a unique prefix: ri c 3 $ K | ] }|j V d S r r r8 r s r
r z parse_long..8 s$ +D+DqAF+D+D+D+D+D+Dr ?r Tz %s must not have an argument%s requires argument)r r r r r r r rA rX r r rB rC r )tokensr eqrC similarrB r r s @r
parse_longr . s; kkmm--c22OD"e ??4 %%%%%2%%%%%DD5E4444'444G
|z!!gmmLLLLgLLL
7||all DD$))+D+DG+D+D+D"D"D"D"D F G G G W c 11q 4x ( (q <: % %tT8h-HUUDIIA 71:#WQZ_1:&
(8
:
: :?? ll#AAF#JKKK ! }>>##+ ,,'='FGGG
<: % % $ 0eedAG
3Jr c | }| d r| d rJ | d }g }|dk rxd|d z |dd c}fd|D }t | dk r'| dt | fz t | dk rGt dd }| | | j t u rt ddd }nt |d j |d j |d j
}d}|j dk rK|dk rA| | d
z | }n|}d}| j t u r ||nd |_
| | |dk x|S ) z-shorts ::= '-' ( chars )* [ [ ' ' ] chars ] ;r r r r r; Nc * g | ]}|j k
|S r )r )r8 r r s r
r9 z parse_shorts..W s% :::E)9)91)9)9)9r z$%s is specified ambiguously %d timesTr ) r r lstripr r rA rX r r rB rC r ) r r tokenru parsedr r rC r s @r
parse_shortsr O s KKMME C ?)9)9$)?)??? ? << D
F
"**DGmT!""X t::::g::: w< >AEzQ2:: ~~''/ $ll+AE+I J JJ "KKMMEE E D|z))#(#4%%$
a3 "**4 Mr c t t j dd| t }t || }| +| dd | z t | S )Nz([\[\]\(\)\|]|\.\.\.)z \1 zunexpected ending: %rr ) r r subr
parse_exprr r r rM )r r r results r
parse_patternr r ss
8'6JJ,. .F
(
(F
~~#ll2SXXf5E5EEFFF V r c t | | }| dk r|S t | dk r
t | gn|}| dk r^| t | | }|t | dk r
t | gn|z
}| dk ^t | dk r
t | gn|S )zexpr ::= seq ( '|' seq )* ;|r; ) parse_seqr r rM r rK )r r seqr s r
r r { s
FG
$
$C
~~3
!$SA hn
3F
..
c
!
!
((c#hhll8S>""; ..
c
!
! !$F aFFO V;r c g }| dvrat | | }| dk r t | g}| ||z
}| dva|S )z seq ::= ( atom [ '...' ] )* ;)N]rj r z...)r
parse_atomrT r )r r r atoms r
r r s
F
..
"7
7
7&'** >> u $ $ t$%D KKMMM$ ..
"7
7
7 Mr c | }g }|dv rv| dt gdt gd| \ }} |t | | }| |k r| d|z |gS |dk r#| t
gS | d r|dk rt | | S | d r|d vrt | | S | d
r|
d s| r"t | gS t | gS ) ziatom ::= '(' expr ')' | '[' expr ']' | 'options'
| long | shorts | argument | command ;
z([rj r )rh [zunmatched '%s'r r r )r r <>)r r rM rP r r rR r r r endswithisupperr@ rE )r r r r matchingpatterns r
r r s
NN E
F }}
#&/h H H O'*VW556 ;;==H $ $,, /% 788 8x )
~ $ (ETMM&'*** # (5 #;#;FG,,, # (5>>##6#6 (%--// ( ''((
&&''r Fc T g }| | dk r|d | D z S | d r|t | | z
}n| d r,| dk r|t | | z
}nF|r|d | D z S | t d| | |S )zParse command-line argument vector.
If options_first:
argv ::= [ long | shorts ]* [ argument ]* [ '--' [ argument ]* ] ;
else:
argv ::= [ long | shorts | argument ]* [ '--' [ argument ]* ] ;
Nr c . g | ]}t d | S r r@ r8 vs r
r9 z parse_argv.. " ? ? ?1XdA . . ? ? ?r r c . g | ]}t d | S r r r s r
r9 z parse_argv.. r r )r r r r rX r@ r )r r
options_firstr s r
parse_argvr s' F
..
& >> t # # ? ? ? ? ?? ?
^^
(
(
.
. 9 j11 1FF
^^
(
(
-
- 9&..2B2Bc2I2I l6733 3FF
9 ? ? ? ? ?? ? MM(4 77 8 8 8 ..
& Mr c t j d| dd }d t |d d d |dd d D }d |D }|S )Nz
*(<\S+?>|-\S+?)r; c g | ]
\ }}||z S r r )r8 s1s2s r
r9 z"parse_defaults.. s @ @ @RR"W @ @ @r rU c l g | ]1}| d t | 2S )r )r rA r )r8 r s r
r9 z"parse_defaults.. s3 CCC1 c1B1BCv||ACCCr )r rD zip)docrD r s r
parse_defaultsr sh H)3 / / 3E @ @3uSSqSz5A;#?#? @ @ @ECCCCCG Nr c D t j d| }t | dk rt d t | dk rt d t j dd |dd d S ) Nz([Uu][Ss][Aa][Gg][Ee]:) z&"usage:" (case-insensitive) not found.z*More than one "usage:" (case-insensitive).z\n\s*\nr r; r )r rD r r r r )r
usage_splits r
printable_usager s (5s;;K
;!!"JKKK
;!!"NOOO
8J ABB 8 8 9 9! < B B D DDr c | dd dd fddd D z dz S )Nr; z( r c 3 8 K | ]}|d k rdn|V dS )r z) | (Nr )r8 r pus r
r z formal_usage.. s3 HHAa2a5jj77aHHHHHHr z ))rD r )r r s @r
formal_usager sV $B #((HHHHABBHHHHH H4 OOr c ( | rNt d |D r5t | d t j |r=t d |D r&t | t j d S d S d S )Nc 3 6 K | ]}|j d v o|j V dS ))z-hz--helpNrc r s r
r zextras.. s1 NNQV //. s0 JJQqv,8JJJJJJr )anyprintr sysexit)helpversionr r
s r
extrasr s NNgNNNNN
ciioo
3JJ'JJJJJ
g
r c e Zd Zd ZdS )Dictc dd d t | D z S )Nz{%s}z,
c 3 K | ] }d |z V
dS )z%r: %rNr )r8 r2 s r
r z Dict.__repr__.. s& #O#OQHqL#O#O#O#O#O#Or )r sorteditemsr# s r
rl z
Dict.__repr__ s8 #O#O& :N:N#O#O#OOOOOr N)r r r rl r r r
r" r" s( P P P P Pr r" Tc |t j dd }t | t _ t | }t
t t j | }t t |t t | | }t | t }| t D ]5}t | } t t | |z
|_ 6t! |||| | | \ }
} } |
r4| g k r.t' d | | z D S t )a Parse `argv` based on command-line interface described in `doc`.
`docopt` creates your command-line interface based on its
description that you pass as `doc`. Such description can contain
--options, , commands, which could be
[optional], (required), (mutually | exclusive) or repeated...
Parameters
----------
doc : str
Description of your command-line interface.
argv : list of str, optional
Argument vector to be parsed. sys.argv[1:] is used if not
provided.
help : bool (default: True)
Set to False to disable automatic help on -h or --help
options.
version : any object
If passed, the object will be printed if --version is in
`argv`.
options_first : bool (default: False)
Set to True to require options preceed positional arguments,
i.e. to forbid options and positional arguments intermix.
Returns
-------
args : dict
A dictionary, where keys are names of command-line elements
such as e.g. "--verbose" and "", and values are the
parsed values of those elements.
Example
-------
>>> from docopt import docopt
>>> doc = '''
Usage:
my_program tcp [--timeout=]
my_program serial [--baud=] [--timeout=]
my_program (-h | --help | --version)
Options:
-h, --help Show this screen and exit.
--baud= Baudrate [default: 9600]
'''
>>> argv = ['tcp', '127.0.0.1', '80', '--timeout', '30']
>>> docopt(doc, argv)
{'--baud': '9600',
'--help': False,
'--timeout': '30',
'--version': False,
'': '127.0.0.1',
'': '80',
'serial': False,
'tcp': True}
See also
--------
* For video introduction see http://docopt.org
* Full documentation is available in README.rst as well as online
at https://github.com/docopt/docopt#readme
Nr; c 3 2 K | ]}|j |j fV d S r rc r s r
r zdocopt..B s+ LL!QVQW%LLLLLLr )r argvr r r r r r r r r, r- r. rA rR r* r r( rx r" )
r
r) r r r r r pattern_optionsao doc_optionsr ru rv s
r
r r sT ~ |x|&s++J S!!GL)9 : :GDDG k$
33T']]# % %D',,v..//Oll:&& ? ?$S)) 3{++o=>> 4$$$$ &{{}} 2 24 8 8 GT9 M42::LL 0JLLLLLL
,,r r )NTNF)%r
r r __all__ __version__ Exceptionr r r objectr ra r} r@ rE rA rM rP rR rT rK r, r r r r r r r r r r r r dictr" r r r r
r2 s
* ? ? ? ? ?) ? ? ?
I I I I I I I IH4 H4 H4 H4 H4f H4 H4 H4V 0 0 0 0 07 0 0 0B @ @ @ @ @G @ @ @ 9 9 9 9 9| 9 9 9
h
%F %F %F %F %F\ %F %F %FP
}
% % % % %} % % %5 5 5 5 5 5 5 5
& & & & &
& & &, & & & & &] & & &
.
.
.
.
.$
.
.
. B F
<
<
< ( ( (4 0 E E EP P P
P P P P P4 P P P
V V V V V Vr