+ VBivRt^RIHtRt^RIt^RIHtHtHt!RR]4t !RR4t !R R ]4t R#) a This package contains modules for standard tree transforms available to Docutils components. Tree transforms serve a variety of purposes: - To tie up certain syntax-specific "loose ends" that remain after the initial parsing of the input plaintext. These transforms are used to supplement a limited syntax. - To automate the internal linking of the document tree (hyperlink references, footnote references, etc.). - To extract useful information from the document tree. These transforms may be used to construct (for example) indexes and tables of contents. Each transform is an optional step that a Docutils component may choose to perform on the parsed document. ) annotationsreStructuredTextN) languagesApplicationError TransformSpecc]tRt^!tRtR#)TransformErrorN)__name__ __module__ __qualname____firstlineno____static_attributes__r A/usr/lib/python3.14/site-packages/docutils/transforms/__init__.pyrr!srrc6]tRt^%tRtRtRRRlltRtRtR#) Transformz1Docutils transform component abstract base class.NcV^8dQhRR/#returnNoner )formats"r __annotate__Transform.__annotate__+s66D6rc WnW n\P!VPP VP 4VnR#)z1 Initial setup for in-place document transforms. N)document startnoder get_languagesettings language_codereporterlanguage)selfrrs&&&r__init__Transform.__init__+sE ! -" "..    + +X->->@ 5rc \R4h)z5Override to apply the transform to the document tree.z"subclass must override this method)NotImplementedError)r#kwargss&,rapplyTransform.apply<s!"FGGr)rr"rN) r r r r __doc__default_priorityr$r)rr rrrr%s;I6"Hrrcv]tRt^AtRtRRltRRRlltRRltRR R lltR R lt R Rlt RRlt Rt R#) TransformeraG Store "transforms" and apply them to the document tree. Collect lists of `Transform` instances from Docutils components (`TransformSpec` instances). Apply collected "transforms" to the document tree. Also keeps track of components by component type name. https://docutils.sourceforge.io/docs/peps/pep-0258.html#transformer cV^8dQhRR/#rr )rs"rrTransformer.__annotate__NsDrc r.Vn.VnWn.VnRVn/Vn^VnR#)FN) transformsunknown_reference_resolversrappliedsorted componentsserialno)r#rs&&rr$Transformer.__init__NsU ,.( ! J 3 2   rNcV^8dQhRR/#rr )rs"rrr1ms   rc Vf VPpVPV4pVPPWARV34RVnR#)a Store a single transform. Use `priority` to override the default. `kwargs` is a dictionary whose contents are passed as keyword arguments to the `apply` method of the transform. This can be used to pass application-specific data to the transform instance. NF)r-get_priority_stringr3appendr6)r#transform_classpriorityr(priority_strings&&&, r add_transformTransformer.add_transformmsH  &77H228<  tV < > rcV^8dQhRR/#rr )rs"rrr1{src VF<pVPVP4pVPPW2R/34K> RVnR#)z3Store multiple transforms, with default priorities.NF)r<r-r3r=r6)r#transform_listr>r@s&& radd_transformsTransformer.add_transforms{sJ-O"66002O OO " " 4< > .  rcV^8dQhRR/#rr )rs"rrr1sTrc VPpVf VPpVPV4pVPP WCV/34RVnR#)z4Store a transform with an associated `pending` node.NF) transformr-r<r3r=r6)r#pendingr?r>r@s&&& r add_pendingTransformer.add_pendingsQ!++  &77H228<  w ; = rcV^8dQhRR/#)rrstrr )rs"rrr1s77s7rc \V;P^, unRWP3,#)z| Return a string, `priority` combined with `self.serialno`. This ensures FIFO order on transforms with identical priority. z %03d-%03d)r8)r#r?s&&rr<Transformer.get_priority_strings$  h 666rcV^8dQhRR/#rr )rs"rrr1s<.keyfuns :: r)keyztThe `unknown_reference_resolvers` hook chain will be removed in Docutils 1.0. Use a transform to resolve references.) stacklevelN) isinstancerrFget_transformsr7component_typeextendr4r6sortwarningswarnDeprecationWarning)r#r7 resolvers componentrVs&& rpopulate_from_components$Transformer.populate_from_componentss #Ii77    8 8 : ;8AOOI44 5   YBB C $   6" ((I5(  + + + MMC- < ,rcV^8dQhRR/#rr )rs"rrr1s22$2rc <VPPPVPP4VP'dVP 'g$VPP RR7RVnVPP4wrr4V!VPVR7pVP!R/VBVPPWW434KVPPPVPP4R#)z6Apply all of the stored transforms, in priority order.T)reverse)rNr ) rr!attach_observernote_transform_messager3r6r^popr)r5r=detach_observer)r#r?r>rKr(rJs& rapply_transformsTransformer.apply_transformss .. MM 0 0 2ooo;;;$$T$2" 9=9L9L9N 6Hw' II OO %f % LL  G L M .. MM 0 0 2r)r5r7rr8r6r3r4r+) r r r r r,r$rArFrLr<rdrmrr rrr/r/As/ > 7<<22rr/) r, __future__r __docformat__r_docutilsrrrrrr/r rrrrsD &#" ?? % HH8C2-C2r