android-notify 1.60.0__py3-none-any.whl → 1.60.1__py3-none-any.whl

venv/Lib/site-packages/docutils/__init__.py

@@ -1,341 +0,0 @@
-# $Id: __init__.py 10245 2025-09-20 17:45:20Z grubert $
-# Author: David Goodger <goodger@python.org>
-# 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 __future__ import annotations
-
-from collections import namedtuple
-
-TYPE_CHECKING = False
-if TYPE_CHECKING:
-    from collections.abc import Sequence
-    from typing import Any, ClassVar, Literal, Protocol, Union
-
-    from docutils.nodes import Element
-    from docutils.transforms import Transform
-
-    _Components = Literal['reader', 'parser', 'writer', 'input', 'output']
-    _OptionTuple = tuple[str, list[str], dict[str, Any]]
-    _ReleaseLevels = Literal['alpha', 'beta', 'candidate', 'final']
-    _SettingsSpecTuple = Union[
-        tuple[str|None, str|None, Sequence[_OptionTuple]],
-        tuple[str|None, str|None, Sequence[_OptionTuple],
-              str|None, str|None, Sequence[_OptionTuple]],
-        tuple[str|None, str|None, Sequence[_OptionTuple],
-              str|None, str|None, Sequence[_OptionTuple],
-              str|None, str|None, Sequence[_OptionTuple]],
-        ]
-
-    class _UnknownReferenceResolver(Protocol):
-        """Deprecated. Will be removed in Docutils 1.0."""
-        # See `TransformSpec.unknown_reference_resolvers`.
-
-        priority: int
-
-        def __call__(self, node: Element, /) -> bool:
-            ...
-
-__docformat__ = 'reStructuredText'
-
-__version__ = '0.22.2'
-"""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')):
-    __slots__ = ()
-
-    major: int
-    minor: int
-    micro: int
-    releaselevel: _ReleaseLevels
-    serial: int
-    release: bool
-
-    def __new__(cls,
-                major: int = 0, minor: int = 0, micro: int = 0,
-                releaselevel: _ReleaseLevels = 'final',
-                serial: int = 0, release: bool = True,
-                ) -> VersionInfo:
-        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: E501
-            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: object) -> bool:
-        if isinstance(other, tuple):
-            other = VersionInfo(*other)
-        return tuple.__lt__(self, other)
-
-    def __gt__(self, other: object) -> bool:
-        if isinstance(other, tuple):
-            other = VersionInfo(*other)
-        return tuple.__gt__(self, other)
-
-    def __le__(self, other: object) -> bool:
-        if isinstance(other, tuple):
-            other = VersionInfo(*other)
-        return tuple.__le__(self, other)
-
-    def __ge__(self, other: object) -> bool:
-        if isinstance(other, tuple):
-            other = VersionInfo(*other)
-        return tuple.__ge__(self, other)
-
-
-__version_info__ = VersionInfo(
-    major=0,
-    minor=22,
-    micro=2,
-    releaselevel='final',  # one of 'alpha', 'beta', 'candidate', 'final'
-    serial=0,  # pre-release number (0 for final releases and snapshots)
-    release=True  # True for official releases and pre-releases
-    )
-"""Comprehensive version information tuple.
-
-https://docutils.sourceforge.io/docs/dev/policies.html#version-identification
-"""
-
-
-class ApplicationError(Exception): pass
-class DataError(ApplicationError): pass
-
-
-class SettingsSpec:
-
-    """
-    Runtime setting specification base class.
-
-    SettingsSpec subclass objects used by `docutils.frontend.OptionParser`.
-    """
-
-    # TODO: replace settings_specs with a new data structure
-    # Backwards compatiblity:
-    #   Drop-in components:
-    #   Sphinx supplies settings_spec in the current format in some places
-    #   Myst parser provides a settings_spec tuple
-    #
-    #   Sphinx reads a settings_spec in order to set a default value
-    #   in writers/html.py:59
-    #   https://github.com/sphinx-doc/sphinx/blob/4.x/sphinx/writers/html.py
-    #   This should be changed (before retiring the old format)
-    #   to use `settings_default_overrides` instead.
-    settings_spec: ClassVar[_SettingsSpecTuple] = ()
-    """Runtime settings specification.  Override in subclasses.
-
-    Defines runtime settings and associated command-line options, as used by
-    `docutils.frontend.OptionParser`.  This is a tuple of:
-
-    - Option group title (string or `None` which implies no group, just a list
-      of single options).
-
-    - Description (string or `None`).
-
-    - A sequence of option tuples.  Each consists of:
-
-      - Help text (string)
-
-      - List of option strings (e.g. ``['-Q', '--quux']``).
-
-      - Dictionary of keyword arguments sent to the OptionParser/OptionGroup
-        ``add_option`` method.
-
-        Runtime setting names are derived implicitly from long option names
-        ('--a-setting' becomes ``settings.a_setting``) or explicitly from the
-        'dest' keyword argument.
-
-        Most settings will also have a 'validator' keyword & function.  The
-        validator function validates setting values (from configuration files
-        and command-line option arguments) and converts them to appropriate
-        types.  For example, the ``docutils.frontend.validate_boolean``
-        function, **required by all boolean settings**, converts true values
-        ('1', 'on', 'yes', and 'true') to 1 and false values ('0', 'off',
-        'no', 'false', and '') to 0.  Validators need only be set once per
-        setting.  See the `docutils.frontend.validate_*` functions.
-
-        See the optparse docs for more details.
-
-    - More triples of group title, description, options, as many times as
-      needed.  Thus, `settings_spec` tuples can be simply concatenated.
-    """
-
-    settings_defaults: ClassVar[dict[str, Any] | None] = None
-    """A dictionary of defaults for settings not in `settings_spec` (internal
-    settings, intended to be inaccessible by command-line and config file).
-    Override in subclasses."""
-
-    settings_default_overrides: ClassVar[dict[str, Any] | None] = None
-    """A dictionary of auxiliary defaults, to override defaults for settings
-    defined in other components' `setting_specs`.  Override in subclasses."""
-
-    relative_path_settings: ClassVar[tuple[str, ...]] = ()
-    """Settings containing filesystem paths.  Override in subclasses.
-    Settings listed here are to be interpreted relative to the current working
-    directory."""
-
-    config_section: ClassVar[str | None] = None
-    """The name of the config file section specific to this component
-    (lowercase, no brackets).  Override in subclasses."""
-
-    config_section_dependencies: ClassVar[tuple[str, ...] | None] = None
-    """A list of names of config file sections that are to be applied before
-    `config_section`, in order (from general to specific).  In other words,
-    the settings in `config_section` are to be overlaid on top of the settings
-    from these sections.  The "general" section is assumed implicitly.
-    Override in subclasses."""
-
-
-class TransformSpec:
-    """
-    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
-    """
-
-    def get_transforms(self) -> list[type[Transform]]:
-        """Transforms required by this class.  Override in subclasses."""
-        if self.default_transforms != ():
-            import warnings
-            warnings.warn('TransformSpec: the "default_transforms" attribute '
-                          'will be removed in Docutils 2.0.\n'
-                          'Use get_transforms() method instead.',
-                          DeprecationWarning)
-            return list(self.default_transforms)
-        return []
-
-    # Deprecated; for compatibility.
-    default_transforms: ClassVar[tuple[()]] = ()
-
-    unknown_reference_resolvers: Sequence[_UnknownReferenceResolver] = ()
-    """List of hook functions which assist in resolving references.
-
-    Deprecated. Will be removed in Docutils 1.0
-    """
-    # Override in subclasses to implement component-specific resolving of
-    # unknown references.
-    #
-    # Unknown references have a 'refname' attribute which doesn't correspond
-    # to any target in the document.  Called when the transforms in
-    # `docutils.transforms.references` are unable to find a correct target.
-    #
-    # The list should contain functions which will try to resolve unknown
-    # references, with the following signature::
-    #
-    #     def reference_resolver(node: nodes.Element) -> bool:
-    #         '''Returns boolean: true if resolved, false if not.'''
-    #
-    # If the function is able to resolve the reference, it should also remove
-    # the 'refname' attribute and mark the node as resolved::
-    #
-    #     del node['refname']
-    #     node.resolved = True
-    #
-    # Each function must have a "priority" attribute which will affect the
-    # order the unknown_reference_resolvers are run
-    # cf. ../docs/api/transforms.html#transform-priority-range-categories ::
-    #
-    #     reference_resolver.priority = 500
-    #
-    # Examples:
-    #   The `MoinMoin ReStructured Text Parser`__ provided a resolver for
-    #   "WikiWiki links" in the 1.9 version.
-    #
-    #   __ https://github.com/moinwiki/moin-1.9/blob/1.9.11/MoinMoin/parser/
-    #      text_rst.py
-
-
-class Component(SettingsSpec, TransformSpec):
-
-    """Base class for Docutils components."""
-
-    component_type: ClassVar[_Components | None] = None
-    """Name of the component type ('reader', 'parser', 'writer').
-    Override in subclasses."""
-
-    supported: ClassVar[tuple[str, ...]] = ()
-    """Name and aliases for this component.  Override in subclasses."""
-
-    def supports(self, format: str) -> bool:
-        """
-        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.
-        """
-        return format in self.supported

