o N=&b0@sdZdZddlZddlZddlmZmZddlmZddl m Z GdddeZ Gd d d eZ Gd d d eZ Gd ddeZGdddeZGdddeZGdddeZGdddeZdS)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@s,eZdZdZdZddZddZddZd S) DecorationszD Populate a document's decoration element (header, footer). i4cCsX|}|r|j}|}|||}|r*|j}|}||dSdSN)generate_headerdocumentZget_decorationZ get_headerextendgenerate_footerZ get_footer)selfZ header_nodesZ decorationheaderZ footer_nodesZfooterrAusr/lib/python3.10/site-packages/docutils/transforms/universal.pyapply&s   zDecorations.applycCsdSrr)r rrrr 2szDecorations.generate_headerc Cs|jj}|js|js|js|jrg}|jr|js|jr:|jr"|j}nt|j |j}| t j dd|dt dg|jrRt|jt}|t d|d|jrt| t dt j ddddt d t j dd d dt d gt jddg|RgSdS) NzView document source)Zrefuriz. zGenerated on: z Generated by ZDocutilsz https://docutils.sourceforge.io/z from rz(https://docutils.sourceforge.io/rst.htmlz source. )r settings generator datestampZ source_linkZ source_url_sourcerZ relative_pathZ _destinationr r referenceTexttimestrftimegmtimeappendZ paragraph)r rtextsourcerrrrr 5sL   zDecorations.generate_footerN)__name__ __module__ __qualname____doc__default_priorityrr r rrrrrs  rc@$eZdZdZdZddZddZdS)ExposeInternalszL Expose internal attributes if ``expose_internals`` setting is set. iHcCst|tj Sr) isinstancerrr noderrrnot_TexteszExposeInternals.not_TextcCsV|jjjr'|j|jD]}|jjjD]}t||d}|dur%||d|<qq dSdS)Nz internal:)r rZexpose_internalsfindallr)getattr)r r(Zattvaluerrrrhs   zExposeInternals.applyN)rr r!r"r#r)rrrrrr%]s  r%c@eZdZdZdZddZdS)Messageszi Place any system messages generated after parsing into a dedicated section of the document. i\cCsf|jj}dd|D}|r1tjdgd}|tdd7}||7}g|jjdd<|j|7_dSdS)NcSsg|]}|js|qSr)parent).0msgrrr |sz"Messages.apply..system-messages)classesrzDocutils System Messages)r transform_messagesrsectiontitle)r Z unfilteredmessagesr6rrrrzszMessages.applyNrr r!r"r#rrrrrr.q r.c@r-)FilterMessagesz Remove system messages below verbosity threshold. Convert nodes referencing removed messages to . Remove "System Messages" section if empty. ifc Cst|jtjD]&}|d|jjjkr/|j|z |jj |dd=Wq t y.Yq wq t|jtj D]}|d|jj vrO|j |t |q9|jtjD]}d|dvrkt|dkrk|j|qWdS)NlevelidsrZrefidr3r4)tupler r*rZsystem_messagereporterZ report_levelr/remover= IndexError problematicreplacerZastextr6lenr'rrrrs$   zFilterMessages.applyNr9rrrrr;s r;c@r-) TestMessageszk Append all post-parse system messages to the end of the document. Used for testing purposes. ipcCs&|jjD] }|js|j|7_qdSr)r r5r/)r r1rrrrs zTestMessages.applyNr9rrrrrFs rFc@r-) StripCommentszq Remove comment elements from the document tree (only if the ``strip_comments`` setting is enabled). icCs6|jjjrt|jtjD] }|j|qdSdSr) r rstrip_commentsr?r*rcommentr/rAr'rrrrs zStripComments.applyNr9rrrrrGr:rGc@r$)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`. ic Cs|jjjrh|jjj|_t|j|jD]}|j|q|jjj s&dS|jjj }|jt j D]}|D]}z |d|Wq6t yJYq6wq2dS)Nr4) r rZstrip_elements_with_classesstrip_elementsr?r* check_classesr/rA strip_classesrElement ValueError)r r(rM class_valuerrrrs$    zStripClassesAndElements.applycCs:t|tjsdS|dddD] }||jvrdSqdS)NFr4T)r&rrNrK)r r(rPrrrrLs  z%StripClassesAndElements.check_classesN)rr r!r"r#rrLrrrrrJs  rJc@sbeZdZdZdZejejfZ ejejej ej ej ej ej fZ dZ ddZddZdd Zd S) SmartQuotesz Replace ASCII quotation marks with typographic form. Also replace multiple dashes with em-dash/en-dash characters. iWZqDecCstj|||dt|_dS)N) startnode)r__init__setunsupported_languages)r r rRrrrrSs zSmartQuotes.__init__ccsZ|D]'}t|j|jst|jj|jrdt|fVqtddt|}d|fVqdS)Nliteralz(?<=)([-\'".`])z\\\1plain)r&r/ literal_nodesstrresub)r txtnodesr(txtrrr get_tokens s zSmartQuotes.get_tokensc Cs~|jjdd}|s dSz|d}Wn tyd}Ynw|jjj}|jjj}|r4tjj t ||j t jD]|}t||jrDq;t|jt jrLq;dd| t jD}||}|rmd|vri|dd}n|d7}t|D] }|tjj vr~|}nqr||jvr|jjjd||d |j|d}tj|||j|d } t|| D]\} } | j| t | qq;|jdS) N smart_quotesFZaltcSsg|] }t|jtjs|qSr)r&r/rZ option_string)r0txtnoderrrr20s  z%SmartQuotes.apply..z -x-altquotrz*No smart quotes defined for language "%s".)Z base_node)attrlanguage) r r setdefault startswithAttributeErrorZ language_codeZsmartquotes_localesrZ smartcharsquotesupdatedictr*rZ TextElementr& nodes_to_skipr/rZget_language_coderDrZnormalize_language_tagrUr@warningaddZeducate_tokensr^smartquotes_actionzipclear) r r_ alternativeZdocument_languageZlc_smartquotesr(r\langtagZteacherr`ZnewtextrrrrsZ         zSmartQuotes.applyN)rr r!r"r#rZFixedTextElementSpecialriimagerVmathrawrCrXrlrSr^rrrrrrQs   rQ)r"Z __docformat__rZrdocutilsrrZdocutils.transformsrZdocutils.utilsrrr%r.r;rFrGrJrQrrrrs  ?&