o Ni]0@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_headerdocumentget_decoration get_headerextendgenerate_footer get_footer)self header_nodes decorationheader footer_nodesfooterrQ/home/ubuntu/.local/lib/python3.10/site-packages/docutils/transforms/universal.pyapply&s   zDecorations.applycCsdSrr)rrrrr 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)refuriz. zGenerated 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 _destinationr r referenceTexttimestrftimegmtimeappend paragraph)rrtextsourcerrrrr5sL   zDecorations.generate_footerN)__name__ __module__ __qualname____doc__default_priorityrr rrrrrrs  rc@$eZdZdZdZddZddZdS)ExposeInternalszL Expose internal attributes if ``expose_internals`` setting is set. iHcCst|tj Sr) isinstancerr%rnoderrrnot_TexteszExposeInternals.not_TextcCsV|jjjr'|j|jD]}|jjjD]}t||d}|dur%||d|<qq dSdS)Nz internal:)r rexpose_internalsfindallr7getattr)rr6attvaluerrrrhs   zExposeInternals.applyN)r-r.r/r0r1r7rrrrrr3]s  r3c@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)rmessagesloose_messagesrFrrrrzszMessages.applyNr-r.r/r0r1rrrrrr>q r>c@r=)FilterMessagesz Remove system messages below verbosity threshold. Also convert nodes referencing removed messages to nodes and 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)NlevelidsrrefidrCrD)tupler r9rsystem_messagereporter report_levelr?removerN IndexError problematicreplacer%astextrFlenr5rrrrs$   zFilterMessages.applyNrJrrrrrLs rLc@s eZdZdZdZdZddZdS) TestMessageszk Append all post-parse system messages to the end of the document. Used for testing purposes. FipcCs&|jjD] }|js|j|7_qdSr)r rEr?)rrArrrrs zTestMessages.applyN)r-r.r/r0__test__r1rrrrrr[s  r[c@r=) StripCommentszq Remove comment elements from the document tree (only if the ``strip_comments`` setting is enabled). icCs6|jjjrt|jtjD] }|j|qdSdSr) r rstrip_commentsrQr9rcommentr?rUr5rrrrs zStripComments.applyNrJrrrrr]rKr]c@r2)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)NrD) r rstrip_elements_with_classesstrip_elementsrQr9 check_classesr?rU strip_classesrElement ValueError)rr6rd class_valuerrrrs$    zStripClassesAndElements.applycCs:t|tjsdS|dddD] }||jvrdSqdS)NFrDT)r4rrerb)rr6rgrrrrcs  z%StripClassesAndElements.check_classesN)r-r.r/r0r1rrcrrrrr`s  r`c@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. iWqDecCstj|||dt|_dS)N) startnode)r__init__setunsupported_languages)rr rjrrrrks zSmartQuotes.__init__ccsZ|D]'}t|j|jst|jj|jrdt|fVqtddt|}d|fVqdS)Nliteralz(?<=)([-\'".`])z\\\1plain)r4r? literal_nodesstrresub)rtxtnodesr6txtrrr get_tokenss 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_quotesFaltcSsg|] }t|jtjs|qSr)r4r?r option_string)r@txtnoderrrrB-s  z%SmartQuotes.apply..z -x-altquotrz*No smart quotes defined for language "%s".) base_node)attrlanguage) r r setdefault startswithAttributeError language_codesmartquotes_localesr smartcharsquotesupdatedictr9r TextElementr4 nodes_to_skipr?r%get_language_coderXrnormalize_language_tagrmrSwarningaddeducate_tokensrvsmartquotes_actionzipclear) rrw alternativedocument_languagelc_smartquotesr6rtlangtagteacherrznewtextrrrrsZ         zSmartQuotes.applyN)r-r.r/r0r1rFixedTextElementSpecialrimagernmathrawrWrprrkrvrrrrrrhs   rh)r0 __docformat__rrr&docutilsrrdocutils.transformsrdocutils.utilsrrr3r>rLr[r]r`rhrrrrs  ?&