r:g t d Z dZddlmZmZmZ G d de Z G d d Z G d d e Zd
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 e Zd ZdS )TransformErrorN)__name__
__module__ __qualname__ |/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/docutils/transforms/__init__.pyr r s Dr
r c & e Zd ZdZdZ ddZd ZdS ) Transformz1Docutils transform component abstract base class.Nc x || _ || _ t j |j j |j | _ dS )zA
Initial setup for in-place document transforms.
N)document startnoder get_languagesettings
language_codereporterlanguage)selfr r s r __init__zTransform.__init__( sF
!
-" ". +X->@ @
55r
c t d )z5Override to apply the transform to the document tree.z"subclass must override this method)NotImplementedError)r kwargss r applyzTransform.apply9 s !"FGGGr
N)r r
r __doc__default_priorityr r r r
r r r " sK ;;I6 6 6 6"H H H H Hr
r c @ e Zd ZdZd Zd
dZd Zd
dZd Zd Z d Z
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
c t g | _ g | _ || _ g | _ d| _ i | _ d| _ d S )NFr )
transformsunknown_reference_resolversr appliedsorted
componentsserialno)r r s r r zTransformer.__init__K sX ,.(J
J 3 2
r
Nc ||j }| | }| j ||d|f d| _ 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)r! get_priority_stringr% appendr( )r transform_classpriorityr priority_strings r
add_transformzTransformer.add_transformg sV &7H 228<<
otV < > > > r
c |D ]:}| |j }| j ||di f ;d| _ dS )z3Store multiple transforms, with default priorities.NF)r, r! r% r- r( )r transform_listr. r0 s r add_transformszTransformer.add_transformsu sb - > >O " 6 6 0 2 2O O " " /4<
>
>
>
> r
c |j }||j }| | }| j |||i f d| _ dS )z4Store a transform with an associated `pending` node.NF) transformr! r, r% r- r( )r pendingr/ r. r0 s r add_pendingzTransformer.add_pending~ s\ !+ &7H 228<<
ow ; = = = r
c : | xj dz
c_ d|| j fz S )z
Return a string, `priority` combined with `self.serialno`.
This ensures FIFO order on transforms with identical priority.
z %03d-%03d)r* )r r/ s r r, z Transformer.get_priority_string s&
h
666r
c @ g }|D ]h}t |t s| | || j |j < | |j id| _ d }| | | xj |z
c_ 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.
Fc | j S r )r/ )fs r keyfunz4Transformer.populate_from_components..keyfun s
: r
)keyN)
isinstancer r4 get_transformsr) component_typeextendr& r( sort)r r) resolvers componentr> s r populate_from_componentsz$Transformer.populate_from_components s # D DI i 77
8 8 : : ; ; ;8ADOI 4 5 Y B C C C C 6""" ((I5((((r
c | j j | j j | j r| j s"| j d d| _ | j \ }}}} || j | } |j di | | j
||||f | j dS dS )z6Apply all of the stored transforms, in priority order.T)reverse)r Nr ) r r attach_observernote_transform_messager% r( rD popr r' r- )r r/ r. r7 r r6 s r apply_transformsz Transformer.apply_transforms s
.. M 0 2 2 2o N;
# $$T$222 " 9= 9L9L9N9N 6How'
IIII IO % %f % % % L ?GV L M M M o N N N N Nr
r ) r r
r r r r1 r4 r8 r, rG rM r r
r r# r# > s
8 7 7 76 6 62
N
N
N
N
Nr
r# N) r
__docformat__docutilsr r r r r r# r r
r rP s
& #
@ ? ? ? ? ? ? ? ? ? % H H H H H H H H8yN yN yN yN yN- yN yN yN yN yNr