collective / sphinxcontrib-httpexample / 38810804615

100%

master: 98%

Pull #153

github

feat: Add :builder-args: option for custom builders

Allow passing arguments to custom builders with a :builder-args: option
on http:example and http:example-block. The value is parsed as YAML,
where root keys are builder IDs, matched case-insensitively like the
directive arguments, and each value is a mapping passed to that builder
as keyword arguments. Builders without arguments for them are still
called with only the request, so existing builders keep working.

Invalid YAML, unknown, blank or duplicate builder IDs (including exact
duplicate YAML keys), duplicate argument names, non-string builder keys,
and arguments the builder does not accept are reported as directive
errors, as are malformed requests and builder failures, which previously
crashed the build.

Builder IDs are normalized to lowercase in register_builder, unknown
builder choices are reported as directive errors instead of raising
KeyError, and the "http" and "response" block arguments are matched
case-insensitively.

Add pyyaml as a dependency and myst-parser as a development dependency
for testing the MyST syntax. Build pyyaml with setuptools in devenv,
because it has no Python 3.15 wheel yet.

Assisted-by: Claude Code (claude-opus-5-5)

94 of 94 new or added lines in 1 file covered. (100.0%)

564 of 564 relevant lines covered (100.0%)

1.0 hits per line