o iF5@sdZddlmZdZddlZddlZddlmZmZddl m Z ddl m Z Gdd d e Z Gd d d e ZGd d d e ZGddde ZGddde ZGddde ZGddde ZGddde ZGddde ZdS)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. - `Validate`: Validate the document tree, report violations as warning. ) annotationsreStructuredTextN)nodesutils) Transform) smartquotesc@s.eZdZdZdZd ddZddZd d Zd S) DecorationszD Populate a document's decoration element (header, footer). i4returnNonecCsX|}|r|j}|}|||}|r*|j}|}||dSdSN)generate_headerdocumentget_decoration get_headerextendgenerate_footer get_footer)self header_nodes decorationheader footer_nodesfooterrc/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/docutils/transforms/universal.pyapply)s   zDecorations.applycCsdSr r)rrrrr 5szDecorations.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 output_pathrr referenceTexttimestrftimegmtimeappend paragraph)rrtextsourcer!rrrr8sL   zDecorations.generate_footerNr r )__name__ __module__ __qualname____doc__default_priorityrr rrrrrr!s   rc@(eZdZdZdZd ddZd dd Zd S) ExposeInternalszL Expose internal attributes if ``expose_internals`` setting is set. iHr boolcCst|tj Sr ) isinstancerr(rnoderrrnot_TexthszExposeInternals.not_Textr cCsV|jjjr'|j|jD]}|jjjD]}t||d}|dur%||d|<qq dSdS)Nz internal:)r rexpose_internalsfindallr<getattr)rr;attvaluerrrrks   zExposeInternals.applyNr r8r0)r1r2r3r4r5r<rrrrrr7`s  r7c@eZdZdZdZdddZdS) MessageszHandle "loose" messages. Place system messages generated by parsing or transforms that are not attached to the document tree into a dedicated section of the document. i\r r cCsrg|jj|jj}dd|D}|r7tjdgd}|tdd7}||7}g|jjdd<|j|7_dSdS)NcSsg|]}|js|qSr)parent).0msgrrr sz"Messages.apply..system-messages)classesrzDocutils System Messages)r parse_messagestransform_messagesrsectiontitle)rmessagesloose_messagesrMrrrr~s zMessages.applyNr0r1r2r3r4r5rrrrrrDtsrDc@rC) FilterMessagesz Remove system messages below verbosity threshold. Also convert nodes referencing removed messages to nodes and remove "System Messages" section if empty. ifr r cCsg}t|jtjD]%}|d|jjjkr0|j||dD]}|jj |d| |q q t|jtj D]}d|vrR|d|vrR|j |t|q:|jtjD]}d|dvrnt|dkrn|j|qZdS)NlevelidsrefidrIrJ)tupler r>rsystem_messagereporter report_levelrEremoverTpopr, problematicreplacer(astextrMlen)r removed_idsr;_idrrrrs"    zFilterMessages.applyNr0rQrrrrrRsrRc@s"eZdZdZdZdZd ddZdS) TestMessageszk Append all post-parse system messages to the end of the document. Used for testing purposes. Fipr r cCs&|jjD] }|js|j|7_qdSr )r rLrE)rrGrrrrs zTestMessages.applyNr0)r1r2r3r4__test__r5rrrrrrcs rcc@rC) StripCommentszq Remove comment elements from the document tree (only if the ``strip_comments`` setting is enabled). ir r cCs6|jjjrt|jtjD] }|j|qdSdSr ) r rstrip_commentsrWr>rcommentrEr[r:rrrrs zStripComments.applyNr0rQrrrrresrec@r6) 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`. ir r c Cs|jjjrh|jjj|_t|j|jD]}|j|q|jjj s&dS|jjj }|jt j D]}|D]}z |d|Wq6t yJYq6wq2dS)NrJ) r rstrip_elements_with_classesstrip_elementsrWr> check_classesrEr[ strip_classesrElement ValueError)rr;rl class_valuerrrrs$    zStripClassesAndElements.applyr8cCs:t|tjsdS|dddD] }||jvrdSqdS)NFrJT)r9rrmrj)rr;rorrrrks  z%StripClassesAndElements.check_classesNr0rB)r1r2r3r4r5rrkrrrrrhs  rhc@sfeZdZdZdZejejfZ ejejej ej ej ej ej fZ dZ d ddZdd Zd d d Zd S) SmartQuotesz Replace ASCII quotation marks with typographic form. Also replace multiple dashes with em-dash/en-dash characters. iWqDer r cCstj|||dt|_dS)N) startnode)r__init__setunsupported_languages)rr rrrrrrss zSmartQuotes.__init__ccsZ|D]'}t|j|jst|jj|jrdt|fVqtddt|}d|fVqdS)Nliteralz(?<=)([-\'".`])z\\\1plain)r9rE literal_nodesstrresub)rtxtnodesr;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_quotesFaltcSsg|] }t|jtjs|qSr)r9rEr option_string)rFtxtnoderrrrH2s  z%SmartQuotes.apply..z -x-altquotrz*No smart quotes defined for language "%s". base_node)attrlanguage) r r setdefault startswithAttributeError language_codesmartquotes_localesr smartcharsquotesupdatedictr>r TextElementr9 nodes_to_skiprEr(get_language_coder^rnormalize_language_tagrurYwarningaddeducate_tokensr~smartquotes_actionzipclear) rr alternativedocument_languagelc_smartquotesr;r|langtagteacherrnewtextrrrrsZ         zSmartQuotes.applyNr0)r1r2r3r4r5rFixedTextElementSpecialrimagervmathrawr]rxrrsr~rrrrrrps    rpc@rC) ValidatezC Validate the document tree, report violations as warning. iCr r c Cszt|jjdds dS|jD]+}z|jddWqtjy:}z|jjjt ||j p-|dWYd}~qd}~wwdS)NvalidateF) recursiver) r?r rr>rrValidationErrorrYrryproblematic_element)rr;errrr_szValidate.applyNr0rQrrrrrWsr)r4 __future__r __docformat__rzr)docutilsrrdocutils.transformsrdocutils.utilsrrr7rDrRrcrerhrprrrrrs"   ?&i