o Ni8@sNdZdZddlmZmZmZGdddeZGdddZGdd d eZd S) 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@s eZdZdS)TransformErrorN)__name__ __module__ __qualname__r r P/home/ubuntu/.local/lib/python3.10/site-packages/docutils/transforms/__init__.pyrsrc@s(eZdZdZdZ dddZddZdS) Transformz1Docutils transform component abstract base class.NcCs(||_ ||_ t|jj|j|_dS)zA Initial setup for in-place document transforms. N)document startnoder get_languagesettings language_codereporterlanguage)selfr rr 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 apply9szTransform.applyN)rrr __doc__default_priorityrrr r r r r "s   r c@sLeZdZdZddZdddZddZdd d Zd d Zd dZ ddZ dS) 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 cCs:g|_ g|_ ||_ g|_ d|_ i|_ d|_dS)NFr) transformsunknown_reference_resolversr appliedsorted componentsserialno)rr r r r rKszTransformer.__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_stringrappendr )rtransform_classpriorityrpriority_stringr r r add_transformgs   zTransformer.add_transformcCs4|D]}||j}|j||difqd|_dS)z3Store multiple transforms, with default priorities.NF)r#rrr$r )rtransform_listr%r'r r r add_transformsus  zTransformer.add_transformscCs<|j}|dur |j}||}|j|||ifd|_dS)z4Store a transform with an associated `pending` node.NF) transformrr#rr$r )rpendingr&r%r'r r r add_pending~s   zTransformer.add_pendingcCs|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_stringcCslg}|D]}t|ts q||||j|j<||jqd|_dd}|j |d|j|7_dS)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. FcSs|jSr)r&)fr r r keyfunsz4Transformer.populate_from_components..keyfun)keyN) isinstancerr*get_transformsr!component_typeextendrr sort)rr! resolvers componentr0r 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 ) r rattach_observernote_transform_messagerr r6poprrr$detach_observer)rr&r%r,rr+r r r apply_transformss zTransformer.apply_transformsr) rrr rrr(r*r-r#r9r?r r r r r>s    rN) r __docformat__docutilsrrrrr rr r r r s