o i@sbdZddlmZdZddlZddlmZmZmZGdddeZ Gdd d Z Gd d d eZ dS) 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@s eZdZdS)TransformErrorN)__name__ __module__ __qualname__r r b/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/docutils/transforms/__init__.pyr!src@s*eZdZdZdZ d d ddZddZdS) Transformz1Docutils transform component abstract base class.NreturnNonecCs(||_ ||_ t|jj|j|_dS)zA Initial setup for in-place document transforms. N)document startnoder get_languagesettings language_codereporterlanguage)selfrrr r r __init__+s zTransform.__init__cKstd)z5Override to apply the transform to the document tree.z"subclass must override this method)NotImplementedError)rkwargsr r r apply<szTransform.applyNrr)rr r __doc__default_priorityrrr r r r r %s   r c@sZeZdZdZdddZddddZdd d Zddd d ZdddZdddZ dddZ dS) 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 rrcCs:g|_ g|_ ||_ g|_ d|_ i|_ d|_dS)NFr) transformsunknown_reference_resolversrappliedsorted componentsserialno)rrr r r rNszTransformer.__init__NcKs6|dur|j}||}|j||d|fd|_dS)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)rget_priority_stringr!appendr$)rtransform_classpriorityrpriority_stringr r r add_transformms   zTransformer.add_transformcCs4|D]}||j}|j||difqd|_dS)z3Store multiple transforms, with default priorities.NF)r'rr!r(r$)rtransform_listr)r+r r r add_transforms{s  zTransformer.add_transformscCs<|j}|dur |j}||}|j|||ifd|_dS)z4Store a transform with an associated `pending` node.NF) transformrr'r!r(r$)rpendingr*r)r+r r r add_pendings   zTransformer.add_pendingstrcCs|jd7_d||jfS)z Return a string, `priority` combined with `self.serialno`. This ensures FIFO order on transforms with identical priority. z %03d-%03d)r&)rr*r r r r'szTransformer.get_priority_stringcCsg}|D]}t|ts q||||j|j<||jqd|_dd}|j |d|j|7_|jrAt j dt dddSdS) 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. FcSs|jSr)r*)fr r r keyfunsz4Transformer.populate_from_components..keyfun)keyztThe `unknown_reference_resolvers` hook chain will be removed in Docutils 1.0. Use a transform to resolve references.) stacklevelN) isinstancerr.get_transformsr%component_typeextendr"r$sortwarningswarnDeprecationWarning)rr% resolvers componentr5r r r populate_from_componentss      z$Transformer.populate_from_componentscCs|jj|jj|jr>|js|jjddd|_|j\}}}}||j|d}|jdi||j ||||f|js |jj |jjdS)z6Apply all of the stored transforms, in priority order.T)reverse)rNr ) rrattach_observernote_transform_messager!r$r=poprr#r(detach_observer)rr*r)r0rr/r r r apply_transformss zTransformer.apply_transformsrr)rr2) rr r rrr,r.r1r'rCrIr r r r r As   r ) r __future__r __docformat__r>docutilsrrrrr r r r r r s