
    k7i0                    &   S r SSKJr  SSKJr  Sr\(       a  SSKJr  SSKJ	r	J
r
JrJrJr  SSKJr  SSKJr  \S	   r\\\\   \\\	4   4   r\S
   r\\\S-  \S-  \\   4   \\S-  \S-  \\   \S-  \S-  \\   4   \\S-  \S-  \\   \S-  \S-  \\   \S-  \S-  \\   4	   4   r " S S\5      rSrSr Sr  " S S\" SS5      5      r\" SSSSSSS9r  " S S\ 5      r! " S S\!5      r" " S S5      r# " S S 5      r$ " S! S"\#\$5      r%g)#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)readerparserwriterinputoutputalphabeta	candidatefinalNc                  .    \ rS rSr% SrS\S'   SS jrSrg)	_UnknownReferenceResolverM   u-   Deprecated. Will be removed in Docutils 1.0.intpriorityc                   g N )selfnodes     K/home/james-whalen/.local/lib/python3.13/site-packages/docutils/__init__.py__call__"_UnknownReferenceResolver.__call__S   s        r   N)r    r   returnbool)__name__
__module____qualname____firstlineno____doc____annotations__r"   __static_attributes__r   r$   r!   r   r   M   s    ; 	r$   r   reStructuredTextz0.22.3 c                     ^  \ rS rSr% SrS\S'   S\S'   S\S'   S\S'   S\S	'   S
\S'      S             SU 4S jjjrSS jrSS jrSS jr	SS jr
SrU =r$ )VersionInfoj   r   r   majorminormicro_ReleaseLevelsreleaselevelserialr&   releasec           	        > SnXG;  a  [        SU< S35      eUS:X  a#  U(       d  [        S5      eUS:w  a  [        S5      e[        TU ]	  XX#XEU5      $ )Nr   zreleaselevel must be one of .r   z{releaselevel "final" must not be used with development versions (leads to wrong version ordering of the related __version__r   z%"serial" must be 0 for final releases)
ValueErrorsuper__new__)	clsr3   r4   r5   r7   r8   r9   releaselevels	__class__s	           r!   r>   VersionInfo.__new__u   su    
 @, -1 2 27"  "O P P { !HIIws5+W> 	>r$   c                f    [        U[        5      (       a  [        U6 n[        R                  X5      $ r   )
isinstancetupler1   __lt__r   others     r!   rF   VersionInfo.__lt__   (    eU##'E||D((r$   c                f    [        U[        5      (       a  [        U6 n[        R                  X5      $ r   )rD   rE   r1   __gt__rG   s     r!   rL   VersionInfo.__gt__   rJ   r$   c                f    [        U[        5      (       a  [        U6 n[        R                  X5      $ r   )rD   rE   r1   __le__rG   s     r!   rO   VersionInfo.__le__   rJ   r$   c                f    [        U[        5      (       a  [        U6 n[        R                  X5      $ r   )rD   rE   r1   __ge__rG   s     r!   rR   VersionInfo.__ge__   rJ   r$   )r   r   r   r   r   T)r3   r   r4   r   r5   r   r7   r6   r8   r   r9   r&   r%   r1   )rH   objectr%   r&   )r'   r(   r)   r*   	__slots__r,   r>   rF   rL   rO   rR   r-   __classcell__)rA   s   @r!   r1   r1   j   s    IJJJ  KM >?/615>>'*>7:>,> > +/> !	> >*)
)
)
) )r$   r1   z-major minor micro releaselevel serial release      r   T)r3   r4   r5   r7   r8   r9   c                      \ rS rSrSrg)ApplicationError   r   Nr'   r(   r)   r*   r-   r   r$   r!   rZ   rZ          4r$   rZ   c                      \ rS rSrSrg)	DataError   r   Nr\   r   r$   r!   r_   r_      r]   r$   r_   c                  x    \ rS rSr% SrSrS\S'    SrS\S'    SrS\S	'    Sr	S
\S'    Sr
S\S'    SrS\S'   Srg)SettingsSpec   zt
Runtime setting specification base class.

SettingsSpec subclass objects used by `docutils.frontend.OptionParser`.
r   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_dependencies)r'   r(   r)   r*   r+   rd   r,   re   rf   rh   ri   rj   r-   r   r$   r!   rb   rb      s}    " 35M/4$L :>6= CG ?FN 9;5: ,0N(/: EI!AHr$   rb   c                  @    \ rS rSr% SrS
S jrSrS\S'   SrS\S'   Sr	g	)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                    U R                   S:w  a/  SSKnUR                  S[        5        [	        U R                   5      $ / $ )z;Transforms required by this class.  Override in subclasses.r   r   NzwTransformSpec: the "default_transforms" attribute will be removed in Docutils 2.0.
Use get_transforms() method instead.)default_transformswarningswarnDeprecationWarninglist)r   ro   s     r!   get_transformsTransformSpec.get_transforms  sB    ""b(MM A -. //00	r$   r   zClassVar[tuple[()]]rn   z#Sequence[_UnknownReferenceResolver]unknown_reference_resolversN)r%   zlist[type[Transform]])
r'   r(   r)   r*   r+   rs   rn   r,   ru   r-   r   r$   r!   rl   rl     s+    	 /1+0GI!DIr$   rl   c                  D    \ rS rSr% SrSrS\S'    SrS\S'    S
S	 jrSr	g)	ComponentiC  z#Base class for Docutils components.NzClassVar[_Components | None]component_typer   rg   	supportedc                    XR                   ;   $ )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.
)ry   )r   formats     r!   supportsComponent.supportsN  s     ''r$   )r{   strr%   r&   )
r'   r(   r)   r*   r+   rx   r,   ry   r|   r-   r   r$   r!   rw   rw   C  s*    -37N07 ,.I(-G(r$   rw   )&r+   
__future__r   collectionsr   TYPE_CHECKINGcollections.abcr   typingr   r   r   r	   r
   docutils.nodesr   docutils.transformsr   _ComponentsrE   r~   rr   dict_OptionTupler6   _SettingsSpecTupler   __docformat____version____version_details__r1   __version_info__	ExceptionrZ   r_   rb   rl   rw   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$   