venv/Lib/site-packages/docutils/__main__.py

@@ -1,103 +0,0 @@
-#!/usr/bin/env python3
-# :Copyright: © 2020, 2022 Günter Milde.
-# :License: Released under the terms of the `2-Clause BSD license`_, in short:
-#
-#    Copying and distribution of this file, with or without modification,
-#    are permitted in any medium without royalty provided the copyright
-#    notice and this notice are preserved.
-#    This file is offered as-is, without any warranty.
-#
-# .. _2-Clause BSD license: https://opensource.org/licenses/BSD-2-Clause
-#
-# Revision: $Revision: 10136 $
-# Date: $Date: 2025-05-20 17:48:27 +0200 (Di, 20. Mai 2025) $
-
-"""Generic command line interface for the `docutils` package.
-
-See also
-https://docs.python.org/3/library/__main__.html#main-py-in-python-packages
-"""
-
-from __future__ import annotations
-
-__docformat__ = 'reStructuredText'
-
-import argparse
-import locale
-import sys
-
-import docutils
-from docutils.core import Publisher, publish_cmdline, default_description
-
-
-class CliSettingsSpec(docutils.SettingsSpec):
-    """Runtime settings & command-line options for the generic CLI.
-
-    Configurable reader, parser, and writer components.
-
-    The "--writer" default will change to 'html' in Docutils 2.0
-    when 'html' becomes an alias for the current value 'html5'.
-    """
-
-    settings_spec = (
-        'Docutils Application Options',
-        'Reader, writer, and parser settings influence the available options. '
-        '  Example: use `--help --writer=latex` to see LaTeX writer options. ',
-        # options: ('help text', [<option strings>], {<keyword arguments>})
-        (('Reader name (currently: "%default").',
-          ['--reader'], {'default': 'standalone', 'metavar': '<reader>'}),
-         ('Parser name (currently: "%default").',
-          ['--parser'], {'default': 'rst', 'metavar': '<parser>'}),
-         ('Writer name (currently: "%default").',
-          ['--writer'], {'default': 'html5', 'metavar': '<writer>'}),
-         )
-    )
-    config_section = 'docutils application'
-    config_section_dependencies = ('docutils-cli application',  # back-compat
-                                   'applications')
-
-
-def main() -> None:
-    """Generic command line interface for the Docutils Publisher.
-    """
-    try:
-        locale.setlocale(locale.LC_ALL, '')
-    except locale.Error as e:
-        sys.stderr.write(f'WARNING: Cannot set the default locale: {e}.\n')
-
-    description = ('Convert documents into useful formats.  '
-                   + default_description)
-
-    # Update component selection from config file(s)
-    components = Publisher().get_settings(settings_spec=CliSettingsSpec)
-
-    # Update component selection from command-line
-    argparser = argparse.ArgumentParser(add_help=False, allow_abbrev=False)
-    argparser.add_argument('--reader', default=components.reader)
-    argparser.add_argument('--parser', default=components.parser)
-    argparser.add_argument('--writer', default=components.writer)
-    # other options are parsed in a second pass via `publish_cmdline()`
-    (args, remainder) = argparser.parse_known_args()
-    # Ensure the current component selections are shown in help:
-    CliSettingsSpec.settings_default_overrides = args.__dict__
-
-    try:
-        publish_cmdline(reader=args.reader,
-                        parser=args.parser,
-                        writer=args.writer,
-                        settings_spec=CliSettingsSpec,
-                        description=description,
-                        argv=remainder)
-    except ImportError as error:
-        print('%s.' % error, file=sys.stderr)
-        if '--traceback' in remainder:
-            raise
-        else:
-            print('Use "--traceback" to show details.')
-
-
-if __name__ == '__main__':
-    if sys.argv[0].endswith('__main__.py'):
-        # fix "usage" message
-        sys.argv[0] = '%s -m docutils' % sys.executable
-    main()