U m/e'@sddlmZddlmZdZdZdZdZGdddeZGd d d Z Gd d d Z Gd dde Z Gddde Z Gddde Z dS)) HTMLParser) zip_longest)codea)spanirr)rb)pZnoteullicsXeZdZdZfddZddZfddZfdd 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__G/tmp/pip-unpacked-wheel-3gylhwtm/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_starttag1szDocStringParser.handle_starttagcCs|jj|dddS)NF)is_startr!)rr#rrr handle_endtag4szDocStringParser.handle_endtagcCs|j|dSr )radd_datarrrr handle_data7szDocStringParser.handle_data) __name__ __module__ __qualname____doc__rrrrr$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_tagsrrrrrBszHTMLTree.__init__NTcCsL|||s|j|dS|r>t||}|j|||_n |jj|_dSr )_doc_has_handlerr1appendTagNoder0 add_childparent)rr#r r%noderrrr"Hs    zHTMLTree.add_tagcCs$|rd|}nd|}t|jj|S)Nstart_%send_%s)hasattrrstyle)rr#r% handler_namerrrr2Ts zHTMLTree._doc_has_handlercCs|jt|dSr )r0r5DataNoderrrrr'\szHTMLTree.add_datacCs|j|jdSr )r/rrrrrrr_szHTMLTree.write)NT) r)r*r+r,rr"r2r'rrrrrr;s  rc@seZdZdddZddZdS)NodeNcCs ||_dSr )r6rr6rrrrdsz Node.__init__cCstdSr )NotImplementedErrorrrrrrgsz Node.write)N)r)r*r+rrrrrrr>cs r>csfeZdZdfdd ZddZddZdd Zd d Zd d ZddZ ddZ ddZ ddZ Z S)r.Ncst|g|_dSr )rrchildrenr?rrrrls zStemNode.__init__cCs||_|j|dSr )r6rAr3rchildrrrr5pszStemNode.add_childcCs|||dSr )collapse_whitespace_write_childrenrrrrrtszStemNode.writecCsNt|j|jddD]2\}}t|tr>|dk r>|||q||qdS)N)rrA isinstancer4r)rrrC next_childrrrrExszStemNode._write_childrencCstdd|jDS)Ncss|]}|VqdSr ) is_whitespace.0rCrrr sz)StemNode.is_whitespace..)allrArrrrrIszStemNode.is_whitespacecCs|jo|jdS)Nr)rAstartswith_whitespacerrrrrNszStemNode.startswith_whitespacecCs|jo|jdSN)rAendswith_whitespacerrrrrQszStemNode.endswith_whitespacecCs>|jr&|jdr&|jdd|_q|jr:|jddS)NrrF)rArIlstriprrrrrRszStemNode.lstripcCs>|jr&|jdr&|jdd|_q|jr:|jddSrO)rArIrstriprrrrrSszStemNode.rstripcCs(|||jD] }|qdS)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)rRrSrArDrBrrrrDs  zStemNode.collapse_whitespace)N)r)r*r+rr5rrErIrNrQrRrSrDr-rrrrr.ksr.csLeZdZdZdfdd ZddZdddZd d Zd d Zd dZ Z S)r4zP A generic Tag node. It will verify that handlers exist before writing. Ncst|||_||_dSr )rrr r#)rr#r r6rrrrs zTagNode.__init__cCstdd|jDS)Ncss|]}t|tVqdSr )rGr4rJrrrrLsz+TagNode._has_nested_tags..)anyrArrrr_has_nested_tagsszTagNode._has_nested_tagscCsn|jtko|}t|jto2|jjtko2|jtk}|s<|rJ||dS| |||| ||dSr ) r#OMIT_SELF_TAGSrUrGr6r4PRIORITY_PARENT_TAGSOMIT_NESTED_TAGSrE _write_start _write_end)rrrHZprioritize_nested_tagsZprioritize_parent_tagrrrrs     z TagNode.writecCs|jtkr||t|jdd|jddD]*\}}t|tr8|r8| r8|q8t|jdd|jddD]*\}}t|tr|r| r|q|jD] }| qdS)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 NrPrF) r#HTML_BLOCK_DISPLAY_TAGSrRrSziprArGr=rQrNrD)rprevcurZnxtrCrrrrDs* & &  zTagNode.collapse_whitespacecCs,d|j}t|j|r(t|j||jdS)Nr8)r#r:r;getattrr )rrr<rrrrYs  zTagNode._write_startcCsBd|j}t|j|r>|dkr0t|j||nt|j|dS)Nr9Zend_a)r#r:r;r_)rrrHr<rrrrZs   zTagNode._write_end)NN)N) r)r*r+r,rrUrrDrYrZr-rrrrr4s "r4csfeZdZdZdfdd ZeddZddZd d Zd d Z d dZ ddZ ddZ ddZ ZS)r=z0 A Node that contains only string data. Ncst|t|ts&tdt|d|_d|_d|_|dkrDdS| rV||_dSt ddt |D}t |t ddt t |D}|d||_||d|_||||_dS)Nz Expecting string type, %s given.css|]\}}|s|VqdSr isspacerKidxchrrrrLsz$DataNode.__init__..css|]\}}|s|VqdSr rarcrrrrLs)rrrGstr ValueErrortype_leading_whitespace_trailing_whitespace_stripped_datarbnext enumeratelenreversed)rrr6Zfirst_non_spaceZlast_non_spacerrrrs(   zDataNode.__init__cCs|j|j|jSr rirkrjrrrrrsz DataNode.datacCs|jdko|jdkp|jdkSNr`)rkrirjrrrrrIs zDataNode.is_whitespacecCs|jdkp|jdko|jdkSrqrprrrrrNs zDataNode.startswith_whitespacecCs|jdkp|jdko|jdkSrq)rjrkrirrrrrQs zDataNode.endswith_whitespacecCs(|jdkrd|_n|jdkr$|dSrq)rirkrSrrrrrR$s  zDataNode.lstripcCs(|jdkrd|_n|jdkr$|dSrq)rjrkrRrrrrrS*s  zDataNode.rstripcCsdS)z4Noop, ``DataNode.write`` always collapses whitespaceNrrrrrrD0szDataNode.collapse_whitespacecCs@||j}|jd||j}|dkr<||dS)N r`)Ztranslate_wordsrksplitrijoinrjr()rrwordsZstr_datarrrr4s zDataNode.write)N)r)r*r+r,rpropertyrrIrNrQrRrSrDrr-rrrrr=s r=N) html.parserr itertoolsrrWrXrVr[r rr>r.r4r=rrrr s  %(8P