From 5dbc9920feb13b6246dc0cab7dd3681a9518c6c3 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Tue, 7 Jul 2026 11:47:09 +0000 Subject: [PATCH 1/2] Enable sphinx-pyrepl-web :project: for autodoc REPL wheels Wire pyrepl_autodoc_packages = ':project:' so autodoc doctest REPLs install the in-tree naming wheel at doc-build time instead of relying on PyPI. Enable html_static_path for bootstrap scripts and built wheels. Pin sphinx-pyrepl-web to the unreleased auto-project-wheel branch (0.4.0) until the :project: sentinel is on PyPI. Ignore generated wheel and local HTML build output. Co-authored-by: chrizzftd --- .gitignore | 2 ++ docs/source/conf.py | 3 ++- setup.cfg | 2 +- 3 files changed, 5 insertions(+), 2 deletions(-) diff --git a/.gitignore b/.gitignore index 19d8a6c..1200137 100644 --- a/.gitignore +++ b/.gitignore @@ -3,4 +3,6 @@ dist/ build/ naming.egg-info/ docs/build/ +docs/_build/ +docs/source/_static/wheels/*.whl *.pyc diff --git a/docs/source/conf.py b/docs/source/conf.py index 091e82c..85be3d4 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -50,6 +50,7 @@ toggleprompt_offset_right = 35 togglebutton_hint = " " pyrepl_doctest_blocks = "autodoc" +pyrepl_autodoc_packages = ":project:" intersphinx_mapping = { 'python': ('https://docs.python.org/3', None), } @@ -146,7 +147,7 @@ # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". -# html_static_path = ['_static'] +html_static_path = ['_static'] # -- Options for HTMLHelp output ------------------------------------------ diff --git a/setup.cfg b/setup.cfg index d9d723e..c5e50ed 100644 --- a/setup.cfg +++ b/setup.cfg @@ -22,4 +22,4 @@ packages = find: [options.extras_require] # python -m pip install -e ".[docs]" -docs = sphinx; myst-parser; sphinx-toggleprompt; sphinx-copybutton; sphinx-togglebutton; sphinx_autodoc_typehints; sphinx_rtd_theme; sphinx-pyrepl-web>=0.2.0 +docs = sphinx; myst-parser; sphinx-toggleprompt; sphinx-copybutton; sphinx-togglebutton; sphinx_autodoc_typehints; sphinx_rtd_theme; sphinx-pyrepl-web @ git+https://github.com/chrizzFTD/sphinx-pyrepl-web@cursor/auto-project-wheel-1aac From 5f9cbba7a6e4c7fcbfeadbeb9a93cb2d54dcf080 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Tue, 7 Jul 2026 13:05:33 +0000 Subject: [PATCH 2/2] Pin sphinx-pyrepl-web>=0.4.0 from PyPI Replace unreleased git branch pin now that :project: sentinel shipped in sphinx-pyrepl-web 0.4.0 (PR #25). Co-authored-by: chrizzftd --- setup.cfg | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/setup.cfg b/setup.cfg index c5e50ed..d909d42 100644 --- a/setup.cfg +++ b/setup.cfg @@ -22,4 +22,4 @@ packages = find: [options.extras_require] # python -m pip install -e ".[docs]" -docs = sphinx; myst-parser; sphinx-toggleprompt; sphinx-copybutton; sphinx-togglebutton; sphinx_autodoc_typehints; sphinx_rtd_theme; sphinx-pyrepl-web @ git+https://github.com/chrizzFTD/sphinx-pyrepl-web@cursor/auto-project-wheel-1aac +docs = sphinx; myst-parser; sphinx-toggleprompt; sphinx-copybutton; sphinx-togglebutton; sphinx_autodoc_typehints; sphinx_rtd_theme; sphinx-pyrepl-web>=0.4.0