o €Ï =ã@sZdZddlmZddlmZddlmZddlZddlZddlmZGdd„dej ƒZ dS) z*Cloud SDK markdown document HTML renderer.é)Úabsolute_import)Údivision)Úunicode_literalsN)ÚrenderercsÂeZdZdZdZddddœZdZ‡fdd „Zd d „Zd d „Z dd„Z dd„Z dd„Z dd„Z dd„Zdd„Zd.dd„Zdd„Zdd „Zd!d"„Zd#d$„Zd%d&„Zd/d(d)„Zd0d*d+„Zd,d-„Z‡ZS)1Ú HTMLRenderera\Renders markdown to HTML. Attributes: _BULLET: A list of bullet type names indexed by list level modulo #bullets. _ESCAPE: Character element code name dict indexed by input character. _FONT_TAG: A list of font embellishment tag names indexed by font attribute. _document_ids: The set of html ids unique in the current document. _example: True if currently rendering an example. _fill: The number of characters in the current output line. _heading: A string of HTML tags that closes out a heading section. _level: The section or list level counting from 0. _paragraph: True if the output already contains a paragraph tag. Used to avoid sequences of 2 or more paragraph tags in the output. _pop: A list of list element closing tag names indexed by _level. _section: Section heading but no section body yet. )ÚdiscÚcircleÚsquarez&z<z>)ú&ú<ú>)©Úcode)rÚvarr cshtt|ƒj|i|¤Žtƒ|_d|_d|_d|_d|_d|_ d|_ dg|_ d|_ |  ¡|j d¡dS)NFrÚa¦
)ÚsuperrÚ__init__ÚsetÚ _document_idsÚ_exampleÚ_fillÚ _global_flagsÚ_headingÚ_levelÚ _paragraphÚ_popÚ_sectionÚ_TitleÚ_outÚwrite)ÚselfÚargsÚkwargs©Ú __class__©úQ/tmp/google-cloud-sdk/lib/googlecloudsdk/core/document_renderers/html_renderer.pyr2szHTMLRenderer.__init__cCs4|j d¡|jr|j d|j¡|j d¡dS)zRenders an HTML document title.z z%s zÆ N)rrÚ_title©r r%r%r&r_s zHTMLRenderer._TitlecCsLd|_|jr$d|_|jrd|_|j d¡d|_|j d¡| ¡dSdS)z/Flushes the current collection of Fill() lines.Fz rÚ N)rrrrrrÚContentr(r%r%r&Ú_Flushts   ùzHTMLRenderer._FlushcCsxdd„}t d|¡}|r| d¡}| d¡ dd¡}||ƒ}|}d} ||jvr0|j |¡|S|d 7}d j||d }q#) z&Returns a unique document id for name.cSst dd|¡S)z=Returns singlularized name if name is 'COMMANDS' or 'GROUPS'.z(COMMAND|GROUP)S$z\1©ÚreÚsub)Únamer%r%r&Ú$SingularizeCommandAndGroupDocumentIDszHHTMLRenderer.GetDocumentID..SingularizeCommandAndGroupDocumentIDzY(-- |\[)*(<[^>]*>)*(?P-[-_a-z0-9\[\]]+|[_A-Za-z.0-9 ][-_A-Za-z.0-9 ]*|[-.0-9]+).*Úanchorú ú-rTéz{name}-{number})r/Únumber)r-ÚmatchÚgroupÚstripÚreplacerÚaddÚformat)r r/r0ÚmÚattemptr5r%r%r&Ú GetDocumentID€s$ ú   ûzHTMLRenderer.GetDocumentIDcCst dd|¡}| dd¡S)zýEscapes special characters to their entity tags. This is applied after font embellishments. Args: buf: Normal text that may contain special characters. Returns: The string with special characters converted to entity tags. z (``[^`]*)''z\1´´z...z…)r-r.r9)r ÚbufÚescr%r%r&ÚEntities²s zHTMLRenderer.Entitiescsd ‡fdd„|Dƒ¡S)zÏEscapes special characters in normal text. This is applied before font embellishments. Args: buf: Normal text that may contain special characters. Returns: The escaped string. rc3s|] }ˆj ||¡VqdS)N)Ú_ESCAPEÚget)Ú.0Úcr(r%r&Ú Ìs€z&HTMLRenderer.Escape..)Újoin)r r?r%r(r&ÚEscapeÁs zHTMLRenderer.EscapecCst| ¡|jsd|_d|_|j d¡t|ƒ}| ¡}|t|ƒ8}|j d|j|¡|j |¡|j d¡dS)zSDisplays line as an indented example. Args: line: The example line. Téz

