+
    VBi0                    
   R t ^ RIHt ^ RIHt Rt]'       Ed   ^ RIHt ^ RIH	t	H
t
HtHtHt ^ RIHt ^ RIHt ]R,          t]]]],          ]]]	3,          3,          t]R,          t]]]R	,          ]R	,          ]],          3,          ]]R	,          ]R	,          ]],          ]R	,          ]R	,          ]],          3,          ]]R	,          ]R	,          ]],          ]R	,          ]R	,          ]],          ]R	,          ]R	,          ]],          3	,          3,          t ! R
 R]4      tRtRt Rt  ! R R]! RR4      4      t]! ^ ^^R^ RR7      t  ! R R] 4      t! ! R R]!4      t" ! R R4      t# ! R R4      t$ ! R R]#]$4      t%R	# ) ak  
This is the Docutils (Python Documentation Utilities) package.

Package Structure
=================

Modules:

- __init__.py: Contains component base classes, exception classes, and
  Docutils version information.

- core.py: Contains the ``Publisher`` class and ``publish_*()`` convenience
  functions.

- frontend.py: Runtime settings (command-line interface, configuration files)
  processing, for Docutils front-ends.

- io.py: Provides a uniform API for low-level input and output.

- nodes.py: Docutils document tree (doctree) node class library.

- statemachine.py: A finite state machine specialized for
  regular-expression-based text filters.

Subpackages:

- languages: Language-specific mappings of terms.

- parsers: Syntax-specific input parser modules or packages.

- readers: Context-specific input handlers which understand the data
  source and manage a parser.

- transforms: Modules used by readers and writers to modify
  the Docutils document tree.

- utils: Contains the ``Reporter`` system warning class and miscellaneous
  utilities used by readers, writers, and transforms.

  utils/urischemes.py: Contains a complete mapping of known URI addressing
  scheme names to descriptions.

- utils/math: Contains functions for conversion of mathematical notation
  between different formats (LaTeX, MathML, text, ...).

- writers: Format-specific output translators.
)annotations)
namedtupleF)Sequence)AnyClassVarLiteralProtocolUnion)Element)	TransformfinalNc                  2    ] tR t^Mt$ RtR]R&   R R ltRtR# )_UnknownReferenceResolveru-   Deprecated. Will be removed in Docutils 1.0.intpriorityc                    V ^8  d   QhRRRR/# )   noder
   returnbool )formats   "6/usr/lib/python3.14/site-packages/docutils/__init__.py__annotate__&_UnknownReferenceResolver.__annotate__S   s     	 	 	 	    c               	    R # Nr   )selfr   s   ""r   __call__"_UnknownReferenceResolver.__call__S   s    r   r   N)__name__
__module____qualname____firstlineno____doc____annotations__r   __static_attributes__r   r   r   r   r   M   s    ; 	 	r   r   reStructuredTextz0.22.3 c                     a  ] tR t^jt$ RtR]R&   R]R&   R]R&   R]R&   R]R&   R]R	&   RR
 V 3R llltR R ltR R ltR R lt	R R lt
RtV ;t# )VersionInfor   majorminormicro_ReleaseLevelsreleaselevelserialr   releasec               4    V ^8  d   QhRRRRRRRRRRRR	R
R/# )r   r,   r   r-   r.   r0   r/   r1   r2   r   r   r+   r   )r   s   "r   r   VersionInfo.__annotate__u   sJ     > >>'*>7:>,> > +/> !	>r   c           	     	   < RpWG9  d   \        RV: R24      hVR8X  d&   V'       g   \        R4      hV^ 8w  d   \        R4      h\        SV `	  WW#WEV4      # )alphar   zreleaselevel must be one of .z{releaselevel "final" must not be used with development versions (leads to wrong version ordering of the related __version__z%"serial" must be 0 for final releasesr6   beta	candidater   )
ValueErrorsuper__new__)	clsr,   r-   r.   r0   r1   r2   releaselevels	__class__s	   &&&&&&& r   r=   VersionInfo.__new__u   su    
 @, -1 2 27"  "O P P { !HIIws5+W> 	>r   c                    V ^8  d   QhRRRR/# r   otherobjectr   r   r   )r   s   "r   r   r4           ) )F )t )r   c                	j    \        V\        4      '       d
   \        V!  p\        P                  W4      # r   )
isinstancetupler+   __lt__r   rD   s   &&r   rJ   VersionInfo.__lt__   (    eU##'E||D((r   c                    V ^8  d   QhRRRR/# rC   r   )r   s   "r   r   r4      rF   r   c                	j    \        V\        4      '       d
   \        V!  p\        P                  W4      # r   )rH   rI   r+   __gt__rK   s   &&r   rP   VersionInfo.__gt__   rM   r   c                    V ^8  d   QhRRRR/# rC   r   )r   s   "r   r   r4      rF   r   c                	j    \        V\        4      '       d
   \        V!  p\        P                  W4      # r   )rH   rI   r+   __le__rK   s   &&r   rT   VersionInfo.__le__   rM   r   c                    V ^8  d   QhRRRR/# rC   r   )r   s   "r   r   r4      rF   r   c                	j    \        V\        4      '       d
   \        V!  p\        P                  W4      # r   )rH   rI   r+   __ge__rK   s   &&r   rX   VersionInfo.__ge__   rM   r   r   )    rZ   rZ   r   rZ   T)r!   r"   r#   r$   	__slots__r&   r=   rJ   rP   rT   rX   r'   __classcell__)r@   s   @r   r+   r+   j   sJ    IJJJ  KM> >*)
)
)
) )r   r+   z-major minor micro releaselevel serial releaseT)r,   r-   r.   r0   r1   r2   c                      ] tR t^tRtR# )ApplicationErrorr   Nr!   r"   r#   r$   r'   r   r   r   r^   r^          4r   r^   c                      ] tR t^tRtR# )	DataErrorr   Nr_   r   r   r   rb   rb      r`   r   rb   c                  z    ] tR t^t$ RtRtR]R&    RtR]R&    RtR]R&    Rt	R]R	&    Rt
R
]R&    RtR]R&   RtR# )SettingsSpeczt
Runtime setting specification base class.

