4 f`dZdZddlmZmZmZGddeZGddZGdd eZy ) 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. reStructuredText) languagesApplicationError TransformSpecc eZdZy)TransformErrorN)__name__ __module__ __qualname__R/var/www/equiseq/venv/lib/python3.11/site-packages/docutils/transforms/__init__.pyrrsr rc$eZdZdZdZ ddZdZy) 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->->@ 5r c td)z5Override to apply the transform to the document tree.z"subclass must override this method)NotImplementedError)rkwargss rapplyzTransform.apply9s!"FGGr N)r r r __doc__default_priorityrrr r rrr"s;I6"Hr rc>eZdZdZdZd dZdZd dZdZdZ d Z y) Transformera Store "transforms" and apply them to the document tree. Collect lists of `Transform` instances and "unknown_reference_resolvers" 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__KsS ,.(J  J 3 2   r Nc | |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_transformgsJ  &77H228<  otV < > r c|D]<}|j|j}|jj||dif>d|_y)z3Store multiple transforms, with default priorities.NF)r,r!r%r-r()rtransform_listr.r0s radd_transformszTransformer.add_transformsusQ- >O"66002O OO " " /4< > >  r c|j}| |j}|j|}|jj |||ifd|_y)z4Store a transform with an associated `pending` node.NF) transformr!r,r%r-r()rpendingr/r.r0s r add_pendingzTransformer.add_pending~sS!++  &77H228<  ow ; = r cN|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*)rr/s rr,zTransformer.get_priority_strings&  h 666r c@g}|D]f}t|ts|j|j||j|j <|j |jhd|_d}|j||xj|z c_y)an 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)r/)fs rkeyfunz4Transformer.populate_from_components..keyfuns :: r )keyN) isinstancerr4get_transformsr)component_typeextendr&r(sort)rr) resolvers componentr>s rpopulate_from_componentsz$Transformer.populate_from_componentss # DIi7    8 8 : ;8ADOOI44 5   YBB C  D   6" ((I5(r c|jjj|jj|jr|j s#|jj dd|_|jj\}}}}||j|}|jdi||jj||||f|jryy)z6Apply all of the stored transforms, in priority order.T)reverse)rNr ) rrattach_observernote_transform_messager%r(rDpoprr'r-)rr/r.r7rr6s rapply_transformszTransformer.apply_transformss .. MM 0 0 2oo;;$$T$2" 9=9L9L9N 6How' II IOO %f % LL  ?GV L Moor r) r r r r rr1r4r8r,rGrMr r rr#r#>s+ 8 762 Nr r#N) r __docformat__docutilsrrrrrr#r r rrPsC &# @? % HH8yN-yNr