z z
N)ÚBlankrrrrÚlenÚlstrip)r ÚlineÚindentr%r%r&ÚExampleÎs   zHTMLRenderer.ExamplecCs®|jr d|_|j d¡| ¡|jrd|_| |¡}| ¡D]5}t|ƒ}|j||j kr7|j d¡d|_n|jrG|jd7_|j d¡|j|7_|j |¡qdS)zpAdds a line to the output, splitting to stay within the output width. Args: line: The text line. Fz

r)rr4r2N) rrrrJrÚLinkGlobalFlagsÚsplitrKrÚ_width)r rMÚwordÚnr%r%r&ÚFillàs$     ÷zHTMLRenderer.FillcCs<|j|jd| d¡|jr|j |j¡|j d¡dS)z'Finishes all output document rendering.©Úoutrz

N)ÚFontrÚListrrr(r%r%r&ÚFinishøs  zHTMLRenderer.FinishNcCsìg}|dur3tjtjtjfD]#}d|>}|j|@r1|j|N_t|j|ƒD] }| d|¡q'qn1d|>}|j|N_|j|@rS|j|D] }| d|¡qHnt|j|ƒD] }| d|¡qZd |¡}|rt|rt|  |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 HTML tag string. Nr4zz<%s>rr)) rÚBOLDÚITALICÚCODEÚ_fontÚreversedÚ _FONT_TAGÚappendrGr)r ÚattrrWÚtagsÚmaskÚtagÚ embellishmentr%r%r&rXs,  €û ÿ zHTMLRenderer.FontcCs4d|_|d7}|dkr d}|j d|||f¡dS)zyRenders an HTML heading. Args: level: The heading level counting from 1. heading: The heading text. ú rIé z1
%s
N)rrr©r ÚlevelÚheadingr%r%r&Ú_Heading!sÿÿzHTMLRenderer._HeadingcCst|dkr | d¡r dS| ¡|j|jd| d¡|jr%|j |j¡| ||¡d|_| d¡r8d|_ dSdS)zsRenders a heading. Args: level: The heading level counting from 1. heading: The heading text. r4z(1)NrVrTz WIDE FLAGS) Úendswithr+rXrrYrrrlrrrir%r%r&ÚHeading1s    ÿzHTMLRenderer.HeadingcCs&| ¡| ¡s| ¡d|_dSdS)z$Renders a paragraph separating line.TN)r+Ú HaveBlankrJrr(r%r%r&ÚLineDs  þzHTMLRenderer.LinecCs–d|vs | d¡rdj||p|dSd|vs| d¡r$dj||p!|dS|s,| dd ¡}d }| |¡r<|d t|ƒ …}| dd ¡d }dj||dS)z¶Renders an anchor. Args: target: The link target URL. text: The text to be displayed instead of the link. Returns: The rendered link anchor and text. ú:zwww.z){text})ÚtargetÚtextú#z..z{text}ú/r2z/helpNÚ_z.html)Ú startswithr;rmr9rK)r rrrsÚtailr%r%r&ÚLinkKs ÿÿ  zHTMLRenderer.LinkcCst dd|¡S)zŠAdd global flags links to line if any. Args: line: The text line. Returns: line with annoted global flag links. z (--[-a-z]+)z\1r,)r rMr%r%r&rPes zHTMLRenderer.LinkGlobalFlagsFcCsì| ¡|jr%|j|kr%|j |j|j¡|jd8_|jr%|j|ks |s)|s+dS|dur³|j|krc|jd7_|jt|jƒkrI|j d¡d|j|j<|jr\d|_|j d¡n"|j d¡nd|j|jvrx|j d ¡d|j|j<n|j d ¡|r|j d j|  |¡|d ¡dS|jdkr¥d|j|jvr¥|j d ¡dS|j d¡d|j|j<dS|j|krè|jd7_|jt|jƒkrÍ|j d¡d|j|j<|j d|j |dt|j ƒd¡n|j d¡|j d¡dS)zÀRenders a bullet or definition list item. Args: level: The list nesting level. definition: Bullet list if None, definition list otherwise. end: End of list if True. r4Nrz
Fz
z
Údtz rgzN
{definition}
)Ú document_idÚ definitionz
z
z
z z