+ HjjRt^RIHt^RIt^RIt^RIHt^RIHt^RIHt^RIH t ^RIH t ^RIH t ^R IH t ^Pt ^t^tR0R ltR0R R lltR1R RlltRRltRtRtRtRtRtRtRtRtRtR2RltR3RltRRltRt R4Rlt!R t"R!t#R5R"lt$R#t%R$t&R%t'R&t(R0R'lt)R(t*R)t+R*t,R6R+lt-R,t.^^] 3R-lt/!R.R/4t0R#)7aUtilities for producing help strings for use in Fire CLIs. Can produce help strings suitable for display in Fire CLIs for any type of Python object, module, class, or function. There are two types of informative strings: Usage and Help screens. Usage screens are shown when the user accesses a group or accesses a command without calling it. A Usage screen shows information about how to use that group or command. Usage screens are typically short and show the minimal information necessary for the user to determine how to proceed. Help screens are shown when the user requests help with the help flag (--help). Help screens are shown in a less-style console view, and contain detailed help information. ) annotationsN) completion)custom_descriptions) decorators) docstrings) formatting) inspectutils) value_typesc\P!V4p\WR7p\P!V4p\P !V4p\ WWR7p\WWVVR7p\W4p \V4'd\W5V4wrM.p .p \VV4p WxV .V ,V ,V ,p V Uu.uF qfKVNK ppRPRV44#uupi)aqGets the help string for the current component, suitable for a help screen. Args: component: The component to construct the help string for. trace: The Fire trace of the command so far. The command executed so far can be extracted from this trace. verbose: Whether to include private members in the help screen. Returns: The full help screen as a string. verbose)tracer )r  c3<"TFwr\W4xK R#5iN)_CreateOutputSection).0namecontents& ڏ/home/ubuntu/.hermes/installs/5f0a1ff4045d044e/environments/50f6b671e3f94b538e344231dfcb664f/venv/lib/python3.14/site-packages/fire/helptext.py HelpText..[s!)-$4)))s) rInfo_GetActionsGroupedByKindGetFullArgSpecr GetMetadata _NameSection_SynopsisSection_DescriptionSectioncallable_ArgsAndFlagsSections_UsageDetailsSectionsjoin) componentr r infoactions_grouped_by_kindspecmetadata name_sectionsynopsis_sectiondescription_sectionargs_and_flags_sectionsnotes_sectionsusage_details_sectionssectionssectionvalid_sectionss&&& rHelpTextr12s   9 %$4YP  $ $Y /$  # #I .(iUL,%$G+I<i.C H/+^!N01HJ':;   ,4K8GG8.K ) Ls C, C,cV^8dQhRR/#returnztuple[str, str])formats"r __annotate__r8asc \W#R7p\V4p\P!V4'dD\\ , \ VR,4, p\P!W\4pV'd V RV 2pRV3#TpRV3#)z&The "Name" section of the help string.include_separatorsz - NAME)_GetCurrentCommand _GetSummaryrNeedsCustomDescription LINE_LENGTHSECTION_INDENTATIONlen GetSummary)r#r$r r current_commandsummaryavailable_spacetexts&&&& rrras'uI/  '// ::!$77#o>C?D;EEO!,,Y-8:G  c' +D $ D $r9cV^8dQhRR/#r3r6)r7s"rr8r8vs$3r9cd\VRR7p\V4p.pV'dVP\V44\ V4'dI\ W#4pV'dVPV4M#V'dVPVP 4RPV4p V RV 2p RV 3#)z*The "Synopsis" section of the help string.T)r r< |  SYNOPSIS)r>_GetPossibleActionsappend_GetPossibleActionsStringr_GetArgsAndFlagsString separatorr") r#r%r&r'r rEpossible_actions continuationscallable_continuation continuationrHs &&&&& rrrvs'UtL/()@A-23CDE i24B01 5??+M*,  Al^ ,$ d r9cV^8dQhRR/#)r4r5ztuple[str, str] | Noner6)r7s"rr8r8s,Br9c>\P!V4'dI\\, p\P!W\4p\P !W\4pM\ V4p\V4pT;'g T;'gRpV'dRV3#R#)a'The "Description" sections of the help string. Args: component: The component to produce the description section for. info: The info dict for the component of interest. Returns: Returns the description if available. If not, returns the summary. If neither are available, returns None. N DESCRIPTION)rr@rArBGetDescriptionrD_GetDescriptionr?)r#r$rG descriptionrFrHs&& rrrs// ::!$77O%44Y5@BK!,,Y-8:G"$'K$G  ' ' ' '4$ 4  r9c8\WW VP9VR7#)required short_arg)_CreateFlagItemkwonlydefaults)flagdocstring_infor&r`s&&&&r_CreateKeywordOnlyFlagItemres"  Dt7J7J+J r9cVUu.uF q^,NK pp\P!V4pVUu.uFqCV,^8XgKVNK up#uupiuupi)zGets a list of single-character flags that uniquely identify a flag. Args: flags: list of strings representing flags Returns: List of single character short flags, where the character occurred at the start of a flag once. ) collectionsCounter)flagsf short_flagsshort_flag_countsvs& r_GetShortFlagsrnsV %%u!1u+%!))+6 >[a$8A$=!![ >>& >sAAAc JVPR\VP4\VP4, pVP\VP4\VP4, RpVP\P 4p.p.pVR,pVU u.uFp \ WV4NK p p VP'd&V P\ VPW44V 'daV'dRMRp V RPV 4PR43p VPV 4V'dV'dVPR4\V4p VUu.uFp\WVRV^,V 9R7NK pp\VP4pVPUu.uFp\WVV^,V9R7NK ppVV,pVP'Edo.pVP;'g.pVUu.uFpVP NK pp\V4pVFp\#V\$P&4'gK%VP ^,V9d'VP ^,pR V R VP 2pMR VP 2p\VP WVR 7pVPV4K V'd;V'd"R p\)VR^R7pVPV4VP+V4\-VPV4pV'dRpM V'dRpMRp\)VV^R7pVPV4V'd%RRPV43pVPV4Wg3#uup iuupiuupiuupi)z1The "Args and Flags" sections of the help string.NrdzPOSITIONAL ARGUMENTS ARGUMENTS Fr^)r`-z, ----) flag_stringz&The following flags are also accepted.indentz3Additional undocumented flags may also be accepted.zAdditional flags are accepted.zFlags are accepted.FLAGS)NOTESz6You can also use flags syntax for POSITIONAL ARGUMENTS)argsrCdefaultsgetrACCEPTS_POSITIONAL_ARGS_CreateArgItemvarargsrOr"rstriprnra kwonlyargsrevarkwr isinstancer KwargInfo _CreateItemextend_GetArgDescription)r$r&r'args_with_no_defaultsargs_with_defaultsaccepts_positional_argsr+r,rdarg arg_itemstitlearguments_sectionunique_short_argsrcpositional_flag_itemsunique_short_kwonly_flagskwonly_flag_items flag_itemsdocumented_kwargsrirj flag_namesunique_short_flags short_namert flag_itemmessageitemr\ flags_sections&&& rr r sX))$HS^c$--6H%HIyyTYY#dmm2D!D!EF%LL)K)KL.().'&#S$/&   \\\ t||^:&= ";E ) 4 ; ;D AB""#45!8 M%%78 %  %$  uG00% -T__= //  "$ ! G88" %'88* ZZZ    % %2E"'(%Q!&&%J(' 3 D*.. / / 99Q<- -yy|*J[]...rL)ryrCrzr{rr|r UnderlineupperrrrrOr~r") r&r'rrrarg_and_flag_stringsr arg_stringsvarargs_underlinedvarargs_strings && rrQrQ:s}&))$HS^c$--6H%HIyyTYY#dmm2D!D!EF%LL)K)KL 57 5 ))#))+6 57k +*c se1Z))#))+67 8* ,4???djjj * \\\#--dll.@.@.BC+,D1N/ & ''%7s .-G "3Gcz.pVF2pVP'gKVPVP4K4 V#)z"The list of possible action kinds.)rrOr)r%rS action_groups& rrNrNks:-ll//0. r9c2RPRV44#)zAA help screen string listing the possible action kinds available.rKc3j"TF)p\P!VP44xK+ R#5ir)rrr)ractions& rr,_GetPossibleActionsString..vs+4"2((88"2s13r")rSs&rrPrPts 4"24 44r9c\RRR7p\RRR7p\RRR7p\RR R7p\P!WR 7pVFwrx\V4p\P !V4'dVP WxR 7\P!V4'dVP WxR 7\P!V4'gKVP WxR 7K \V\\34'diV'da\V4p V ^ 8d3VP R PR \V 444R7MVP RV ^, 2R7W#WE.#)z8Gets lists of available actions, grouped by action kind.groupr)rpluralcommandrvaluerindexrr )rmember, c38"TFp\V4xK R#5ir)str)rxs& rr+_GetActionsGroupedByKind..s F1EAQ1Es)rz0..) ActionGrouprVisibleMembersrr IsGroupAdd IsCommandIsValuerlisttuplerCr"range) r#r rrrrr member_namer component_lens && rrrzs# GH 5& i ;( GH 5& WY 7'  % %i A'$kk"K6"" jjkj1V$$ll l36"" jjkj1% D%=))i NMr kktyy F}1E FFkG kk]1_-.k/ F ,,r9cBV'dVPVR7pV#RpV#)z@Returns current command for the purpose of generating help text.r;) GetCommand)r r<rEs&& rr>r>s. &&:L&MO O r9c$V^8dQhRRRRRR/#)r4rrrr5r6)r7s"rr8r8s!55s5S5S5r9cj\P!V4 R\P!V\4 2#rq)rBoldIndentrB)rrs&&rrrs4ood# $% 7/01 55r9cr\\, \, p\W4p\P !VP 44p\W4pV'dRV 2MRpV\V4, p\P!WgV4pRPRWd344p\WT\R7#)aReturns a string describing a positional argument. Args: arg: The name of the positional argument. docstring_info: A docstrings.DocstringInfo namedtuple with information about the containing function's docstring. spec: An instance of fire.inspectutils.FullArgSpec, containing type and default information about the arguments to a callable. Returns: A string to be used in constructing the help screen for the function. Type: rrqc38"TFq'gK VxK R#5irr6rparts& rr!_CreateArgItem..sK+B4d$$+B  ru) rArBSUBSECTION_INDENTATIONrr BoldUnderliner _GetArgTyperCEllipsisTruncater"r)rrdr&max_str_lengthr\ arg_stringarg_typerGs&&& rr}r}s !447MM."37+'' 4*  #($,vhZ "("S]2/!!(^L  KH+BKK+ Z5K LLr9c\\, \, p\W4pV'g-\P !VP 44pRV RV 2pV'd VR, pV'dV^,p RV RV 2p\W4p \W4p V R8XdRV R2p V 'dR V 2MR p V\V 4, p \P!WV4p V 'dR V 2MR p V\V 4, p \P!WV4p R PR WV344p\WG\R7#)aReturns a string describing a flag using docstring and FullArgSpec info. Args: flag: The name of the flag. docstring_info: A docstrings.DocstringInfo namedtuple with information about the containing function's docstring. spec: An instance of fire.inspectutils.FullArgSpec, containing type and default information about the arguments to a callable. required: Whether the flag is required. flag_string: If provided, use this string for the flag, rather than constructing one from the flag name. short_arg: Whether the flag has a short variation or not. Returns: A string to be used in constructing the help screen for the function. rsrz (required)rrrNonez Optional[]rrz Default: rqc38"TFq'gK VxK R#5irr6rs& rr"_CreateFlagItem..s;ttdd;rru) rArBrrrrrr_GetArgDefaultrCrr"r) rcrdr&r_rtr`rr\flag_name_upper short_flagr arg_defaultrGs &&&&&& rraras=0!447MM."48+  **4::<8OtfAo./K = KaJj\K=1K  $(t*+F8*A&H$,vhZ "("S]2/!!(^L .9)K=)b+"S%55/!!+O  {;+ [6L MMr9cWP9d!VPV,pVP#R# \d\T4u#i;i)alReturns a string describing the type of an argument. Args: arg: The name of the argument. spec: An instance of fire.inspectutils.FullArgSpec, containing type and default information about the arguments to a callable. Returns: A string to be used in constructing the help screen for the function, the empty string if the argument type is not available. r)r __qualname__AttributeErrorrepr)rr&rs&& rrrsS  $H  " "" (^ s 3A  A c \VP4pVPV)Rp\W1P4FwrEW@8XgK \ V4u# WP 9d\ VP V,4#R#)aReturns a string describing a flag's default value. Args: flag: The name of the flag. spec: An instance of fire.inspectutils.FullArgSpec, containing type and default information about the arguments to a callable. Returns: A string to be used in constructing the help screen for the function, the empty string if the flag does not have a default or the default is not available. Nr)rCrzryziprrb)rcr& num_defaultsrrdefaults&& rrrsqT]]#,yy,0,mmCreates a usage details section for the provided action group.rdN)GetItemsrrr{rr@rFrDrArBrrOrrrr)r item_stringsrrr$rrdrFs& rrr@s,"++-ld   V $D DXX./N#::6BB&&g  3 3F ; ;#.. + 33[Bgg t %D.    # # % \..446 E GGr9c.pVP4Fwr4?\P!VPP4pRpRV9dWVR,pVP 'd<VP F+pVP V8XgK\W8P4pK- Vf \V4pVPV4K R\RV43#)zDCreates a section tuple for the values section of the usage details.NrdVALUESVALUE) rrr __class____init__ryrrr\rrOr) r#rvalue_item_strings value_namer init_info value_iteminit_docstring_infoarg_infos && rrrUs!??,j !!)"5"5">">?IJ9$%&67  ! ! !+00H ]]j ($Z1E1EFJ1z?jj)- &w0BC DDr9c\P!\P!V44p\V R2RRP V4,^R7#)z is one of the following:rqrru)rrrrr")rchoicesname_formatteds&& rrrhsH??:#7#7#=>.  12 V[[ !!  r9cV'd"VP4pVP4pMRpRpV'gRpTp\P!V4p\P !V4p\ WR7p\V4p .p V 'dV P\V 44\V4p \V4'dr\Wg4p V 'd"V PRPV 44M#V'dV PVP4V P\!V44V 'd VRRPV 4,, pTV'dRMR,R,p R V R RPV 4 R V 2#) a6Returns usage text for the given component. Args: component: The component to determine the usage text for. trace: The Fire trace object containing all metadata of current execution. verbose: Whether to display the usage text in verbose mode. Returns: String suitable for display in an error screen. NFrr rLrKz -- z--helpzUsage: rqz2 For detailed information on this command, run: )rNeedsSeparatingHyphenHyphenrrrrrrNrO_GetPossibleActionsUsageString_UsageAvailabilityLinesr_GetCallableUsageItemsr"rRr_GetCallableAvailabilityLines)r#r r rneeds_separating_hyphen_hyphencontinued_commandr&r'r%rSrTavailability_linescallable_items help_commands&&& r UsageTextrpse  G%*%F%F%H"G%*" G  $ $Y /$  # #I .(5YP()@A-78HIJ./FG i+D;N388N34 5??+;DABuzz-888 1s< &'( . r9cDV'dRPV4pRV R2#R#)|<>Nr)rS actions_strs& rrrs&((+,K {m1  r9c.pVFMpVP'gK\RVP R2VPR7pVP V4KO V#)z available :)headeritems)r_CreateAvailabilityLinerrrO)r%rravailability_lines& rrrs^-l1l112!4"" 12 . r9cVPR\VP4\VP4, pVP\VP4\VP4, RpVP\P 4pV'g'VUu.uFpRV RVP 4 2NK ppMVUu.uFqUP 4NK ppV'g%VP'gVP'dVPR4VP'd.VPRVPP 4 R24V#uupiuupi)zBA list of elements that comprise the usage summary for a callable.Nrsrrrr) ryrCrzr{rr|rrrrOr~)r&r'rrrrr$s&& rrrs))$HS^c$--6H%HIyyTYY#dmm2D!D!EF%LL)K)KL - /-#a } %-  /E%: :$9SYY[$9E :4???djjj LL \\\ LL1T\\'')*$/0 , / ;s $E" E'c4aaVV3RlSP4#)c3T<"TFpSVSP98wgKVxK R#5ir)rb)rrcr_r&s& rr(_KeywordOnlyArguments..s+ 8?4 $$"5"55 6 $?s( ()r)r&r_sffr_KeywordOnlyArgumentsr+s 84?? 88r9cVVP\VP4\VP4, Rp\P!V\ VRR74Uu.uFpRV 2NK pp\ VRR7Uu.uFpRV 2NK pp.pV'dVP \RV^R74V'dVP \RV^R74VP'd2V'g V'dR MR pVP \V.^R74V#uupiuupi) zHThe list of availability lines for a callable for use in a usage string.NF)r_rsTzoptional flags:)r#r$ header_indentzrequired flags:zadditional flags are acceptedzflags are accepted) ryrCrz itertoolschainr+rOr%r)r&rrcoptional_flagsrequired_flagsradditional_flagss& rrrs3yyTYY#dmm2D!D!EF-6OO/uE-GH-GDbK-G.H4D4HHd4&kH '8./ 12'8./ 12 ZZZ)^8,'7r./ 12 /Hs !D!D&cWC, pRP\P!WR74p\P!WcR7p\P!WR7pW\ V4R,R,#)rq)width)spacesN)r"r WrappedJoinrrC) r#r$r- items_indent line_length items_width items_textindented_items_textindented_headers &&&&& rr%r%sa*+yy//IJ*"))*J%%fC/ s?/C/DE E LLr9c0]tRtRtRtRtRRltRtRtR#) riz$A group of actions of the same kind.c :WnW n.Vn.VnR#r)rrrr)selfrrs&&&rrActionGroup.__init__sIKDJDLr9Nc rVPPV4VPPV4R#r)rrOr)r?rrs&&&rrActionGroup.Adds&JJdLLr9c B\VPVP4#r)rrr)r?s&rrActionGroup.GetItemss tzz4<< ((r9)rrrrr) __name__ __module__r__firstlineno____doc__rrr__static_attributes__r6r9rrrs,  )r9r)NFr)F)NT)FNF)r4)T)1rH __future__rrgr.firerrrrrrr rArBrr1rrrrernr r!r?r[rQrNrPrr>rr}rarrrrrrrrrrrr+rr%rr6r9rrLs"#$ ,^*08 ?]1@"D L .(b4 -65 MB;N| . .G*E&9x 08 @+,"(3M))r9