k7itSrSSKJr SrSSKrSSKJrJrJr "SS\5r "SS 5r "S S \5r g) 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\rSrSrSrg)TransformError!N)__name__ __module__ __qualname____firstlineno____static_attributes__r V/home/james-whalen/.local/lib/python3.13/site-packages/docutils/transforms/__init__.pyr r !srr c2\rSrSrSrSrSSSjjrSrSrg) Transform%z1Docutils transform component abstract base class.NcXlX l[R"URR UR 5Ulg)z1 Initial setup for in-place document transforms. N)document startnoder get_languagesettings language_codereporterlanguage)selfrrs r__init__Transform.__init__+sE ! -" "..    + +X->->@ 5rc [S5e)z5Override to apply the transform to the document tree.z"subclass must override this method)NotImplementedError)rkwargss rapplyTransform.apply<s!"FGGr)rrrNreturnNone) r r rr__doc__default_priorityrr$rr rrrr%s;I6"Hrrcf\rSrSrSrS SjrS S SjjrS SjrS S SjjrSSjr S S jr S S jr S r g) TransformerAaG 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 cp/Ul/UlXl/UlSUl0UlSUlg)NFr) transformsunknown_reference_resolversrappliedsorted componentsserialno)rrs rrTransformer.__init__NsU ,.( ! J 3 2   rNc Uc URnURU5nURRXASU45 SUlg)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_stringr0appendr3)rtransform_classpriorityr#priority_strings r add_transformTransformer.add_transformmsH  &77H228<  tV < > rcUH<nURUR5nURRX2S045 M> SUlg)z3Store multiple transforms, with default priorities.NF)r8r+r0r9r3)rtransform_listr:r<s radd_transformsTransformer.add_transforms{sJ-O"66002O OO " " 4< > .  rcURnUc URnURU5nURR XCU045 SUlg)z4Store a transform with an associated `pending` node.NF) transformr+r8r0r9r3)rpendingr;r:r<s r add_pendingTransformer.add_pendingsQ!++  &77H228<  w ; = rcLU=RS- slSXR4-$)z| Return a string, `priority` combined with `self.serialno`. This ensures FIFO order on transforms with identical priority. z %03d-%03d)r5)rr;s rr8Transformer.get_priority_strings$  h 666rc/nUHln[U[5(dMURUR55 X0RUR 'UR UR5 Mn SUlSnURUS9 U=RU- slUR(a[R"S[SS9 gg)a? Store each component's default transforms and reference resolvers. Transforms are stored with default priorities for later sorting. "Unknown reference resolvers" are sorted and stored. Components that don't inherit from `TransformSpec` are ignored. Also, store components by type name in a mapping for later lookup. FcUR$r&)r;)fs rkeyfun4Transformer.populate_from_components..keyfuns :: r)keyztThe `unknown_reference_resolvers` hook chain will be removed in Docutils 1.0. Use a transform to resolve references.) stacklevelN) isinstancerrAget_transformsr4component_typeextendr1r3sortwarningswarnDeprecationWarning)rr4 resolvers componentrNs rpopulate_from_components$Transformer.populate_from_componentss #Ii77    8 8 : ;8AOOI44 5   YBB C $   6" ((I5(  + + MMC- < ,rcLURRRURR5 UR(aUR (d URR SS9 SUlURR5upp4U"URUS9nUR"S0UD6 URRXX445 UR(aMURRRURR5 g)z6Apply all of the stored transforms, in priority order.T)reverse)rNr ) rrattach_observernote_transform_messager0r3rWpopr$r2r9detach_observer)rr;r:rEr#rDs rapply_transformsTransformer.apply_transformss .. MM 0 0 2oo;;$$T$2" 9=9L9L9N 6Hw' II OO %f % LL  G L Mooo .. MM 0 0 2r)r2r4rr5r3r0r1r'r&)r(str) r r rrr*rr=rArFr8r]rerr rrr-r-As* > 7<<2rr-) r* __future__r __docformat__rXdocutilsrrrr rr-r rrrksD &#" ?? % HH8C2-C2r