liran-funaro / sphinx-markdown-builder / 43229454289

100%

main: 100%

Pull #136

github

Build optional groups in place and keep separators inside brackets

Each finished parameter or optional group becomes one string in the body.
The separator before it goes inside the adjacent bracket, so the signature
reads correctly with or without any optional group. This also fixes nested
groups that start a group, which Sphinx's HTML writer renders as [[a], b]
(reading [, b] without a): they now render as [[a, ]b].

middle(a[, b], c) keeps the source notation instead of HTML's a, [b, ]c.
Add fixtures for nested first groups, deep nesting, a nested group after a
required parameter, and unbalanced brackets (kept as text by Sphinx).

36 of 36 new or added lines in 2 files covered. (100.0%)

814 of 814 relevant lines covered (100.0%)

4.0 hits per line