QbdZddlmZddlmZddlmZddlmZGddejZy) z5Cloud SDK markdown document man page format renderer.)absolute_import)division)unicode_literals)rendererc|eZdZdZdZdddZdZfdZdZd Z d Z d Z d Z dd Z dZdZddZddZdZxZS) ManRendereraRenders markdown to man(1) input. Attributes: _BULLET: A list of bullet characters indexed by list level modulo #bullets. _ESCAPE: Character element code string dict indexed by input character. _FONT_TAG: Font embellishment tag string list indexed by font attribute. _example: True if currently rendering an example. _fill: The number of characters in the current output line. _level: The section or list level counting from 0. _th_emitted: True if .TH already emitted. )z\(buz\(emz\ez\-)\-)z\fBz\fIz\f5cdtt| |i|d|_d|_d|_d|_y)NFr)superr__init___example_fill_level _th_emitted)selfargskwargs __class__s :lib/googlecloudsdk/core/document_renderers/man_renderer.pyr zManRenderer.__init__)s4 +t%t6v6DMDJDKDc|jr"d|_|jjd|jr#d|_|jjdyy)z/Flushes the current collection of Fill() lines.r F.RE N)r_outwriterrs r_FlushzManRenderer._Flush0sC zzdj iiood }}dm iioogrc8djfd|DS)zEscapes special characters in normal text. Args: buf: The normal text that may contain special characters. Returns: The escaped string. c3VK|] }jj||"yw)N)_ESCAPEget).0crs r z%ManRenderer.Escape..Bs#73a4<<##Aq)3s&))join)rbufs` rEscapezManRenderer.Escape9s 77737 77rc|js"d|_|jjd|jj|dzy)zZDisplays line as an indented example. Args: line: The example line string. T.RS 2m rN)rrr)rlines rExamplezManRenderer.ExampleDs6 ==dm iiooj!IIOOD4K rcJd}|jD] }t|}|j|z|z|jk\rK|jj dd|_|ddk(r|jj dd}nhd}ne|jr1|xjdz c_|jj dn(|ddk(r|jj dd}nd}|xj|z c_|jj |y)zrAdds a line to the output, splitting to stay within the output width. Args: line: The line string. rr'r  N)splitlenr_widthrr)rr,escapeswordns rFillzManRenderer.FillOs G  d)a a' !T[[ 0  7c> ))//$ '' :: a   7c>  jjAoj iiood'rc^|j|j|jdy)z'Finishes all output document rendering.outrN)FontrListrs rFinishzManRenderer.FinishksII$))IIIaLrc||jr d|_d}n=d}n:d|z}|xj|zc_|j|zr|j|nd}|r|r|j|dz|S)a$Returns 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 line to this stream if not None. Returns: The font embellishment string. rz\fRr r0r)_font _FONT_TAGr)rattrr;tagsmasks rr<zManRenderer.Fontpsm |   $Yd jjDj&*jj4&7T^^D !fd t iit  Krc|j|j|j|jd|dk(r:|j dr)|jj d|ddzd|_y|j s3|jj d |jxsd zd|_|jj d |zy) zsRenders a heading. Args: level: The heading level counting from 1. heading: The heading text. r:rr0z(1)z .TH "%s" 1 NTz .TH "%s" "" NOTESz .SH "%s" )rr<rr=endswithrr_title)rlevelheadings rHeadingzManRenderer.Headings KKMII$))IIIaL zg&&u- iioo&"56d    )T[[-CGDE iioonw./rcZ|j|jjdy)z$Renders a paragraph separating line.rN)rrrrs rLinezManRenderer.LinesKKMIIOODrc|jd}|jr]|j|kDrN|jjd|xjdzc_d}|jr|j|kDrN|r|jjd|s|sy|j|kr0|xjdz c_|jjd|"|jjd|zd zy|jjd |j|dz t |jzzy) zRenders a bullet or definition markdown list item. Args: level: The markdown list nesting level. definition: Bullet markdown list if None, definition markdown list otherwise. end: End of markdown list if True. Frr0Tz.sp Nr+z.TP 2m rz .IP "%s" 2m )rrrr_BULLETr3)rrJ definitionendneed_sps rr=zManRenderer.Lists KKMG ++$++- iioog kkQkg ++$++- iioog %  {{U kkQk iiooj! iiooj:-45 iiooollEAIT\\1B#BCDErc|jjdd}|D]:}|dvr|dz }n|dvr|dz}n |dk(r|rd}|jj|<|jjdy ) zRenders NAME and SYNOPSIS lines as a hanging indent. Does not split top-level [...] or (...) groups. Args: line: The synopsis text. is_synopsis: if it is the synopsis section z.HP rz[(r0z)]r1z\ rN)rr)rr, is_synopsisnestr%s rSynopsiszManRenderer.Synopsisss IIOOG D  d   9   8  iiooa IIOODrc4|jjdd}d}|jD]y}|d|jdzz }|d|jdzz }|jr<|dj |jz }|dj |jz }|dz }{|j r!|jj|ddd z|jj|ddd z|jjd j|jDcgc]}|jc}d z|D]/}|jjd j|d z1|jjd ycc}w) zRenders a table. Nested tables are not supported. Args: table: renderer.TableAttributes object. rows: A list of rows, each row is a list of column strings. z .TS tab( ); r r1rz({})Br0Nrz.  z.TE ) rrcolumnsalignwidthformatrKr'label)rtablerows head_attr data_attrcolumnr%rows rTablezManRenderer.TablesP IIOO'(II--3a((i3a((i V]]6<<00 V]]6<<00 3i   }} iiooimd*+IIOOIabME)*IIOODII > 1qww >?$FG iioodiint+,  IIOOG?s$F )NN)NF)F)__name__ __module__ __qualname____doc__rPr"rAr rr)r-r8r>r<rLrNr=rWrf __classcell__)rs@rrrs\  'u %'&) 8 !8 20& E@*$rrN) rj __future__rrr&googlecloudsdk.core.document_renderersrRendererrrrrps* <&';a(##ar