SettingsSpec subclass objects used by `docutils.frontend.OptionParser`.
zClassVar[_SettingsSpecTuple]settings_specNzClassVar[dict[str, Any] | None]settings_defaultssettings_default_overridesClassVar[tuple[str, ...]]relative_path_settingszClassVar[str | None]config_sectionz ClassVar[tuple[str, ...] | None]config_section_dependenciesr   )r!   r"   r#   r$   r%   re   r&   rf   rg   ri   rj   rk   r'   r   r   r   rd   rd      s}    " 35M/4$L :>6= CG ?FN 9;5: ,0N(/: EI!AHr   rd   c                  D    ] tR tRt$ RtR R ltR	tR]R&   R	tR]R&   R	t	R
# )TransformSpeci  z
Runtime transform specification base class.

Provides the interface to register "transforms" and helper functions
to resolve references with a `docutils.transforms.Transformer`.

https://docutils.sourceforge.io/docs/ref/transforms.html
c                   V ^8  d   QhRR/# )r   r   zlist[type[Transform]]r   )r   s   "r   r   TransformSpec.__annotate__  s     	 	 5 	r   c                    V P                   R8w  d0   ^ RIpVP                  R\        4       \	        V P                   4      # . # )z;Transforms required by this class.  Override in subclasses.NzwTransformSpec: the "default_transforms" attribute will be removed in Docutils 2.0.
Use get_transforms() method instead.r   )default_transformswarningswarnDeprecationWarninglist)r   rr   s   & r   get_transformsTransformSpec.get_transforms  sB    ""b(MM A -. //00	r   zClassVar[tuple[()]]rq   z#Sequence[_UnknownReferenceResolver]unknown_reference_resolversr   N)
r!   r"   r#   r$   r%   rv   rq   r&   rx   r'   r   r   r   rm   rm     s+    	 /1+0GI!DIr   rm   c                  H    ] tR tRt$ RtRtR]R&    R
tR]R&    R R	 ltR
t	R# )	ComponentiC  z#Base class for Docutils components.NzClassVar[_Components | None]component_typerh   	supportedc                    V ^8  d   QhRRRR/# )r   r   strr   r   r   )r   s   "r   r   Component.__annotate__N  s     ( (s (t (r   c                    WP                   9   # )z
Is `format` supported by this component?

To be used by transforms to ask the dependent component if it supports
a certain input context or output format.
)r|   )r   r   s   &&r   supportsComponent.supportsN  s     ''r   r   )
r!   r"   r#   r$   r%   r{   r&   r|   r   r'   r   r   r   rz   rz   C  s/    -37N07 ,.I(-G( (r   rz   )readerparserwriterinputoutputr8   )&r%   
__future__r   collectionsr   TYPE_CHECKINGcollections.abcr   typingr   r   r   r   r	   docutils.nodesr
   docutils.transformsr   _ComponentsrI   r~   ru   dict_OptionTupler/   _SettingsSpecTupler   __docformat____version____version_details__r+   __version_info__	Exceptionr^   rb   rd   rm   rz   r   r   r   <module>r      s  
.` # "=(>>&-IJKd3ic3h78LBCNc$hD(<"889c$hD(<"8$hD(<"89 	:c$hD(<"8$hD(<"8$hD(<"89 	:	;
H  #  2)*]LN 2)j 


  (y ' '  'Q Qh |(m (r   