Skip to content

Commit 217358b

Browse files
authored
docs: Migrate to gp-sphinx theme and packages (#345)
## Summary Migrates cihai-cli docs from repo-local Sphinx theme/config/assets to the published `gp-sphinx` shared documentation platform. ## What changed - `pyproject.toml` / `uv.lock` switch the docs stack to `gp-sphinx==0.0.1a1` and `sphinx-argparse-neo==0.0.1a1` from PyPI. - `docs/conf.py` is already rewritten around `merge_sphinx_config()` so theme settings, shared extensions, fonts, and JS workarounds come from gp-sphinx instead of local boilerplate. - Adds root doctest support for `monkeypatch` and fixes the `_colors.py` examples so they match the actual `NO_COLOR` precedence contract. - Retains the removal of vendored docs-only files and now-unused mypy overrides from the original gp-sphinx migration stack. ## Test plan - [x] `just test` - [x] `just ruff` - [x] `just mypy` - [x] `just build-docs`
2 parents 146b69f + ad3887d commit 217358b

40 files changed

Lines changed: 130 additions & 12228 deletions

conftest.py

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
"""Root pytest configuration for cihai-cli."""
2+
3+
from __future__ import annotations
4+
5+
import typing as t
6+
7+
import pytest
8+
9+
10+
@pytest.fixture(autouse=True)
11+
def _doctest_monkeypatch(
12+
doctest_namespace: dict[str, object],
13+
) -> t.Iterator[None]:
14+
"""Expose monkeypatch in source doctests and undo env changes after use."""
15+
monkeypatch = pytest.MonkeyPatch()
16+
doctest_namespace["monkeypatch"] = monkeypatch
17+
yield
18+
monkeypatch.undo()

docs/_ext/__init__.py

Lines changed: 0 additions & 3 deletions
This file was deleted.

0 commit comments

Comments
 (0)