ohe+2dZdZddlZddlZddlZddlmZmZddlm Z ddl m Z Gdde Z Gd d e Z Gd d e ZGd de ZGdde ZGdde ZGdde ZGdde Zy)a Transforms needed by most or all documents: - `Decorations`: Generate a document's header & footer. - `ExposeInternals`: Expose internal attributes. - `Messages`: Placement of system messages generated after parsing. - `FilterMessages`: Remove system messages below verbosity threshold. - `TestMessages`: Like `Messages`, used on test runs. - `StripComments`: Remove comment elements from the document tree. - `StripClassesAndElements`: Remove elements with classes in `self.document.settings.strip_elements_with_classes` and class values in `self.document.settings.strip_classes`. - `SmartQuotes`: Replace ASCII quotation marks with typographic form. reStructuredTextN)nodesutils) Transform) smartquotesc&eZdZdZdZdZdZdZy) DecorationszD Populate a document's decoration element (header, footer). i4c:|j}|r;|jj}|j}|j ||j }|r<|jj}|j }|j |yyN)generate_headerdocumentget_decoration get_headerextendgenerate_footer get_footer)self header_nodes decorationheader footer_nodesfooters ?/usr/lib/python3/dist-packages/docutils/transforms/universal.pyapplyzDecorations.apply's++- 557J**,F MM, '++- 557J**,F MM, ' cyr )rs rr zDecorations.generate_header3src |jj}|js%|js|js |j r g}|jr |j s |j r|j r |j }n*tj|j|j }|jtjdd|tjdg|jrtjj!d}|r=t#j$|jt#j&t)|}n2t#j$|jt#j&}|j+tjd|zdz|jr{|jtjdtjddd tjd tjdd d tjd gtj,ddg|gSy)NzView document source)refuriz. SOURCE_DATE_EPOCHzGenerated on: z Generated by Docutilsz https://docutils.sourceforge.io/z from rz(https://docutils.sourceforge.io/rst.htmlz source. )r settings generator datestamp source_link source_url_sourcer relative_path _destinationrr referenceTextosenvirongettimestrftimegmtimeintappend paragraph)rr#textsourcesource_date_epochr%s rrzDecorations.generate_footer6s==))   ("4"4##x':':D$$)9)9&&&&%00F"001F1F191A1ACF OOB(>+13JJu%'(!!$&JJNN3F$G!$ $ h.@.@.2kk#>O:P.Q!SI!% h.@.@$++- PI EJJ'7)'Ce'KLM!! JJ/OOB +MOJJx(OOB(:,/0JJ|,./OOB2T23 3rN)__name__ __module__ __qualname____doc__default_priorityrr rrrrr r s (*rr c eZdZdZdZdZdZy)ExposeInternalszL Expose internal attributes if ``expose_internals`` setting is set. iHc8t|tj Sr ) isinstancerr,rnodes rnot_TextzExposeInternals.not_TextksdEJJ///rc|jjjrh|jj|jD]?}|jjjD]}t ||d}|||d|z<Ayy)Nz internal:)r r#expose_internalsfindallrDgetattr)rrCattvalues rrzExposeInternals.applyns~ == ! ! 2 2 --dmm< 8==11BB8C#D#t4E(27[3./8 8 3rN)r9r:r;r<r=rDrrrrr?r?cs08rr?ceZdZdZdZdZy)Messageszi Place any system messages generated after parsing into a dedicated section of the document. i\c>|jj}|Dcgc]}|jr|}}|rdtjdg}|tj ddz }||z }g|jjdd|xj|z c_yycc}w)Nsystem-messages)classesrzDocutils System Messages)r transform_messagesparentrsectiontitle)rmessagesmsgloose_messagesrRs rrzMessages.applys==33)1D##DD mm->,?@G u{{2'AB BG ~ %G24DMM , ,Q / MMW $M Es BBNr9r:r;r<r=rrrrrLrLws  %rrLceZdZdZdZdZy)FilterMessagesz Remove system messages below verbosity threshold. Convert nodes referencing removed messages to . Remove "System Messages" section if empty. ifc2t|jjtjD]b}|d|jj j ks*|jj| |jj|dd=dt|jjtjD][}|d|jjvs|jj|tj|j]|jjtjD]4}d|dvs t!|dk(s|jj|6y#t$rYbwxYw)NlevelidsrrefidrNrO)tupler rGrsystem_messagereporter report_levelrQremover\ IndexError problematicreplacer,astextrRlenrBs rrzFilterMessages.applys>$--//0D0DEF DG}t}}55BBB ""4( ))$u+a.9  $--//0A0ABC EDG}DMM$5$55 ##D%**T[[]*CD EMM))%--8 )D DO3D Q ""4( ) #s9F  FFNrWrrrrYrYs )rrYceZdZdZdZdZdZy) TestMessageszk Append all post-parse system messages to the end of the document. Used for testing purposes. Fipc~|jjD]$}|jr|xj|z c_&yr )r rPrQ)rrUs rrzTestMessages.applys0==33 %C:: $  %rN)r9r:r;r<__test__r=rrrrrjrjsH%rrjceZdZdZdZdZy) StripCommentszq Remove comment elements from the document tree (only if the ``strip_comments`` setting is enabled). ic|jjjrSt|jj t j D]}|jj|yyr ) r r#strip_commentsr_rGrcommentrQrcrBs rrzStripComments.applysS == ! ! 0 0dmm33EMMBC ) ""4( ) 1rNrWrrrrnrns )rrnc eZdZdZdZdZdZy)StripClassesAndElementsz Remove from the document tree all elements with classes in `self.document.settings.strip_elements_with_classes` and all "classes" attribute values in `self.document.settings.strip_classes`. icb|jjjruh|jjj|_t |jj |j D]}|jj||jjjsy|jjj}|jj tjD]}|D]} |dj| y#t$rY(wxYw)NrO) r r#strip_elements_with_classesstrip_elementsr_rG check_classesrQrc strip_classesrElement ValueError)rrCrx class_values rrzStripClassesAndElements.applys == ! ! = =#ADMM$:$:$?$?#AD dmm33D4F4FGH ) ""4( )}}%%33  ..<< MM))%--8 D,  O**;7  "s D"" D.-D.ctt|tjsy|dddD]}||jvsyy)NFrOT)rArryrv)rrCr{s rrwz%StripClassesAndElements.check_classessA$ . ?1- Kd111 rN)r9r:r;r<r=rrwrrrrsrss &rrsceZdZdZdZej ejfZ ej ejejejejejejfZ dZ dZdZdZy) SmartQuotesz Replace ASCII quotation marks with typographic form. Also replace multiple dashes with em-dash/en-dash characters. iWqDecRtj|||t|_y)N) startnode)r__init__setunsupported_languages)rr rs rrzSmartQuotes.__init__s4Y?%(U"rc#K|D]}t|j|js*t|jj|jrdt|f]t j ddt|}d|fyw)Nliteralz(?<=)([-\'".`])z\\\1plain)rArQ literal_nodesstrresub)rtxtnodesrCtxts r get_tokenszSmartQuotes.get_tokenssw #D4;;(:(:;dkk00$2D2DET**ff4gs4yIsl" #sB B c|jjjdd}|sy |jd}|jjj }|jjj }|r2tjjjt||jjtjD]}t||j rt|j"tjr@|jtj$Dcgc](}t|j"tj&s|*}}|j)|}|rd|vr|j+dd}n|dz }t-j.|D]"} | tjjvs | }nV||j0vr*|jj2j5d|z||j0j7|d}tj8|j;||j<|} t?|| D]4\}} |j"j+|tj$| 6|j0jAy#t$rd}YwxYwcc}w) N smart_quotesFaltz -x-altquotrz*No smart quotes defined for language "%s".) base_node)attrlanguage)!r r# setdefault startswithAttributeError language_codesmartquotes_localesr smartcharsquotesupdatedictrGr TextElementrA nodes_to_skiprQr, option_stringget_language_coderfrnormalize_language_tagrrawarningaddeducate_tokensrsmartquotes_actionzipclear) rr alternativedocument_languagelc_smartquotesrCtxtnoderlangtagteachernewtexts rrzSmartQuotes.applys{}}--889>@   &11%8K!MM22@@//CC   " " ) ) 0 0n1E FMM))%*;*;<) ED$ 2 23$++u'8'8904||EJJ/G@G)'..*/*=*= ? @H@ ))*;rs # !)&A)AH8i8(%y%6)Y)6%9%& )I )#i#Lf+)f+r