MAJOR=4 MINOR=44 DEVNAME=tty44 $ ˆl–Ðz¾”Ëm q@=q¦nõ1hßÀ „û?¿ÄÃ(5 # $Id: __init__.py 9376 2023-05-09 18:31:42Z grubert $ # Author: David Goodger # Copyright: This module has been placed in the public domain. """ 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. """ from collections import namedtuple __docformat__ = 'reStructuredText' __version__ = '0.20.1' """Docutils version identifier (complies with PEP 440):: major.minor[.micro][releaselevel[serial]][.dev] For version comparison operations, use `__version_info__` (see, below) rather than parsing the text of `__version__`. https://docutils.sourceforge.io/docs/dev/policies.html#version-identification """ __version_details__ = '' """Optional extra version details (e.g. 'snapshot 2005-05-29, r3410'). For development and release status, use `__version__ and `__version_info__`. """ class VersionInfo(namedtuple('VersionInfo', 'major minor micro releaselevel serial release')): def __new__(cls, major=0, minor=0, micro=0, releaselevel='final', serial=0, release=True): releaselevels = ('alpha', 'beta', 'candidate', 'final') if releaselevel not in releaselevels: raise ValueError('releaselevel must be one of %r.' % (releaselevels, )) if releaselevel == 'final': if not release: raise ValueError('releaselevel "final" must not be used ' 'with development versions (leads to wrong ' 'version ordering of the related __version__') # cf. https://peps.python.org/pep-0440/#summary-of-permitted-suffixes-and-relative-ordering # noqa if serial != 0: raise ValueError('"serial" must be 0 for final releases') return super().__new__(cls, major, minor, micro, releaselevel, serial, release) def __lt__(self, other): if isinstance(other, tuple): other = VersionInfo(*other) return tuple.__lt__(self, other) def __gt__(self, other): if isinstance(other, tuple): other = VersionInfo(*other) return tuple.__gt__(self, other) def __le__(self, other): if isinstance(other, tuple): other = VersionInfo(*other) return tuple.__le__(self, other) def __ge__(self, other): if isinstance(other, tuple): other = VersionInfo(*other) return tuple.__ge__(self, other) __version_info__ = VersionInfo( major=0, minor=20, micro=1, releaselevel='final', # one of 'alpha', 'beta', 'candidate', 'final' serial=0, # pre-release nu