✨ sphinx-needs: `choose` / `when` / `otherwise` directives, one of several branches by variant data - #2020

Open

chrisjsewell wants to merge 28 commits into

masterfrom

claude/elegant-darwin-2lj6bb

Commits on Oct 1, 2026

♻️ sphinx-needs: one evaluator for variant conditions, out of `if`
claude
committed
797b44b
✨ sphinx-needs: `match` and `case` directives (#2011)
claude
committed
e70eebf
🧪 sphinx-needs: tests for `match` and `case`
claude
committed
b929a5a
📚 sphinx-needs: document `match` and `case`, and the changelog entry
claude
committed
57efbfe
👌 sphinx-needs: a `case` supplied through an include is refused
claude
committed
1255bce
👌 sphinx-needs: every mistake in a `match` body warns, including the quiet ones
claude
committed
4a2b185
🧪 sphinx-needs: pin the rollback, the depth restore and the check order of `match`
claude
committed
66fe682
👌 sphinx-needs: below WARNING, a docutils message never hides a `match` mistake
claude
committed
43d2522
Merge origin/master into claude/elegant-darwin-2lj6bb
claude
committed
6d3e0ff
📚 sphinx-needs: the changelog entry names its pull request
claude
committed
69fa72e
♻️ sphinx-needs: rename `match` / `case` to `choose` / `when`
claude
committed
2edfb83
✨ sphinx-needs: an explicit `otherwise`, and a `when` must have a condition
claude
committed
745929f
📚 sphinx-needs: document `choose`, `when` and `otherwise`
claude
committed
1a4bc83
🧪 sphinx-needs: pin the choose check order, name the otherwise text, docs nits
claude
committed
72157c9
🔧 sphinx-needs: correct the comment on the `choose` argument's declaration
claude
committed
cc885e1
🔧 sphinx-needs: say why each branch directive declares its argument
claude
committed
a62191f
🧪 sphinx-needs: pin the document order of the branch faults
claude
committed
a1220af
🧪 sphinx-needs-testkit: rewrite a POSIX-spelt location on Windows
claude
committed
48d293d
🧪 CI: upload coverage on pushes to master too
claude
committed
dadd8c4

Navigation Menu

✨ sphinx-needs: `choose` / `when` / `otherwise` directives, one of several branches by variant data - #2020

✨ sphinx-needs: `choose` / `when` / `otherwise` directives, one of several branches by variant data#2020
chrisjsewell wants to merge 28 commits into
masterfrom
claude/elegant-darwin-2lj6bb

Commits on Oct 1, 2026

♻️ sphinx-needs: one evaluator for variant conditions, out of `if`

✨ sphinx-needs: `match` and `case` directives (#2011)

🧪 sphinx-needs: tests for `match` and `case`

📚 sphinx-needs: document `match` and `case`, and the changelog entry

👌 sphinx-needs: a `case` supplied through an include is refused

👌 sphinx-needs: every mistake in a `match` body warns, including the quiet ones

🧪 sphinx-needs: pin the rollback, the depth restore and the check order of `match`

👌 sphinx-needs: below WARNING, a docutils message never hides a `match` mistake

Merge origin/master into claude/elegant-darwin-2lj6bb

📚 sphinx-needs: the changelog entry names its pull request

♻️ sphinx-needs: rename `match` / `case` to `choose` / `when`

✨ sphinx-needs: an explicit `otherwise`, and a `when` must have a condition

📚 sphinx-needs: document `choose`, `when` and `otherwise`

🧪 sphinx-needs: pin the choose check order, name the otherwise text, docs nits

🔧 sphinx-needs: correct the comment on the `choose` argument's declaration

🔧 sphinx-needs: say why each branch directive declares its argument

🧪 sphinx-needs: pin the document order of the branch faults

🧪 sphinx-needs-testkit: rewrite a POSIX-spelt location on Windows

🧪 CI: upload coverage on pushes to master too

Commits on Oct 3, 2026

♻️ CI: move the Codecov upload fix to a pull request of its own

Merge remote-tracking branch 'origin/master' into claude/elegant-darwin-2lj6bb

🐛 sphinx-needs: refuse a branch written with one colon in a choose

🧪 sphinx-needs: pin the case and spacing of the one-colon rule

👌 sphinx-needs: the one-colon hint names the MyST fence under MyST

🐛 sphinx-needs: locate choose warnings with an absolute path

Revert "🧪 sphinx-needs-testkit: rewrite a POSIX-spelt location on Windows"

🧪 sphinx-needs: build the choose warning rows from the source directory

♻️ sphinx-needs: gate the choose body before parsing it