def get_parser(): # type: () -> argparse.ArgumentParser warnings.warn( 'sphinx.cmdline module is deprecated. Use sphinx.cmd.build instead.', RemovedInSphinx30Warning, stacklevel=2) return build.get_parser()
def get_builddir() -> PathLike: """Obtain Sphinx base build directory for a given docset. Returns: Base build path. """ parser = get_parser() args = parser.parse_args() return (Path(args.outputdir) / ".." / "..").resolve()
# Zephyr documentation build configuration file. # Reference: https://www.sphinx-doc.org/en/master/usage/configuration.html import sys import os from pathlib import Path import re from sphinx.cmd.build import get_parser import sphinx_rtd_theme args = get_parser().parse_args() ZEPHYR_BASE = Path(__file__).resolve().parents[1] ZEPHYR_BUILD = Path(args.outputdir).resolve() # Add the '_extensions' directory to sys.path, to enable finding Sphinx # extensions within. sys.path.insert(0, str(ZEPHYR_BASE / "doc" / "_extensions")) # Add the '_scripts' directory to sys.path, to enable finding utility # modules. sys.path.insert(0, str(ZEPHYR_BASE / "doc" / "_scripts")) # Add the directory which contains the runners package as well, # for autodoc directives on runners.xyz. sys.path.insert(0, str(ZEPHYR_BASE / "scripts" / "west_commands")) import redirects try:
def get_parser(): # type: () -> argparse.ArgumentParser warnings.warn('sphinx.cmdline module is deprecated. Use sphinx.cmd.build instead.', RemovedInSphinx30Warning, stacklevel=2) return build.get_parser()