KiF5dZddlmZdZddlZddlZddlmZmZddl m Z ddl m Z Gdd e Z Gd d e ZGd d e ZGdde ZGdde 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. - `Validate`: Validate the document tree, report violations as warning. ) annotationsreStructuredTextN)nodesutils) Transform) smartquotesc(eZdZdZdZddZdZdZy) 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 i/home/jay/workspace/scripts/.codegraph-venv/lib/python3.12/site-packages/docutils/transforms/universal.pyapplyzDecorations.apply)s++- 557J**,F MM, '++- 557J**,F MM, ' cyr )rs rr zDecorations.generate_header5src |jj}|js%|js|js |j rg}|jr |j s |j r|j r |j }n*tj|j|j }|jtjdd|tjdg|jr\tj|jtj }|j#tjd|zdz|jr{|jtjdtjdddtjd tjdd d tjd gtj$ddg|gSy) NzView document source)refuriz. zGenerated on: z Generated by Docutilsz https://docutils.sourceforge.io/z from rz(https://docutils.sourceforge.io/rst.htmlz source. )rsettings generator datestamp source_link source_url_sourcer relative_path output_pathrr referenceTexttimestrftimegmtimeappend paragraph)rr#textsourcer%s rrzDecorations.generate_footer8s==))   ("4"4##x':':D$$)9)9&&&&%00F"001E1E191A1ACF OOB(>+13JJu%'(!! MM(*<*,?@G u{{2'AB BG ~ %G24DMM , ,Q / MMW $M Es B2B2Nr4r7r8r9r:r;rrrrrLrLts  %rrLceZdZdZdZddZy)FilterMessagesz Remove system messages below verbosity threshold. Also convert nodes referencing removed messages to nodes and remove "System Messages" section if empty. ifc>g}t|jjtjD]}|d|jj j ks*|jj||dD]9}|jjj|d|j|;t|jjtjD]L}d|vs|d|vs|jj|tj|jN|jjtj D]4}d|dvs t#|dk(s|jj|6y)NlevelidsrefidrNrO)tuplerrErsystem_messagereporter report_levelrRremover]popr0 problematicreplacer,astextrSlen)r removed_idsrA_ids rrzFilterMessages.applysG $--//0D0DEF ,DG}t}}55BBB ""4(;,CMM%%))#t4&&s+, , $--//0A0ABC ED$4=K#? ##D%**T[[]*CD EMM))%--8 )D DO3D Q ""4( )rNr4rXrrrrZrZs )rrZc eZdZdZdZdZddZy) TestMessageszk Append all post-parse system messages to the end of the document. Used for testing purposes. Fipc~|jjD]$}|jr|xj|z c_&yr )rrQrR)rrVs rrzTestMessages.applys0==33 %C:: $  %rNr4)r7r8r9r:__test__r;rrrrrmrmsH%rrmceZdZdZdZddZy) StripCommentszq Remove comment elements from the document tree (only if the ``strip_comments`` setting is enabled). ic|jjjrSt|jj t j D]}|jj|yyr ) rr#strip_commentsr`rErcommentrRrdr@s rrzStripComments.applysS == ! ! 0 0dmm33EMMBC ) ""4( ) 1rNr4rXrrrrqrqs )rrqc$eZdZdZdZddZddZy)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) rr#strip_elements_with_classesstrip_elementsr`rE check_classesrRrd strip_classesrElement ValueError)rrAr{ class_values rrzStripClassesAndElements.applys == ! ! = =#ADMM$:$:$?$?#AD dmm33D4F4FGH ) ""4( )}}%%33  ..<< MM))%--8 D,  O**;7  "s D"" D.-D.ctt|tjsy|dddD]}||jvsyy)NFrOT)r?rr|ry)rrAr~s rrzz%StripClassesAndElements.check_classessA$ . ?1- Kd111 rNr4rI)r7r8r9r:r;rrzrrrrvrvs &rrvceZdZdZdZej ejfZ ej ejejejejejejfZ dZ ddZdZddZy) 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)rrrs rrzSmartQuotes.__init__s4Y?%(U"rc#K|D]}t|j|js*t|jj|jrdt|f]t j ddt|}d|fyw)Nliteralz(?<=)([-\'".`])z\\\1plain)r?rR literal_nodesstrresub)rtxtnodesrAtxts r get_tokenszSmartQuotes.get_tokens sw #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-altquotr z*No smart quotes defined for language "%s". base_node)attrlanguage)!rr# setdefault startswithAttributeError language_codesmartquotes_localesr smartcharsquotesupdatedictrEr TextElementr? nodes_to_skiprRr, option_stringget_language_codergrnormalize_language_tagrrbwarningaddeducate_tokensrsmartquotes_actionzipclear) rr alternativedocument_languagelc_smartquotesrAtxtnoderlangtagteachernewtexts rrzSmartQuotes.applys{}}--889>@   &11%8K!MM22@@//CC   " " ) ) 0 0n1E FMM))%*;*;<) ED$ 2 23$++u'8'8904||EJJ/G@G)'..*/*=*= ? @H@ ))*;B,,B1Nr4rXrrrrrWsErr)r: __future__r __docformat__rr-docutilsrrdocutils.transformsrdocutils.utilsrr r=rLrZrmrqrvrrrrrrs  #" !)&<)<~8i8(%y%.)Y)6%9%& )I )#i#Lf+)f+REyEr