1ndZddlmZddlmZddlmZddlmZddlmZGddejZ y ) z*Cloud SDK markdown document text renderer.)absolute_import)division)unicode_literals) console_attr)rendererceZdZdZdZdZGddeZfdZdZ ddZ d Z d Z d Z dd Zd ZdZddZdZdZddZdZddZxZS) TextRendereraRenders markdown to text. Attributes: _attr: console_attr.ConsoleAttr object. _bullet: List of bullet characters indexed by list level modulo #bullets. _csi_char: The first control sequence indicator character or None if control sequences are not supported. _fill: The number of characters in the current output line. _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. ceZdZdZdZy)TextRenderer.IndentzSecond line indent stack.cPtj|_|j|_y)N)r INDENTindentsecond_line_indentselfs ;lib/googlecloudsdk/core/document_renderers/text_renderer.py__init__zTextRenderer.Indent.__init__-s ''dk $ dN)__name__ __module__ __qualname____doc__rrrIndentr *s #,rrcptt| |i|tj|_|j j |_|j j|_ |jr|jd|_ d|_ d|_ |jg|_ d|_y)NrF)superr rrGetConsoleAttr_attr GetBullets_bulletGetControlSequenceIndicator _csi_char_fill _ignore_widthr_indent_level)rargskwargs __class__s rrzTextRenderer.__init__1s ,&77,,.DJ::((*DLZZ;;=DN ~~~~a(dnDJDKKM?DLDKrcd|_|jr3|jjd|j d|_yy)z/Flushes the current collection of Fill() lines.F rN)r&r%_outwriteContentrs r_FlushzTextRenderer._Flush=s6D zz iiood llndjrc|j|kr|j|kr|j}|xjdz c_|jt|jk\r)|jj|j |j|j |z|j|j_|jdkDr_|j|j |j|j k(r,|j|jxj dz c_|j|jj |j|j_|,|j|jxj |zc_|j|kryy||_|C|j|jj |z|j|j_yy)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 N)r(lenr'appendrrr)rlevelrr prev_levels r _SetIndentzTextRenderer._SetIndentEs {{U KK% [[  q ;;#dll+ + ,,  dkkm , LL $ + +f 4 T[[!( KK!O LL $ 7 7 LL $ + + , ,,t{{ # * *a / * LL % , , T[[!4  ) ,,t{{ # 6 6:L L 6# KK% (dk  ' LL % 8 8;M M T[[!( (rc|j|jj|jz|_|j j d|jz|zdz|jd|_y)zXDisplays line as an indented example. Args: line: The example line text.  r-rN)r'r(rrr%r.r/r0)rlines rExamplezTextRenderer.ExampleosZ dkk*11DKK?DJIIOOC$**$t+d23LLNDJrcZ|j|jD]}|jsS|j|jj dz |_|j jd|jz|jj|}|j|zdz|jk\rx|jsl|j jd|j|jj |_|j jd|jznCd|_ |jr0|xjdz c_|j jd|xj|z c_|j j|y)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. r3r:r-FN) Blanksplitr%r'r(rr.r/r DisplayWidth_widthr&)rr;wordwidths rFillzTextRenderer.Fillzs JJL  ZZ\\$++.559  djj()jj%%d+e e a 4;; .t7I7I \\$++.55  djj()" :: **/* ))//#  jjEj iioodrc\|j|j|jy)z'Finishes all output document rendering.outN)r1Fontr.rs rFinishzTextRenderer.FinishsKKMII$))IrcV|d|_nd|z}|xj|zc_|jdtjzdtjzzz}|jdtjzz}|j j ||}|r|j||S)aReturns the font embellishment string for attr. Args: attr: None to reset to the default font, otherwise one of renderer.BOLD, renderer.ITALIC, or renderer.CODE. out: Writes tags to this stream if not None. Returns: The font embellishment string. rr3)bolditalic)_fontrBOLDCODEITALICr GetFontCoder/)rattrrGmaskrKrLcodes rrHzTextRenderer.Fonts |dj $Yd jjDj ::!x}},hmm1CD ED ZZ1/ 0F :: ! !tF ! ;D  iio Krc.|dk(r|jdry|j|j|j|j|dkDr!|jj d|dz z|jj |jt j|z|jt jzdz|dk(r|jj d|jd|_ g|_ y) zsRenders a heading. Args: level: The heading level counting from 1. heading: The heading text. r3z(1)NrFr z r-r) endswithr1LinerHr.r/rrNr>r(_rows)rr6headings rHeadingzTextRenderer.Headings zg&&u- KKMIIKII$))I qy iioodeai()IIOODIIhmm,w6IIhmm,-/345 z iioodJJLDKDJrc|j|js,|j|jj dyy)z$Renders a paragraph separating line.r-N)r1 HaveBlankr>r.r/rs rrWzTextRenderer.Lines3KKM >>  jjl iiood rc|j|s||_y|r|j|y|w|rP|j|dd|jj d|j |j z|zdzy|j|dd|jy|dkDrd nd}|j||d |jj d|j |j z|j|dz t|jzz|j |jdz|_ d |_ y) 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. Nr )rrr:r-r3rr T) r1r(r8r.r/r'rrWr"r4rr%r&)rr6 definitionendrs rListzTextRenderer.Lists KKM dk  ooe    aA>  $,,u%88 8: E L N aA> AIq1f ooeFqoA iioocDLL/BBBllEAIT\\1B#BCDE<<&--1djdrcd|t|kr!||}|dk7r |S|dz }|t|kr!|S)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. r:r3)r4)rr;indexcs r _SkipSpacezTextRenderer._SkipSpacesH #d)  u+a c L qje #d)  LrcP|jj||d}|sd}||zS)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. Nr3)r GetControlSequenceLen)rr;rcns r_SkipControlSequencez!TextRenderer._SkipControlSequences0 ((ef6A a 19rcd}|t|krU||}|dz }||vr|dz }n2||vr |dz}|dkr$ |S||jk(r|j||}|t|krU|S)aJSkip 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. rr3)r4r$ri)rr;rc open_chars close_charsnestrds r _SkipNestzTextRenderer._SkipNests D #d)  u+a qje j      19  L  ))$6 #d)  LrcPd}|r dD]}|j|\}}}|jj|} |t|z| z|jk\s |dk7r|dk(r|dk7r,||j zt|z| z|jk\r|dk(r|j j|d}||k7r0||j z}|j jdd|zz|j j||z|t|| zz }|}|}n|r |S)aASplits a wide SYNOPSIS section group string to self._out. Args: group: The wide group string to split. indent: The prevailing left indent. running_width: The width of the self._out line in progress. Returns: The running_width after the group has been split and written to self._out. r:)z | z : r:,rpr-) partitionr r@r4rA SPLIT_INDENTr.r/) rgroupr running_widthprev_delimiter delimiterpart_ remainderws r_SplitWideSynopsisGroupz$TextRenderer._SplitWideSynopsisGroup*s=N /)"__Y7a JJ # #D ) S0 01 4 D c !i3&6 # 6#'#4#4$5#&~#6$7$%$%*.#5  s " IIOON + N f $"T%6%66M IIOOD3#66 7 -.^,q00 " +0 0 rcg}|j|d}|}|t|kr||}|dk(re|}|j||}|t|dz kr)||dk(r!||dzdk(r|j||dz}nU|j||||}n>|dvr|j||}n'||jk(r|j ||}n|dz }|t|kr|t|kr|j||d|j djdz }|} |jjd| z||jz }|D]} |jj| dz} | | z|jk\rI|} |jjdd| zz| | z|jk\r|j| || } ||jjd| z| | z } |jjdy) acRenders 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 rr:r3|[(Nr-z )rer4r5rnr$rir'rr.r/rr r@rAr{) rr; is_synopsisgroupsibegrdr`rrtrsrzs rSynopsiszTextRenderer.SynopsisPsF a A C c$i- q'a c OOD! $ TQ DGsNtAE{c7IoodAE*! --S &# 9 NN4 #    % %dA . Q c$i-  SY mmDJ\\!_ # #a 'FMIIOOC-'( dkkF ** ! !% (1 ,a !  +  s]223 A $++ -66V],-  iioocEk"qm IIOOFr)rN)NN)NF)r~z)])F)rrrrrrrobjectrrr1r8r<rDrIrHrZrWrarerirnr{r __classcell__)r+s@rr r so  &,,v, (OT 6 .. @" 4$L3rr N) r __future__rrrgooglecloudsdk.core.consoler&googlecloudsdk.core.document_renderersrRendererr rrrrs- 1&'4;i8$$ir