From 89e2d662a4646ef2378ded9649a787ff30346854 Mon Sep 17 00:00:00 2001 From: jaelliot Date: Thu, 22 Jan 2026 13:49:57 -0700 Subject: [PATCH 1/2] docs: update copyright, use dynamic version, add explicit Sphinx deps - Update copyright year to 2020-2026 - Switch from hardcoded version (0.3.4) to dynamic import from hio.__version__ - Add explicit Sphinx >= 8.1.3, sphinx-rtd-theme >= 3.0.1, ordered-set >= 4.1.0 to docs requirements - Fixes missing dependency warnings during doc builds - sphinx.ext.viewcode already enabled in upstream (no changes needed) Tested: cd docs && make clean && make html succeeds with 1485 warnings (RST formatting, expected) --- docs/source/conf.py | 5 +++-- docs/source/requirements.txt | 3 +++ 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/source/conf.py b/docs/source/conf.py index a00551ed..d606d032 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -20,11 +20,12 @@ # -- Project information ----------------------------------------------------- project = 'hio' -copyright = '2020-2021, Samuel M. Smith' +copyright = '2020-2026, Samuel M. Smith' author = 'Samuel M. Smith' # The full version, including alpha/beta/rc tags -release = '0.3.4' +import hio +release = hio.__version__ version = release # -- General configuration --------------------------------------------------- diff --git a/docs/source/requirements.txt b/docs/source/requirements.txt index ebb08536..4928a6f2 100644 --- a/docs/source/requirements.txt +++ b/docs/source/requirements.txt @@ -1,2 +1,5 @@ myst_parser >= 0.14.0 sphinx-autoapi >= 1.8.1 +Sphinx >= 8.1.3 +sphinx-rtd-theme >= 3.0.1 +ordered-set >= 4.1.0 From 6494c9b8f627545576b4dbdebafa360f7de3fcb4 Mon Sep 17 00:00:00 2001 From: jaelliot Date: Thu, 22 Jan 2026 14:00:22 -0700 Subject: [PATCH 2/2] style: fix linting errors in conf.py - Remove unused sphinx_rtd_theme import - Move hio import to top of file (after sys.path setup) - Fixes Ruff F401 (unused import) and E402 (module import not at top) --- docs/source/conf.py | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/source/conf.py b/docs/source/conf.py index d606d032..543eadbc 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -14,7 +14,7 @@ import sys sys.path.insert(0, os.path.abspath('./../..')) -import sphinx_rtd_theme +import hio # -- Project information ----------------------------------------------------- @@ -24,7 +24,6 @@ author = 'Samuel M. Smith' # The full version, including alpha/beta/rc tags -import hio release = hio.__version__ version = release