LTSrSSKJr SSKJr SSKJr SSKrSSKJr SSKJ r SSK J r "S S \ R5r g) a{Cloud SDK markdown document token renderer. This is different from the other renderers: (1) The output is a list of (token, text) tuples returned by TokenRenderer.Finish(). (2) A token is an empty object that conveys font style and embellishment by convention using the token name. Callers set up a style sheet indexed by tokens to control how the embellishments are rendered, e.g. color. (3) The rendering is constrained by width and height. Tokens generated by this module: Token.Markdown.Bold: bold text Token.Markdown.BoldItalic: bold+italic text Token.Markdown.Code: code text for command line examples Token.Markdown.Definition: definition list item (flag or subcommand or choice) Token.Markdown.Italic: italic text Token.Markdown.Normal: normal text Token.Markdown.Section: section header Token.Markdown.Truncated: the last token => indicates truncation Token.Markdown.Value: definition list item value (flag value) The Token objects self-define on first usage. Don't champion this pattern in the Cloud SDK. Usage: from six.moves import StringIO from googlecloudsdk.core.document_renderers import token_renderer from googlecloudsdk.core.document_renderers import render_document markdown = tokens = render_document.MarkdownRenderer( token_renderer.TokenRenderer(width=W, height=H), StringIO(markdown)).Run() )absolute_import)division)unicode_literalsN) console_attr)renderer)Tokenc^\rSrSrSrSr\RR\RR\RR\RR\RRS.r SrSrSrSr"S S \5rS"U4S jjrS rS#S jrSrS#SjrSrSrSrS$SjrSrSrSrS#Sjr Sr!Sr"S%Sjr#Sr$Sr%S&Sjr&Sr'S'Sjr(S(S jr)S!r*U=r+$)) TokenRendererBa6Renders markdown to a list of lines where each line is a list of Tokens. Attributes: _attr: console_attr.ConsoleAttr object. _bullet: List of bullet characters indexed by list level modulo #bullets. _compact: Compact representation if True. Saves rendering real estate. _csi: The control sequence indicator character. Token does not have control sequences. This renderer uses them internally to manage font styles and attributes (bold, code, italic). _current_token_type: current default Token.Markdown.* type _fill: The number of characters in the current output line. _height: The height of the output window, 0 to disable height checks. _ignore_paragraph: Ignore paragraph markdown until the next non-space _AddToken. _ignore_width: True if the next output word should ignore _width. _indent: List of left indentations in characters indexed by _level. _level: The section or list level counting from 0. _tokens: The list of output tokens _truncated: The number of output lines exceeded the output height. _rows: current rows in table )BCINZrc"\rSrSrSrSSjrSrg)TokenRenderer.IndentizSecond line indent stack.cbU(aSO[RUlURUlg)Nr)r INDENTindentsecond_line_indent)selfcompacts [[U] "S0UD6 [R"US9UlUR UlURUR lUR R5Ul X0l SUl [RRUlXlSUlSUlUR'U5/UlSUl/Ul/UlSUl/Ulg)N)encodingrFr))superr rrGetConsoleAttr_attrCSI_csi GetBullets_bullet_compact_fillrMarkdownNormal_current_token_type_height_ignore_paragraph _ignore_widthr*_indent_level_lines_tokens _truncated_rows)rheightr,rkwargs __class__s rrTokenRenderer.__init__ps -'1&1,,h?DJDIiiDJJO::((*DLMDJ$~~44DL"DDKK()DLDKDKDLDODJr!cZSUlSn[U5n[RRU4nU(aU(aUupgXG:XaOUS-U::a:SUR U5SXt- S- -nUR URU45 O/nURnUHxn XRnURRU5n Xz-nXt::a2XG- n U (aUSU *nUR XRU45 OUR U 5 Mz UnUR U5 U$)a;Injects a truncation indicator token and rejects subsequent tokens. Args: tokens: The last line of tokens at the output height. The part of the line within the output width will be visible, modulo the trailing truncation marker token added here. overflow: If not None then this is a (word, available) tuple from Fill() where word caused the line width overflow and available is the number of characters available in the current line before ' '+word would be appended. Returns: A possibly altered list of tokens that form the last output line. Tz...r N) r@lenrr6 Truncated _UnFormatappendr8_widthTOKEN_TEXT_INDEXr/ DisplayWidthTOKEN_TYPE_INDEX) rtokensoverflow marker_string marker_width marker_tokenword availabletruncated_tokenstokenwidthtrims r _TruncateTokenRenderer._Truncates2DOM}%LNN,,mrMisspacer9rHintboolr[rK)rrQrPs r_NewLineTokenRenderer._NewLines\\FDL f  {{ ++b/kk"ob!$"7"78@@BB++b/#2. B ++b/kk"ob!$"7"78@@BB ||T[[)CV ,==$,,N~~f/fKKvr!cU(dgUR(a URSURU:waURRX!45 gURSUR[RR :XaURSUR n[R"SU5RS5n[R"SU5RS5nXE:XaX!4URS'gUR5 URRX!45 gUURSUR U-4URS'g)zFMerges text if the previous token_type matches or appends a new token.Nr^z( *)r) r?rOrKrr6SectionrMrematchgrouprb)rtext token_typeprv_text prv_indent new_indents r_MergeOrAddTokenTokenRenderer._MergeOrAddTokens  LL << D11 2j @ ll:,- b $// 0ENN4J4J Jb!$"7"78h88FH-33A6j88FD)//2j  !&- R  Z./  ,,r 400 1D 8dll2r!cU(aUR5(dSUlU(d URnURU;aUR X5 gSnUR URU5nUS:aUR XSU5 gUR XUU5 UR XS-nX lUS-nMl)z7Appends a (token_type, text) tuple to the current line.FrNrr)r_r:r8r1rnfindEMBELLISHMENTS)rrirjijs r _AddTokenTokenRenderer._AddTokens DLLNN$d ++j yy D- a  IIdii # q5   R* 5  dQi4((!e5 #- E r!c,URU;aU$/nSnU[U5:a_URURU5nUS:aURXS5 O)URXU5 US-nU[U5:aM_SR U5$)z1Returns text with all inline formatting stripped.rNr)r1rHrqrKjoin)rristrippedrsrts rrJTokenRenderer._UnFormats yy kH A c$i- ))DIIq !a QR! oodQi a%a c$i- 778 r!cURU5nURSS5nURUS[RR 5 [ U5S:aWURS[RR5 URUS[RR5 UR5 g)z>Appends a definition list definition item to the current line.=rrN) rJsplitrurr6 DefinitionrHr7Valuerb)rripartss r_AddDefinitionTokenRenderer._AddDefinitions >>$ D JJsA ENN58U^^667 5zA~ nnS%..//0 nnU1Xu~~334MMOr!cSUlUR(a(UR5 UR5 SUlgg)z/Flushes the current collection of Fill() lines.FrN)r;r5rbContentrs r_FlushTokenRenderer._Flushs/D zz mmo llndjr!cURU:GaURU:GaURnU=RS- slUR[UR5:a)URRUR 55 URUR U-URURlURS:a`URUR URUR :Xa,URUR=R S- slURURR nXPRURlUb,URUR=R U-slURU:aGMggXlUbCURURR U-URURlgg)aSets the markdown list level and indentations. Args: level: int, The desired markdown list level. indent: int, The new indentation. second_line_indent: int, The second line indentation. This is subtracted from the prevailing indent to decrease the indentation of the next input line for this effect: SECOND LINE INDENT ON THE NEXT LINE PREVAILING INDENT ON SUBSEQUENT LINES rN)r=rHr<rKr*rr)rlevelrr prev_levelvalues r _SetIndentTokenRenderer._SetIndents {{U KK% [[  q ;;#dll+ + ,,  dkkm , LL $ + +f 4 T[[!( KK!O Z(;;||J'../ ,,t{{ # * *a / * T[[)007< T[[!4  ) ,,t{{ # 6 6:L L 6+ KK%  0k  ' LL % 8 8;M M T[[!( (r!c0URURRUR-UlUR SUR-U-[ RR5 UR5 UR5 SUlg)zLDisplays line as an indented example. Args: line: The example line text. rGrN) r<r=rrr5rurr6r7rbr)rlines rExampleTokenRenderer.ExampleGsf dkk*11DKK?DJNN3#d*ENN,A,ABMMOLLNDJr!cpUR5 UR5GHnUR(dsUR(dUR(d,UR URR S- UlOSUlURSUR-5 URRU5nURUR- nUS-U:ahUR(dWURX$4S9 UR URR UlURSUR-5 O>SUl UR(a&U=RS- slURS5 U=RU- slURU5 GM g)zAdds a line to the output, splitting to stay within the output width. This is close to textwrap.wrap() except that control sequence characters don't count in the width computation. Args: line: The text line. rrrG)rQFN) Blankr~r5r=r4r<rrur/rNrLr;rb)rrrUrYrVs rFillTokenRenderer.FillSs( JJL  ZZ ;;dmm||DKK077!;$*$+ sTZZ'(jj%%d+e++ *i !) !$*<*< 0 1\\$++.55  sTZZ'(" :: **/* ..  jjEj nnT'r!cZUR5 UR5 UR$)z'Finishes all output document rendering.)rFontr>rs rFinishTokenRenderer.FinishrsKKMIIK ;;r!cUcSUlOSU-nU=RU-slURS[R-S[R--S[R---nUS[R--(aSnOdUS[R-S[R--:XaSnO6US[R-:XaSnOUS[R-:XaSnOSnUR U-$)zReturns the font embellishment control sequence for attr. Args: attr: None to reset to the default font, otherwise one of renderer.BOLD, renderer.ITALIC, or renderer.CODE. Returns: The font embellishment control sequence. rrrrr rr)_fontrBOLDCODEITALICr1)rattrmaskfont embellishments rrTokenRenderer.Fontxs |dj $Yd jjDj :: hmm X]] 23qHOO7KL D qHMM!"m 1 %!x*>? @m !x}}$ %m !x& 'mm 99} $$r!cUS:XaURS5(agUR5 UR5 UR5 US:aOSUS- -nUR U5 UR (a%SUlU=R[U5- slUR U[RR5 UR (a6SUlU=RURRU5- slOUR5 UR5 SUl/Ulg)zcRenders a heading. Args: level: The heading level counting from 1. heading: The heading text. rz(1)Nrz Tr)endswithrLinerrur4r:r5rHrr6rer/rNrbrr=rA)rrheadingrs rHeadingTokenRenderer.Headings zg&&u-- KKMIIKIIK qyuqy!f nnV !% c&k! NN7ENN223 }}#d jjDJJ++G44j mmoJJLDKDJr!cUR(agUR5 UR5(d!UR5 UR 5 gg)z$Renders a paragraph separating line.N)r:r HaveBlankrrbrs rrTokenRenderer.Lines;  KKM >>   jjl mmo r!cUR5 U(dXlgU(aURU5 gUbwU(aNURUSSS9 URSURUR -5 UR U5 gURUSSS9 UR5 gUS:aSOSnURXSS9 URSURUR -URUS- [UR5--5 URURS-Ul S Ul g) zRenders a bullet or definition list item. Args: level: The list nesting level, 0 if not currently in a list. definition: Bullet list if None, definition list item otherwise. end: End of list if True. Nrr"rGrrrT) rr=rrur<rrrr3rHrr5r;)rr definitionendrs rListTokenRenderer.Lists KKM k  ooe    aA> sT\\%0CCCD J' aA> AIq1f ooeqoA nn  U#66 6 LL%!)s4<<'88 9 :<<&--1djdr!cjU[U5:a#XnUS:waU$US- nU[U5:aM#U$)zSkip space characters starting at line[index]. Args: line: The string. index: The starting index in string. Returns: The index in line after spaces or len(line) at end of string. rGr)rH)rrindexcs r _SkipSpaceTokenRenderer._SkipSpacesF #d)  +a c L qje #d)  Lr!cVURRXS5nU(dSnX#-$)zSkip the control sequence at line[index]. Args: line: The string. index: The starting index in string. Returns: The index in line after the control sequence or len(line) at end of string. Nr)r/GetControlSequenceLen)rrrns r_SkipControlSequence"TokenRenderer._SkipControlSequences, ((f6A a 9r!cSnU[U5:aYXnUS- nXc;aUS- nO4Xd;aUS-nUS::aU$O X`R:XaURX5nU[U5:aMYU$)a*Skip a [...] nested bracket group starting at line[index]. Args: line: The string. index: The starting index in string. open_chars: The open nesting characters. close_chars: The close nesting characters. Returns: The index in line after the nesting group or len(line) at end of string. rr)rHr1r)rrr open_chars close_charsnestrs r _SkipNestTokenRenderer._SkipNests D #d)  +a qje       19  L  >))$6 #d)  Lr!cLSnU(GaSGHnURU5upgnURRU5n U[U5-U -UR:d US:waUS:XaUS:wa-X R -[U5-U -UR:aMUS:XaUR U5 SnX2:wa2X R -nUR5 UR SU-5 UR XF-5 U[U5U -- nUnUn O U(aGMU$)aSplits a wide SYNOPSIS section group string._out. Args: group: The wide group string to split. indent: The prevailing left indent. running_width: The width of the line in progress. Returns: The running_width after the group has been split and written. rG)z | z : rG,r) partitionr/rNrHrL SPLIT_INDENTrurb) rrhr running_widthprev_delimiter delimiterpart_ remainderws r_SplitWideSynopsisGroup%TokenRenderer._SplitWideSynopsisGroups$N /)"__Y7 JJ # #D ) S0 01 4 D$S 3---N0CCaG  s " NN> * N  $"%6%66M MMO NN3. / ~,-^,q00 " 50 %: r!c/nURUS5nUnU[U5:aXnUS:XacUnURX5nU[U5S- ::a(XS:Xa XS-S:XaURXS-5nOTURXU5 UnO>US;aURX5nO&X`R:XaUR X5nOUS- nU[U5:aMU[U5:aURXS5 UR SRS- nUn URSU -5 XR- nUHn URRU 5S-n X-UR:aLUn UR5 URSU -5 X-UR:aURXU 5n MURSU -5 X- n M UR5 UR5 g)aGRenders NAME and SYNOPSIS lines as a second line indent. Collapses adjacent spaces to one space, deletes trailing space, and doesn't split top-level nested [...] or (...) groups. Also detects and does not count terminal control sequences. Args: line: The NAME or SYNOPSIS text. is_synopsis: if it is the synopsis section rrGr|[(N)rrHrKrr1rr<rrurr/rNrLrbr) rr is_synopsisgroupsrsbegrrrrrhrs rSynopsisTokenRenderer.SynopsisDsF a A C c$i- 'a c OOD $ TQ DGsNtE{c7IoodE*! -- &# 9 NN4 # >  % %d . Q c$i-  SY mmDJ\\!_ # #a 'FMNN3&' kkF ** ! !% (1 ,a   +   s]*+  $++ -66] -  nnS5[!m MMOMMOr!cRURUS-U-5 UR5 g)zAdds an indented table line to the output. Args: line: The line to add. A newline will be added. indent: The number of characters to indent the table. rGN)rurb)rrrs r TableLineTokenRenderer.TableLine|s" NN6C<$&'MMOr!)r/r3r4r1r8r5rr9r:r;r<r=r>rAr?r@)rzutf-8T)N)rN)NF)rz)])F)r),r#r$r%r&r'r0rr6BoldCodeItalicr7 BoldItalicrrrrrOrMobjectr*rr[rbrnrurJrrrrrrrrrrrrrrrrr( __classcell__)rDs@rr r Bs2 # >>   >>   >> >> >> $ $ . &,,v,&-^06( + Z > %<:  D" 4)V6pr!r )r' __future__rrrrfgooglecloudsdk.core.consoler&googlecloudsdk.core.document_renderersrprompt_toolkit.tokenrRendererr r)r!rrs6 %N'' 4;&B H%%B r!