Function execute_sphinx_build

scripts/build-docs.py:115–136

(
    out_base_dir: Path, builder: str, out_dir: Optional[str] = None, **html_defines: str
)

def execute_sphinx_build(
    out_base_dir: Path, builder: str, out_dir: Optional[str] = None, **html_defines: str
) -> Path:
    gen_dir = (out_base_dir / (out_dir or builder)).absolute()
    shutil.rmtree(gen_dir, ignore_errors=True)
    subprocess.run(
        args=[
            sys.executable,
            "-m",
            "sphinx",
            "-b",
            builder,
            "-aEW",
            *itertools.chain.from_iterable(
                ("--html-define", f"{name}={value}") for name, value in html_defines.items()
            ),
            "docs",
            str(gen_dir),
        ],
        check=True,
    )
    return gen_dir


def main(