'SSKJr SSKJr SrSrSrSr"SS\5r"S S 5r "S S 5r "S S\ 5r "SS\ 5r "SS\ 5r g)) HTMLParser) zip_longest)codea)spanirr)rb)pnoteullic\^\rSrSrSrU4SjrSrU4SjrU4SjrSr Sr S r S r U=r $) 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. c<>SUlXl[TU] 5 gN)treedocsuper__init__)selfr __class__s 6lib/third_party/botocore/docs/bcdoc/docstringparser.pyrDocStringParser.__init__s  cd[R"U5 [UR5Ulgr)rresetHTMLTreerrrs rrDocStringParser.reset"s TXX& rc>[TU]U5 URR5 [ UR 5Ulgr)rfeedrwriterr)rdatars rr"DocStringParser.feed&s-  T TXX& rc>[TU]5 URR5 [ UR 5Ulgr)rcloserr#rr)rrs rr'DocStringParser.close+s*   TXX& rc6URRXS9 g)N)attrsradd_tag)rtagr*s rhandle_starttagDocStringParser.handle_starttag1s #+rc8URRUSS9 g)NF)is_startr+)rr-s r handle_endtagDocStringParser.handle_endtag4s #.rc:URRU5 gr)radd_datarr$s r handle_dataDocStringParser.handle_data7s 4 r)rr)__name__ __module__ __qualname____firstlineno____doc__rrr"r'r.r2r7__static_attributes__ __classcell__rs@rrrs0  '' ' ,/!!rrc:\rSrSrSrSrS SjrSrSrSr S r g) r;z 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. c^Xl[5UlURUl/Ulgr)rStemNodehead current_nodeunhandled_tagsrrs rrHTMLTree.__init__Bs$J  II rNcURX5(dURRU5 gU(a-[X5nURR U5 X@lgURR Ulgr)_doc_has_handlerrGappendTagNoderF add_childparent)rr-r*r1nodes rr,HTMLTree.add_tagHse$$S33    & &s +  3&D    ' ' - $  $ 1 1 8 8D rcfU(aSU-nOSU-n[URRU5$)Nstart_%send_%s)hasattrrstyle)rr-r1 handler_names rrKHTMLTree._doc_has_handlerTs- %+L#c>Ltxx~~|44rcLURR[U55 gr)rFrNDataNoder6s rr5HTMLTree.add_data\s ##HTN3rcNURRUR5 gr)rEr#rrs rr#HTMLTree.write_s !r)rFrrErG)NT) r9r:r;r<r=rr,rKr5r#r>rrrr;s  ! 954"rrc$\rSrSrSSjrSrSrg)NodecNcXlgrrO)rrOs rr Node.__init__ds rc[er)NotImplementedErrorrHs rr# Node.writegs!!rrcr)r9r:r;r<rr#r>r^rrr`r`cs "rr`cb^\rSrSrS U4SjjrSrSrSrSrSr Sr S r S r S r S rU=r$)rDkc2>[TU]U5 /Ulgr)rrchildren)rrOrs rrStemNode.__init__ls   rcFXlURRU5 gr)rOrkrLrchilds rrNStemNode.add_childps  U#rcFUR5 URU5 gr)collapse_whitespace_write_childrenrHs rr#StemNode.writets   " S!rc[URURSS5HAup#[U[5(aUbUR X5 M0UR U5 MC g)N)rrk isinstancerMr#)rrro next_childs rrsStemNode._write_childrenxsP!,T]]DMM!")StemNode.is_whitespace..sDmU&&((ms)allrkrs rr|StemNode.is_whitespacesDdmmDDDrcbUR=(a URSR5$)Nr)rkstartswith_whitespacers rrStemNode.startswith_whitespaces#}}Iq!1!G!G!IIrcbUR=(a URSR5$N)rkendswith_whitespacers rrStemNode.endswith_whitespaces#}}Hr!2!F!F!HHrcZUR(akURSR5(aIURSSUlUR(a$URSR5(aMIUR(aURSR5 gg)Nrrv)rkr|lstriprs rrStemNode.lstripssmm a 0 > > @ @ MM!"-DMmm a 0 > > @ @ == MM!  # # % rcZUR(akURSR5(aIURSSUlUR(a$URSR5(aMIUR(aURSR5 ggr)rkr|rstriprs rrStemNode.rstripssmm b 1 ? ? A A MM#2.DMmm b 1 ? ? A A == MM"  $ $ & rcUR5 UR5 URHnUR5 M g)aNRemove 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)rrrkrrrns rrrStemNode.collapse_whitespaces0  ]]E  % % '#r)rkr)r9r:r;r<rrNr#rsr|rrrrrrr>r?r@s@rrDrDks=$"!EJI& ' ( (rrDcR^\rSrSrSrS U4SjjrSrS SjrSrSr Sr S r U=r $) rMzH A generic Tag node. It will verify that handlers exist before writing. c<>[TU]U5 X lXlgr)rrr*r-)rr-r*rOrs rrTagNode.__init__s   rc:[SUR55$)Nc3B# UHn[U[5v M g7fr)rwrMr}s rr+TagNode._has_nested_tags..sI=%:eW--=s)anyrkrs r_has_nested_tagsTagNode._has_nested_tagssI4==IIIrcUR[;=(a UR5n[UR[ 5=(a7 URR[ ;=(a UR[;nU(dU(aURU5 gURU5 URU5 URX5 gr) r-OMIT_SELF_TAGSrrwrOrMPRIORITY_PARENT_TAGSOMIT_NESTED_TAGSrs _write_start _write_end)rrrxprioritize_nested_tagsprioritize_parent_tags rr# TagNode.writes HH & B4+@+@+B  t{{G , - #77 -,,  "%:   %  # S! (rcUR[;a UR5 UR5 [ UR SSUR SS5HZup[ U[5(dMUR5(dM3UR5(dMJUR5 M\ [ UR SSUR SS5HZup#[ U[5(dMUR5(dM3UR5(dMJUR5 M\ UR HnUR5 M g)aQRemove 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 Nrrv) r-HTML_BLOCK_DISPLAY_TAGSrrziprkrwrZrrrr)rprevcurnxtros rrrTagNode.collapse_whitespaces 88. . KKM KKMT]]3B/qr1BCID4**,,..--// DDMM#2. ab0ABHC3))++----// C]]E  % % '#rcSUR-n[URU5(a'[URU5"UR5 gg)NrS)r-rUrVgetattrr*)rrrWs rrTagNode._write_starts=!DHH, 399l + + CII| ,TZZ 8 ,rcSUR-n[URU5(a?US:Xa[URU5"U5 g[URU5"5 gg)NrTend_a)r-rUrVr)rrrxrWs rrTagNode._write_endsR$((* 399l + +w& <0< <02 ,r)r*r-)NNr) r9r:r;r<r=rrr#rrrrr>r?r@s@rrMrMs- J)" (D9 33rrMcj^\rSrSrSrS U4Sjjr\S5rSrSr Sr Sr S r S r S rS rU=r$)rZz( A Node that contains only string data. c >[TU]U5 [U[5(d[ S[ U5-5eSUlSUlSUlUS:XagUR5(aXlg[S[U555n[U5[S[[U5555- nUSUUlXSUlXUUlg)Nz Expecting string type, %s given.c3X# UH upUR5(aMUv M" g7frisspacer~idxchs rr$DataNode.__init__..s .GCbjjlCC* *c3X# UH upUR5(aMUv M" g7frrrs rrrs * 8GC CC8r)rrrwstr ValueErrortype_leading_whitespace_trailing_whitespace_stripped_datarnext enumeratelenreversed)rr$rOfirst_non_spacelast_non_spacers rrDataNode.__init__s  $$$?$t*LM M#% $&!  2:  <<>>(, %  (  TT* ($8* &  $((8#9 $($9!">BrcNURURUR3$rrrrrs rr$ DataNode.datas1''()<)<(=(() + rcxURS:H=(a% URS:g=(d URS:g$Nr)rrrrs rr|DataNode.is_whitespaces8""b(  $ $ * Md.G.G2.M rcxURS:g=(d% URS:H=(a URS:g$rrrs rrDataNode.startswith_whitespaces8''2-   2 % I$*C*Cr*I rcxURS:g=(d% URS:H=(a URS:g$r)rrrrs rrDataNode.endswith_whitespaces8((B.   2 % H$*B*Bb*H rcvURS:waSUlgURS:XaUR5 ggr)rrrrs rrDataNode.lstrip$s4  # #r )')D $  B & KKM'rcvURS:waSUlgURS:XaUR5 ggr)rrrrs rrDataNode.rstrip*s4  $ $ *(*D %  B & KKM'rcg)z4Noop, ``DataNode.write`` always collapses whitespaceNr^rs rrrDataNode.collapse_whitespace0srcURURR55nURSR U5UR 3nUS:waUR U5 gg)N r)translate_wordsrsplitrjoinrr7)rrwordsstr_datas rr#DataNode.write4sj##D$7$7$=$=$?@''(%(9(() +  r> OOH % rrr)r9r:r;r<r=rpropertyr$r|rrrrrrr#r>r?r@s@rrZrZsJC,       &&rrZN) html.parserr itertoolsrrrrrrrr`rDrMrZr^rrrsp#!$-3"!j"!J%"%"P""5(t5(pM3hM3`H&tH&r