o €ÏQã@sJdZddlmZddlmZddlmZddlmZGdd„dejƒZdS) z5Cloud SDK markdown document man page format renderer.é)Úabsolute_import)Údivision)Úunicode_literals)ÚrenderercseZdZdZdZdddœZdZ‡fdd„Zd d „Zd d „Z d d„Z dd„Z dd„Z d!dd„Z dd„Zdd„Zd"dd„Zd#dd„Zdd „Z‡ZS)$Ú ManRenderera÷Renders 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\f5cs2tt|ƒj|i|¤Žd|_d|_d|_d|_dS)NFr)ÚsuperrÚ__init__Ú_exampleÚ_fillÚ_levelÚ _th_emitted)ÚselfÚargsÚkwargs©Ú __class__©úP/tmp/google-cloud-sdk/lib/googlecloudsdk/core/document_renderers/man_renderer.pyr )s  zManRenderer.__init__cCs8|jr d|_|j d¡|jrd|_|j d¡dSdS)z/Flushes the current collection of Fill() lines.rÚ Fú.RE N)r Ú_outÚwriter ©rrrrÚ_Flush0s þzManRenderer._Flushcsd ‡fdd„|Dƒ¡S)z¢Escapes special characters in normal text. Args: buf: The normal text that may contain special characters. Returns: The escaped string. Úc3s|] }ˆj ||¡VqdS)N)Ú_ESCAPEÚget©Ú.0ÚcrrrÚ Bs€z%ManRenderer.Escape..)Újoin)rÚbufrrrÚEscape9s zManRenderer.EscapecCs,|js d|_|j d¡|j |d¡dS)zZDisplays line as an indented example. Args: line: The example line string. Tú.RS 2m rN)r rr)rÚlinerrrÚExampleDs zManRenderer.ExamplecCsÆd}| ¡D]Z}t|ƒ}|j|||jkr1|j d¡d|_|ddkr.|j d¡d}n%d}n"|jrB|jd7_|j d¡n|ddkrQ|j d¡d}nd}|j|7_|j |¡qdS)zrAdds a line to the output, splitting to stay within the output width. Args: line: The line string. rrú'réú N)ÚsplitÚlenr Ú_widthrr)rr'ÚescapesÚwordÚnrrrÚFillOs(      ízManRenderer.FillcCs|j|jd| d¡dS)z'Finishes all output document rendering.©ÚoutrN)ÚFontrÚListrrrrÚFinishkszManRenderer.FinishNcCsh|dur|jr d|_d}nd}nd|>}|j|N_|j|@r%|j|nd}|r2|r2| |d¡|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. Nrz\fRrr*r)Ú_fontÚ _FONT_TAGr)rÚattrr4ÚtagsÚmaskrrrr5ps zManRenderer.FontcCsŠ| ¡|j|jd| d¡|dkr*| d¡r*|j d|dd…¡d|_dS|js;|j d |jp5d ¡d|_|j d |¡dS) zsRenders a heading. Args: level: The heading level counting from 1. heading: The heading text. r3rr*z(1)z .TH "%s" 1 NéýÿÿÿTz .TH "%s" "" ÚNOTESz .SH "%s" )rr5rr6ÚendswithrrÚ_title)rÚlevelÚheadingrrrÚHeading‰s  zManRenderer.HeadingcCs| ¡|j d¡dS)z$Renders a paragraph separating line.rN)rrrrrrrÚLineœszManRenderer.LineFcCsÒ| ¡d}|jr%|j|kr%|j d¡|jd8_d}|jr%|j|ks|r-|j d¡|s1|s3dS|j|krE|jd7_|j d¡|durU|j d|d ¡dS|j d |j|dt|jƒ¡dS) zõRenders 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. Frr*Tz.sp Nr&z.TP 2m rz .IP "%s" 2m )rr rrÚ_BULLETr-)rrAÚ definitionÚendÚneed_sprrrr6¡s&  ý    ÿzManRenderer.ListcCsj|j d¡d}|D]"}|dvr|d7}n|dvr|d8}n|dkr&|r&d}|j |¡q |j d¡d S) zÉRenders 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[(r*z)]r+z\ rN)rr)rr'Ú is_synopsisÚnestr!rrrÚSynopsisÁs    zManRenderer.SynopsiscCsú|j d¡d}d}|jD]+}|d|jd7}|d|jd7}|jr4|d |j¡7}|d |j¡7}|d7}q |jrH|j |dd…d ¡|j |dd…d ¡|j d  d d „|jDƒ¡d ¡|D] }|j d  |¡d ¡qg|j d¡dS)z¶Renders 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( ); rr+rz({})ÚBr*Nrz. ú cSsg|]}|j‘qSr)ÚlabelrrrrÚ ñsz%ManRenderer.Table..z.TE )rrÚcolumnsÚalignÚwidthÚformatrBr#)rÚtableÚrowsÚ head_attrÚ data_attrÚcolumnÚrowrrrÚTableÖs"   "zManRenderer.Table)NN)NF)F)Ú__name__Ú __module__Ú __qualname__Ú__doc__rErr9r rr%r(r2r7r5rCrDr6rKrZÚ __classcell__rrrrrs"        rN) r^Ú __future__rrrÚ&googlecloudsdk.core.document_renderersrÚRendererrrrrrÚs