Function _get_settings

sphinx/util/docutils.py:911–930

(
    *components: Component | type[Component],
    defaults: Mapping[str, Any],
    read_config_files: bool = False,
)

def _get_settings(
    *components: Component | type[Component],
    defaults: Mapping[str, Any],
    read_config_files: bool = False,
) -> _DocutilsSettings:
    with warnings.catch_warnings(action='ignore', category=DeprecationWarning):
        # DeprecationWarning: The frontend.OptionParser class will be replaced
        # by a subclass of argparse.ArgumentParser in Docutils 0.21 or later.
        # DeprecationWarning: The frontend.Option class will be removed
        # in Docutils 0.21 or later.
        option_parser = docutils.frontend.OptionParser(  # pyright: ignore[reportDeprecated]  # ty: ignore[deprecated]
            components=components,
            defaults=defaults,
            read_config_files=read_config_files,
        )
    with warnings.catch_warnings(action='ignore', category=DeprecationWarning):
        # DeprecationWarning:  frontend.Values class will be removed
        # in Docutils 2.0 or later.
        settings = option_parser.get_default_values()
    return settings


class _DummyWriter(docutils.writers.Writer):  # type: ignore[type-arg]