XRSrSSKJr SSKJr SSKJr SSKrSSKrSSKrSSKrSSK r SSK r SSK r SSK r SSK r SSKJr SSKJr SSKJr SS KJr SS KJr SSKrS rS rS rSr"SS\5r"SS\5r"SS\R<5rSr S4Sjr!S5Sjr"Sr#Sr$"SS\ RJ5r&SS\&RNS4Sjr(Sr)S r*S!r+S6S"jr,S#r-S$r.S%r/S&r0S'r1S7S(jr2S4S)jr3"S*S+\5r4S,r5\ Rl4S-jr7S.r8S/r9S0r:S1r;S2r 1cmmA& > E ==I=aCMM!,<a,H=I!Lf ]]6 ""&+4==q "55 ?Js C =!C"Cr/r)) rrr r!r"rr+r6rAr#r$rrr&r&?s- ' *6rr&c\rSrSrSrg)ArgumentWrapperzr$N)rrr r!r#r$rrrDrDzsrrDcv[R"S[RS-[R-U5$)Nz(\b[a-zA-Z][-a-zA-Z_0-9]*)z\1)resubrMARKDOWN_ITALIC)msgs r_ApplyMarkdownItalicrK~s2 # U"T%9%99  rFcUR=(d URR5nU(a [U5nURS:XaSR US9$URS:XaSR US9$UR[ R:XaSR US9$URS:XaSR US9$U$) zCreate the usage help string for a positional arg. Args: arg: parser_arguments.Argument, The argument object to be displayed. markdown: bool, If true add markdowns. Returns: str, The string representation for printing. +z{var} [{var} ...])var*z [{var} ...]z[-- {var} ...]?z[{var}])metavardestupperrKnargsformatargparse REMAINDER)r>markdownrNs rGetPositionalUsagerYs 'sxx~~'# s #CYY#  % %# % .. yyC   C  (( yyH&&&  " "s " ++ yyC     $$ JrcUc-UR=(d URR5nU(aURS5(aSOSn[ UR [ R5(a8UR R[UR5U5=(d UnUS:XagU(a [U5nUS:XaXA-nSnURS;a SU-S-nSnXA-$)z-Returns a usage-separator + metavar for flag.--= r)rPrO[]) rQrRrS startswith isinstancetyper ArgTypeUsageGetUsageMetavarboolrKrT)flagrQnamerX separators r_GetFlagMetavarris _ll/diioo/Gdood33c) 1>>??ii''T\\(:GDOG ^  "7+G#!GI ZZ:Gmc!GI  rcj[U5nURS5(aSU;a SUSS-S-nU$)z0Returns value quoted, with preference for "...".'"r)reprr`)valuequoteds r _QuoteValuerqs= ;& s5 0 6!B< # %F -rcU$)zMockable flag name list filter.r$)namess r_FilterFlagNamesrts ,rc \rSrSrSrSrSrSrg) InvertedValuerrr$N)rrr r!NORMALINVERTEDBOTHr#r$rrrvrvs & ( $rrvTc \U[RLa6[UR5Vs/sHoUR SSS5PM nnO^U[R La6[UR5Vs/sHoUR SSS5PM nnO[UR5n[ U5nUR=(d URR5nU(aU(a8USnU(aURS:XaU$[XUS9n SRXS 9$URS:XaaU(aFS RUVs/sH'n[R U-[R -PM) sn5n U $S RU5n U $/n UH\n [XXS 9n U R#S RU(a[R OSU U(a[R OSU S 95 M^ S RU 5n UR$(Gaf['US['USS55(GdH[)UR$[*5(aSRUR$5n O[)UR$[,5(a]SR[[.R0"UR$55VVs/sHupSRX5PM snn5n O UR$n [3U 5nU(a_[4R6"S[R [R8[R:S3U5(aSRU5nU SRU5- n U $s snfs snf![a SnGNf=fs snfs snnf)a'Returns the usage string for a flag arg. Args: arg: parser_arguments.Argument, The argument object to be displayed. brief: bool, If true, only display one version of a flag that has multiple versions, and do not display the default value. markdown: bool, If true add markdowns. inverted: InvertedValue, If INVERTED display the --no-* inverted name. If NORMAL display the normal name. If BOTH, display both. value: bool, If true display flag name=value for non-Boolean flags. Returns: str, The string representation for printing. r[z--[no-]r--no-rrrgz{flag}{metavar})rfrQ, )rgrXz{bb}{flag}{be}{flag_metavar})bbrfbe flag_metavar is_requiredrequiredF,z{0}={1}r^r_z```{}```z ; default={0})rvr{sortedoption_stringsreplacerzrtrQrRrS IndexErrorrTrirUjoinr MARKDOWN_BOLDappenddefaultgetattrralistdictr< iteritemsrqrGsearchrI MARKDOWN_CODE)r>briefrXinvertedroxrsrQ long_stringrusage usage_listrgrkv default_texts r GetFlagUsagers"###4:3;M;M4N O4NqYYtY *4NE OE=)))289K9K2L M2LQYYtWa (2LE ME 3%% &E 5 !% KK +388>>+' %!Hk CIIN "3kBL  # # # KKYY!^ii@E F14   !D$6$6 6 FeJ ,CiieB ,?J$SPl ( / /'/##R'/##R' 0  IIj !E {{{7 ]GCU; CKK & &((3;;' ckk4 ( (((s}}S[[9: :   Q ":   ++ )l bii d  !$"6"6!78J8J7K1 M "((6  %%l33e ,o P M k G. s)N4N /N .N# N(  N N cBURSRSSS5$)z(Returns the inverted flag name for flag.rr[r}r)rr)rfs r_GetInvertedFlagNamers"  Q  ' 'gq 99rcJU(aURS5(aU$US-$)N.)endswith) help_messages r _Punctuaters& ..s33  # rcX;aU$URS5=n(aUUS-S:XaUSUS3$URS5S:a[U5SU3$[U5SU3$)z-Appends extra_help_message into help_message. rr] r)rfindr)rextra_help_message newline_indexs r_AppendExtraHelprs' %++D11 1|a8 8 ^4 232 66&!A%& 't,>+? @@& 'q);(< ==rc [USUR5n[U5(aU"5nU(a[R"U5OSnUR (aU$UR (dUR(aSnSnOYUR(aURn[US/5nO.URRn[URS/5n/n[US5(aURun n[R"U5U;ajURSR!U55 UR"(a9UR$S;a)URSR!['U555 OUR (d"UR(dUR$(aOUR"S La*URS R!['U555 OV[)U[*R,5(a7URS R!UR.S ['U555 U(GaUR0=(d UR2R55n U S :wGay[USU5n[7U5[7U5- S:aSn OSn [)U[85(a[R:"U5n [)U[<R>5(d [AU 5n /nU HNupX;aM [R"U 5nSR!U USU[B--S9nURU5 MP URSU[B--5 URSR!XSREU5S95 OWURSR!U U SREUVs/sHnUU;dM SR!U5PM sn5S95 [USS5n[)U[FRH5(aUR.(aUR.S OSnU=(a [JRL"U5nURROUURPUS9nU(a-UR[FRR"UU[T-55 S REU5nURW5nU(aU(a [YUU5nO U(aUnOUnUR[SS5R]5$![a SnSnGN_f=fs snf)zrrrr,r extra_helpprop_rQrchoices_iteritemsrgr dedented_desc choice_helprarg_typearg_namertype_help_textr stripped_helpall_helps r GetArgDetailsr1suc=#((3) i I/8+b,]] \\S&&GN {{kkGS"2B7N?  g sxx)92>n* S"####JD!Q }}T,. **0&, #))x/ " ) )*>s*C D  ||s((CII {{d3::  %  #{77883::   q !#7#<   kk-SXX^^-G#~^W5g WN+ +a /1 GT " "MM'2';#:#:;;$%67 +JD  # "//$/-077 5>128 + .. %, sen456 < C C '8J D   6 = = /6#/6!.&GNN1%w# >  S&$ '(0==>>(+(:(:s!!!$HCk99(CJXX..8/N / /e&99  xx +%%'-M /ABH!HH   &' * 0 0 22S gnR#s4T/ UU/UUcUR(agUR(agUR(a%URHn[ U5(dM g g)zHReturns True if arg is a positional or group that contains a positional.FT)rrr arguments _IsPositional)r>as rrrs@]]  \\ ]] q   rcU(dgURS5(aSUSSS4$URS5(aSUSS4$URS 5(aS US S4$US R5(ag SU4$)z.Arg name usage string key function for sorted.)rrr}r Nrr[rx-rrrr)r`isalphar~s r_GetArgUsageSortKeyrs  w d12h  t d12h; s d12h; Aw  d7NrcpSnURHFnUR(aMUR(a[U5nU(d gU(a gUnMH U(aV[ U[ 5(dAUR UR :wa'[R"U5nUR UlU$)zs rrrs) ^^c }} ||  c  I//   4#3#3 3 )$I ,,I rc[R"SS[R"SS[USSS9=(d S55nUR(a[ U5nU(aUnUR(a*[ U5(agUR (aS U4$S U4$UR[R:XaS U4$UR(agUR (aS U4$[U5$) zArg key function for sorted.z +r]z [](){}|[]rFT)rohiddenrrx) rGrH GetArgUsagerrrrrTrVrWrr)r>rgrs r GetArgSortKeyrs   ff["k#U4HNBO $  \\S!I c\\S   Wn d7N yyH&&& d7N __ d7N T ""rc`[R"SU5(aU$SRU5$)zCReturns usage enclosed in [...] if it hasn't already been enclosed.z^\[[^][]*(\[[^][]*\])*[^][]*\]$z[{}])rGr@rU)rs r _MarkOptionalrs*XX0%88 L u rc  UR(aU(dgUR(aC[U5n U (a1U R(dU R[R :waU nUR(dUR (a [XS9n Ou[U[R5(a[Rn O:U(d#[USS5(a[Rn O[Rn [!XX;US9n U (a#U(aUR"(d [%U 5n U $UR&(aSOSn /n /n/nUcSn/nOSnUR((a[+UR,[.S 9O UR,nUGHnUR(a U(dMUR(a[U5n U (aU nUR(d:UR[R :XaUR1[3UX7US 95 M[5U5(aU R1U5 M[3UX7US 9n U (dMUR"(aX;aUR1U 5 MMU(a [%U 5n X;dGM UR1U 5 GM /n/nS nSnU (a|S nU HRn[3UX8S 9n U (dMUR"(dSnU n[%U 5n U U:waUS - nUR1U 5 MT U(aSR7USSU-5US'U(a UR1U R9U55 U(atU(aNU(d&U (aU(aU(aUR1S5 UR1U R9U55 OU(aU(aUR1S5 U(aU[+U[:S 9-nOUU-nU(a'U(a UR1SR9U55 SR9U5n UR"(aSR7U 5$U(d[=U5S :a [%U 5n U $)aReturns the argument usage string for arg or all nested groups in arg. Mutually exclusive args names are separated by ' | ', otherwise ' '. Required groups are enclosed in '(...)', otherwise '[...]'. Required args in a group are separated from the optional args by ' : '. Args: arg: The argument to get usage from. brief: bool, If True, only display one version of a flag that has multiple versions, and do not display the default value. definition: bool, Definition list usage if True. markdown: bool, Add markdown if True. optional: bool, Include optional flags if True. top: bool, True if args is the top level group. remainder_usage: [str], Append REMAINDER usage here instead of the return. value: bool, If true display flag name=value for non-Boolean flags. hidden: bool, Include hidden args if True. Returns: The argument usage string for arg or all nested groups in arg. r)rXinverted_synopsisF)rrXrro | r]Tkey)rXrorr)rXrrz{}{}rmr_rz[optional flags]z({}))rrrrTrVrWrrYrarrrvr{rrzryrrris_mutex sort_argsrrrrrrrUrrr)r>r definitionrXoptionaltopremainder_usagerorrrrseppositional_argsrequired_usageoptional_usageinclude_remainder_usagerrpositional_usageall_other_usagenestingoptional_positionals usage_orig all_usages rrrs@ ]]6 \\S!Iioo1C1CC c   8e C99 : : %%gc+>FF"++("))( Xe S__E"e L3#/.."O#  S]] . == a{{6zzq/i   ::!''X%7%77 a( G q  Q!hFKe    &    & ' &%  &    &1 2/ 'G !h>e  ]]# e$ J  Q,'e$#]]+;B+?wOr388N34  "6.s#SXXn56 3/0  60$I!?2I0 SXXo./ ((9 %__ ==  Y!# % E ,rc^^^[5mT(aTRS5 SUUU4SjjmT"U5 [T[S9$)zReturns the list of all flags in arg. Args: arg: The argument to get flags from. optional: Do not include required flags if True. Returns: The list of all/optional flags in arg. --helpc>UR(agUR(a8U(aU(a URnURH nT"XS-US9 M g[ USS5nU(aUnUR (alUR (dZUR(dHT(aU(aUR(d(TR[UR 5S5 ggggg)z%GetFlags() helper that adds to flags.Nr)levelr show_invertedr) rrrrrrr is_globaladdr)r>r rr _GetFlagsHelperflagsrs rr !GetFlags.._GetFlagsHelpers }}  || 8??#19x@c?D9m    ##--83?? &++,Q/04C $ rr)rT)setr rr)r>rr rs `@@rGetFlagsrs= %%  IIh110# . //rc\rSrSrSrSrSrg)SectionizA positional/flag section. Attribute: heading: str, The section heading. args: [Argument], The sorted list of args in the section. cXlX lgr))headingr)rrrs rrSection.__init__s LIr)rrNrr$rrrrs rrc ^^^[R"5m[5n[5nU(d U(aS1nUGHznUR(aM[ U5(a#SnUT;a/TU'TUR U5 MJUR (aU(dUR(a UROU/HjnUR(dMUR(aM)URSn U(aMAU RS5(dMYURU 5 Ml MUR(aSnO[USS5=(d Sn[US 5(a.URU;aGM@URUR5 UT;a/TU'TUR U5 GM} /n U(aS mO[ R"mU(a*SSTS/n [%TV s/sH oU ;dM U PM sn 5mOSST/n TV s/sH oU ;dM U PM sn mUUU4S jn U T-H7nUT;aM U R ['U "U5[)TUUS 955 M9 X4$s sn fs sn f) aReturns the positional/flag sections in document order. Args: arguments: [Flag|Positional], The list of arguments for this command or group. is_root: bool, True if arguments are for the CLI root command. is_group: bool, True if arguments are for a command group. sort_top_level_args: bool, True if top level arguments should be sorted. Returns: ([Section] global_flags) global_flags - The sorted list of global flags if command is not the root. rzPOSITIONAL ARGUMENTSrr[REQUIREDcategoryNOTHERrRGLOBALc>US:Xa9[T5[S/5- (aSnU$TT;aSnU$ST;aSnU$SnU$SU;dSU;aU$US-$)z4Returns the arg section heading for an arg category.rFLAGSz OTHER FLAGSrzOPTIONAL FLAGS ARGUMENTSz FLAGS)r)rother_flags_heading categoriescommonremaining_categoriess r_GetArgHeading&GetArgSections.._GetArgHeadings7 ! "S'^ 3%! Z + !  #.! &  h'X"5 o h r)rr)rrrrrrr rrrr`r rrrrRrCOMMONLY_USED_FLAGSrrrD)ris_rootrsort_top_level_argsdests global_flagsr>rrrfsectionsinitial_categoriesr?r#r r!r"s @@@rGetArgSectionsr,s=&&(* %%, X:L c }}S'h  #! 8!!#& }}W # s}}3%7!   AKKK!!!$$dood33   T " 8  hj$/:7hsF U  iiz!jx$5F( F  % %F0*fgN!>Jq+="=J>1*fEa*I6 I;"I;c^^U4SjmU4SjnSU-S-R[R"SX2- S9RUR SS555R S S 5n[ U5U[ U5- S - :a%U"U<U<35 T"S U-S-5 U"U5 gT"U<U<35 U"S U[ U5- [ U5- S- -SU4-5 g)aHelper function that does two-column writing. If the first column is too long, the second column begins on the next line. Args: prefix: str, Text for the first column. message: str, Text for the second column. indent: int, Width of the first column. length: int, Width of both columns, added together. spacing: str, Space to put on the front of prefix. writer: file-like, Receiver of the written output. c(>TRU5 gr))write)swriters rWWrapWithPrefix..WDs LLOrc>T"US-5 g)Nrr$)r0r2s rWlnWrapWithPrefix..WlnGsa$hKrz %%%dsr]F)break_on_hyphenswidthrz&| z&|z |rxz%%%dsz %%%ds %%srN)rr TextWrapperwraprr)prefixmessageindentlengthspacingr1r5r2s ` @rWrapWithPrefixr@6s6C t   $FO D. / wtT  [6CL(1,,'6"#gL  !vF +c'l:Q>?3.Prc ^TR5 SRTR55n[TR55S:=(a TR5SS:HnU(aSOSn[R "5nUR S5 /nU(dUR[USSSS 95 TR5nTR5n[U4S j[R"U555n [U4S j[R"U555n /n U (aU RS 5 U (aU RU5 U (dU (a&URS SRU 5-5 Sn O [USS9n SRU5n SRUS9nUR X-S-5 U (a%[!SSRU 5["[$SUS9 U (a([!SU-SRU 5["[$SUS9 U (a%[!SSRU 5["[$SUS9 UR S['T5-5 UR)5$)a#Return the command Usage string. Args: command: calliope._CommandCommon, The command object that we're helping. argument_interceptor: parser_arguments.ArgumentInterceptor, the object that tracks all of the flags for this command or group. Returns: str, The command usage string. r]rxrtopiccommandzUsage: TF)rrrc3|># UH1upTR5(dUR(aM-Uv M3 g7fr)IsHiddenr.0rg help_inforCs r GetUsage..s49 4     9#6#6 d9,< <c3|># UH1upTR5(dUR(aM-Uv M3 g7fr)rErGs rrJrKs4; 4     9#6#6 d;rLgroupz<%s>rN)rz {command} rCrz group may bez )r?r1z %s may bezoptional flags may be)LoadAllSubElementsrGetPathrioStringIOr/rrGetSubGroupHelpsGetSubCommandHelpsrr<rrrUr@ HELP_INDENT LINE_WIDTH GetHelpHintgetvalue)rCargument_interceptor command_pathrB command_idbuf usage_parts group_helps command_helpsgroupscommands all_subtypesoptional_flags usage_msg non_options` rGetUsagerggs' '//+,, goo A % I'//*;A*>'*I%wY* #))I+ (u$O((*+,,.- "}}[9 & "}}];( ,    # xv < 889N2TBNhh{#)""<"8*))J "T )*  6 j  8  >" ))D;w' '( rc^^^SmSmU4SjnUU4SjnU"U5(dg[R"5nTU;a U"XAT5 TU;a U"XAT5 UR5$)aConstructs an alternative Usage markdown string organized into categories. The string is formatted as a series of tables; first, there's a table for each category of subgroups, next, there's a table for each category of subcommands. Each table element is printed under the category defined in the surface definition of the command or group with a short summary describing its functionality. In either set of tables (groups or commands), if there are no categories to display, there will be only be one table listing elements lexicographically. If both the sets of tables (groups and commands) have no categories to display, then an empty string is returned. Args: command: calliope._CommandCommon, The command object that we're helping. categories: A dictionary mapping category name to the set of elements belonging to that category. Returns: str, The command usage markdown string organized into categories. rC command_groupc d>Sn[X5S:Xa[RX;aSnURS5 URSR SR UR S55SR TR55S95 [[R"X55HupEU(dURS R US 95 URS 5 [US S 9HnSnURS:XaURSSnOLURS:XaURSSnO,URS:XaURSSnO URnURSR URRSS5US95 M M g)z=Writes the markdown string to the buffer passed by reference.FrTrz!# Available {type}s for {group}: r]r)rbrNz ### {category} )r---------------------- | --- cUR$r)r~es rJGetCategoricalUsage.._WriteTypeUsageTextToBuffer..sAFFrrNalpha beta preview {name} | {description} rrg description)rrUNCATEGORIZED_CATEGORYr/rUrsplitrQrr<rrg short_helpr) r]r key_namesingle_category_is_otherrelementselementr|rCs r_WriteTypeUsageTextToBuffer8GetCategoricalUsage.._WriteTypeUsageTextToBuffers$ J !Q&  ' ':+? ?!%IIfII,33(..-.((7??,- 4  %S]]:3G%HI % (///BC ii01H*:;' <<7 "))"#.* \\V #))!"-* \\Y &))"#.*))* & - -\\))#s3 .  < Jrc&>UTR5(dUTR5(dg[[UTR55[UTR55-5[[R/5:Xagg)zQEnsures the categorization has real categories and is not just all Uncategorized.FT)keysrrrrz)r command_group_key command_keys r_ShouldCategorize.GetCategoricalUsage.._ShouldCategorizes { # ( ( * *,-2244   Z $ ) ) +, z+,113 4 5 d)) * +, rr)rRrSrY)rCr rrr]rrs` @@rGetCategoricalUsagersg*+%! F  : & &  #*$1BCJ= rc vURSRUSRUR55S95 URS5 [ USS9H]nUR 5(aMURSRUR RSS 5URS 95 M_ g ) aDHelper method to GetUncategorizedUsage(). The elements are written to a markdown table with a special heading. Element names are printed in the first column, and help snippet text is printed in the second. No categorization is performed. Args: command: calliope._CommandCommon, The command object that we're helping. elements: an iterable over backend.CommandCommon, The sub-elements that we're printing to the table. element_type: str, The type of elements we are dealing with. Usually 'groups' or 'commands'. writer: file-like, Receiver of the written output. z(# Available {element_type} for {group}: r]) element_typerNrkcUR$r)r~rms rro*_WriteUncategorizedTable..+srrrwrrrxN) r/rUrrQrrFrgrr|)rCrrr1rs r_WriteUncategorizedTablers ,,188#388GOO4E+F9  ,,/0&67g LL"))%%c3/W=O=O * 8rcF[R"5nUR(a%[XRR 5SU5 UR (a6UR S5 [XR R 5SU5 UR5$)aConstructs a Usage markdown string for uncategorized command groups. The string is formatted as two tables, one for the subgroups and one for the subcommands. Each sub-element is printed in its corresponding table together with a short summary describing its functionality. Args: command: calliope._CommandCommon, the command object that we're helping. Returns: str, The command Usage markdown string as described above. rarrb)rRrSrarvaluesrbr/rY)rCr]s rGetUncategorizedUsager5so # ^^Wnn&;&;&=xM IIdO!!((*J rcZSRSRUR55S9$)NzUFor detailed information on this command and its flags, run: {command_path} --help r])r[)rUrrQrOs rrXrXOs*  F!23F45rc U(aUR5nUVs/sHo"R5PM nnURS5nSRUSU5nSRXS-S5n[R "U5R5nU(d%SRUWS-S5R5nXW=(d U4$gs snf![ a$ SRU5R5nSnNkf=f)a~Extracts short help and long help from a docstring. If the docstring contains a blank line (i.e., a line consisting of zero or more spaces), everything before the first blank line is taken as the short help string and everything after it is taken as the long help string. The short help is flowing text with no line breaks, while the long help may consist of multiple lines, each line beginning with an amount of whitespace determined by dedenting the docstring. If the docstring does not contain a blank line, the sequence of words in the docstring is used as both the short help and the long help. Corner cases: If the first line of the docstring is empty, everything following it forms the long help, and the sequence of words of in the long help (without line breaks) is used as the short help. If the short help consists of zero or more spaces, None is used instead. If the long help consists of zero or more spaces, the short help (which might or might not be None) is used instead. Args: docstring: The docstring from which short and long help are to be taken Returns: a tuple consisting of a short help string and a long help string rr]Nrr)rr) splitlinesrindexrrr ValueError) docstringunstripped_doc_linesr0stripped_doc_linesempty_line_indexr| raw_long_help long_helps rExtractHelpStringsrVs4$//1-AB-A'')-AB+11"588./@0@ABjii 45I5K LMm//-0668i 88./?!/C/EFGMMOj /Z 00 C 88./557jisCAC+DD)F)NNF)r)FFFTFNTF)>r" __future__rrrrVrrr9enumrRrGsysrgooglecloudsdk.callioperrrr googlecloudsdk.calliope.conceptsr rr<rWrVrrobjectrr&ArgumentrDrKrYrirqrtEnumrvryrrrrrrrrrrrrrr,stdoutr@rgrrrrXrr$rrrs^ 6&'  /:(4@   'v'"86&86v&//2(  DII u}/C/C4IX: >&z3z   2#4      Nb'0T f d NEHJJ.bXvQh>45*r