o Jh'@sddlmZddlmZdZdZdZdZGdddeZGd d d Z Gd d d Z Gd dde Z Gddde Z Gddde Z dS)) HTMLParser) zip_longest)codea)spanirr)rb)pnoteullicsXeZdZdZfddZddZfddZfdd Zd d Zd d Z ddZ Z S)DocStringParserz A simple HTML parser. Focused on converting the subset of HTML that appears in the documentation strings of the JSON models into simple ReST format. csd|_||_tdSN)treedocsuper__init__selfr __class__/var/www/vedio/testing/chatpythonscript.ninositsolution.com/env/lib/python3.10/site-packages/botocore/docs/bcdoc/docstringparser.pyrszDocStringParser.__init__cCst|t|j|_dSr)rresetHTMLTreerrrrrrr"s zDocStringParser.resetcs&t||jt|j|_dSr)rfeedrwriterrrdatarrrr&s  zDocStringParser.feedcs$t|jt|j|_dSr)rcloserrrrrrrrr +s  zDocStringParser.closecCs|jj||ddS)N)attrsradd_tag)rtagr!rrrhandle_starttag1zDocStringParser.handle_starttagcCs|jj|dddS)NF)is_startr")rr$rrr handle_endtag4r&zDocStringParser.handle_endtagcCs|j|dSr)radd_datarrrr handle_data7szDocStringParser.handle_data) __name__ __module__ __qualname____doc__rrrr r%r(r* __classcell__rrrrr s   r c@s:eZdZdZddZdddZdd Zd d Zd d ZdS)rz A tree which handles HTML nodes. Designed to work with a python HTML parser, meaning that the current_node will be the most recently opened tag. When a tag is closed, the current_node moves up to the parent node. cCs ||_t|_|j|_g|_dSr)rStemNodehead current_nodeunhandled_tagsrrrrrBs zHTMLTree.__init__NTcCsN|||s|j|dS|r t||}|j|||_dS|jj|_dSr)_doc_has_handlerr3appendTagNoder2 add_childparent)rr$r!r'noderrrr#Hs     zHTMLTree.add_tagcCs(|rd|}nd|}t|jj|S)Nstart_end_)hasattrrstyle)rr$r' handler_namerrrr4Ts  zHTMLTree._doc_has_handlercCs|jt|dSr)r2r7DataNoderrrrr)\r&zHTMLTree.add_datacCs|j|jdSr)r1rrrrrrr_szHTMLTree.write)NT) r+r,r-r.rr#r4r)rrrrrr;s   rc@seZdZdddZddZdS)NodeNcCs ||_dSr)r8rr8rrrrds z Node.__init__cCstr)NotImplementedErrorrrrrrgsz Node.writer)r+r,r-rrrrrrr@cs  r@csfeZdZdfdd ZddZddZdd Zd d Zd d ZddZ ddZ ddZ ddZ Z S)r0Ncst|g|_dSr)rrchildrenrArrrrls  zStemNode.__init__cCs||_|j|dSr)r8rCr5rchildrrrr7pszStemNode.add_childcCs|||dSr)collapse_whitespace_write_childrenrrrrrtszStemNode.writecCsNt|j|jddD]\}}t|tr|dur|||q ||q dS)N)rrC isinstancer6r)rrrE next_childrrrrGxs  zStemNode._write_childrencCtdd|jDS)Ncss|]}|VqdSr) is_whitespace.0rErrr sz)StemNode.is_whitespace..)allrCrrrrrLr&zStemNode.is_whitespacecC|jo |jdS)Nr)rCstartswith_whitespacerrrrrRr&zStemNode.startswith_whitespacecCrQN)rCendswith_whitespacerrrrrUr&zStemNode.endswith_whitespacecCsT|jr|jdr|jdd|_|jr|jds |jr(|jddSdS)NrrH)rCrLlstriprrrrrV zStemNode.lstripcCsT|jr|jdr|jdd|_|jr|jds |jr(|jddSdSrS)rCrLrstriprrrrrXrWzStemNode.rstripcCs(|||jD]}|q dS)a~Remove collapsible white-space from HTML. HTML in docstrings often contains extraneous white-space around tags, for readability. Browsers would collapse this white-space before rendering. If not removed before conversion to RST where white-space is part of the syntax, for example for indentation, it can result in incorrect output. N)rVrXrCrFrDrrrrFs    zStemNode.collapse_whitespacer)r+r,r-rr7rrGrLrRrUrVrXrFr/rrrrr0ksr0csLeZdZdZdfdd ZddZdddZd d Zd d Zd dZ Z S)r6zP A generic Tag node. It will verify that handlers exist before writing. Ncst|||_||_dSr)rrr!r$)rr$r!r8rrrrs  zTagNode.__init__cCrK)Ncss|]}t|tVqdSr)rIr6rMrrrrOsz+TagNode._has_nested_tags..)anyrCrrrr_has_nested_tagsszTagNode._has_nested_tagscCsn|jtvo|}t|jto|jjtvo|jtv}|s|r%||dS| |||| ||dSr) r$OMIT_SELF_TAGSrZrIr8r6PRIORITY_PARENT_TAGSOMIT_NESTED_TAGSrG _write_start _write_end)rrrJprioritize_nested_tagsprioritize_parent_tagrrrrs     z TagNode.writecCs|jtvr ||t|jdd|jddD]\}}t|tr1|r1| r1|qt|jdd|jddD]\}}t|trV|rV| rV|qA|jD]}| qZdS)aRemove collapsible white-space. All tags collapse internal whitespace. Block-display HTML tags also strip all leading and trailing whitespace. Approximately follows the specification used in browsers: https://www.w3.org/TR/css-text-3/#white-space-rules https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model/Whitespace NrTrH) r$HTML_BLOCK_DISPLAY_TAGSrVrXziprCrIr?rUrRrF)rprevcurnxtrErrrrFs0 &&  zTagNode.collapse_whitespacecCs2d|j}t|j|rt|j||jdSdS)Nr:)r$r<r=getattrr!)rrr>rrrr^s  zTagNode._write_startcCsJd|j}t|j|r#|dkrt|j||dSt|j|dSdS)Nr;end_a)r$r<r=rg)rrrJr>rrrr_s  zTagNode._write_end)NNr) r+r,r-r.rrZrrFr^r_r/rrrrr6s "r6csfeZdZdZdfdd ZeddZddZd d Zd d Z d dZ ddZ ddZ ddZ ZS)r?z0 A Node that contains only string data. Ncst|t|tstdt|dd|_d|_d|_|dkr$dS| r-||_dSt ddt |D}t |t ddt t |D}|d||_||d|_||||_dS)NzExpecting string type, z given.cs |] \}}|s|VqdSrisspacerNidxchrrrrO   z$DataNode.__init__..csrjrrkrmrrrrOrp)rrrIstr ValueErrortype_leading_whitespace_trailing_whitespace_stripped_datarlnext enumeratelenreversed)rrr8first_non_spacelast_non_spacerrrrs(    zDataNode.__init__cCs|j|j|jSrrtrvrurrrrrs z DataNode.datacCs|jdko|jdkp|jdkSNri)rvrtrurrrrrL zDataNode.is_whitespacecC|jdkp|jdko|jdkSr~r}rrrrrRrzDataNode.startswith_whitespacecCrr~)rurvrtrrrrrUrzDataNode.endswith_whitespacecC.|jdkr d|_dS|jdkr|dSdSr~)rtrvrXrrrrrV$    zDataNode.lstripcCrr~)rurvrVrrrrrX*rzDataNode.rstripcCsdS)z4Noop, ``DataNode.write`` always collapses whitespaceNrrrrrrF0szDataNode.collapse_whitespacecCsD||j}|jd||j}|dkr ||dSdS)N ri)translate_wordsrvsplitrtjoinrur*)rrwordsstr_datarrrr4szDataNode.writer)r+r,r-r.rpropertyrrLrRrUrVrXrFrr/rrrrr?s r?N) html.parserr itertoolsrr\r]r[rbr rr@r0r6r?rrrrs %(8P