Release history and notes
Sequence based identifiers are used for versioning (schema follows below):
major.minor[.revision]
It’s always safe to upgrade within the same minor version (for example, from 0.3 to 0.3.4).
Minor version changes might be backwards incompatible. Read the release notes carefully before upgrading (for example, when upgrading from 0.3.4 to 0.4).
All backwards incompatible changes are mentioned in this document.
0.2.2
2026-03-01
Added named profiles (
[tool.sphinx-source-tree.file-options-profiles]) allowing different inclusion rules per output file. Each[[tool.sphinx-source-tree.files]]entry can select a profile viafile-options-profile; unrecognised profile names fall back to the top-levelfile-optionstable with a stderr warning.
0.2.1
2026-02-28
Added per-file inclusion options: You can now limit which parts of a file are shown in the documentation using
lines,start-after,start-at,end-before, andend-at. These can be configured in your pyproject.toml or via the Python API.Test against Python 3.15.
0.2
2026-02-17
Support multiple configurations.
0.1
2026-02-12
Initial beta release.