KitdZddlmZdZddlZddlmZmZmZGddeZ Gdd Z Gd d eZ y) 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 eZdZy)TransformErrorN)__name__ __module__ __qualname__h/home/jay/workspace/scripts/.codegraph-venv/lib/python3.12/site-packages/docutils/transforms/__init__.pyr r !srr c&eZdZdZdZ dddZdZy) Transformz1Docutils transform component abstract base class.Nc||_ ||_ tj|jj |j |_y)zA Initial setup for in-place document transforms. N)document startnoder get_languagesettings language_codereporterlanguage)selfrrs r__init__zTransform.__init__+sI ! -" "..    + +X->->@ 5rc td)z5Override to apply the transform to the document tree.z"subclass must override this method)NotImplementedError)rkwargss rapplyzTransform.apply<s!"FGGrNreturnNone)r r r __doc__default_priorityrrr rrrr%s;I6"HrrcLeZdZdZd dZd d dZd dZd d dZd dZd dZ d d Z y) Transformerac 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 crg|_ g|_ ||_ g|_ d|_ i|_ d|_y)NFr) transformsunknown_reference_resolversrappliedsorted componentsserialno)rrs rrzTransformer.__init__NsW ,.( ! J 3 2   rNc | |j}|j|}|jj||d|fd|_y)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_stringr)appendr,)rtransform_classpriorityrpriority_strings r add_transformzTransformer.add_transformmsJ  &77H228<  otV < > rc|D]<}|j|j}|jj||dif>d|_y)z3Store multiple transforms, with default priorities.NF)r0r%r)r1r,)rtransform_listr2r4s radd_transformszTransformer.add_transforms{sQ- >O"66002O OO " " /4< > >  rc|j}| |j}|j|}|jj |||ifd|_y)z4Store a transform with an associated `pending` node.NF) transformr%r0r)r1r,)rpendingr3r2r4s r add_pendingzTransformer.add_pendingsS!++  &77H228<  ow ; = rcN|xjdz c_d||jfzS)z Return a string, `priority` combined with `self.serialno`. This ensures FIFO order on transforms with identical priority. z %03d-%03d)r.)rr3s rr0zTransformer.get_priority_strings&  h 666rcg}|D]f}t|ts|j|j||j|j <|j |jhd|_d}|j||xj|z c_|jrtjdtdyy)ao 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. Fc|jSr )r3)fs rkeyfunz4Transformer.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) isinstancerr8get_transformsr-component_typeextendr*r,sortwarningswarnDeprecationWarning)rr- resolvers componentrBs rpopulate_from_componentsz$Transformer.populate_from_componentss # DIi7    8 8 : ;8ADOOI44 5   YBB C  D   6" ((I5(  + + MMC- < ,rc@|jjj|jj|jr|j s#|jj dd|_|jj\}}}}||j|}|jdi||jj||||f|jr|jjj|jjy)z6Apply all of the stored transforms, in priority order.T)reverse)rNr ) rrattach_observernote_transform_messager)r,rJpoprr+r1detach_observer)rr3r2r;rr:s rapply_transformszTransformer.apply_transformss .. MM 0 0 2oo;;$$T$2" 9=9L9L9N 6How' II IOO %f % LL  ?GV L Moo .. MM 0 0 2rr!r )r"str) r r r r$rr5r8r<r0rPrWr rrr'r'As* > 7<<2rr') r$ __future__r __docformat__rKdocutilsrrrr rr'r rrr\sD &#" ?? % HH8C2-C2r