Skip to content

Name the stubbed helpers, and the fourth unswept tree - #38

Merged
tannevaled merged 1 commit into
mainfrom
stubbed-helpers-and-command-line
Nov 9, 2026
Merged

tannevaled merged 1 commit into
mainfrom
stubbed-helpers-and-command-line

Conversation

@tannevaled

Copy link
Copy Markdown
Contributor

Two corrections to lists this page states, and a pin bump so the first one stops being stated by hand.

The stubbed helpers

The skip line said 477 examples are skipped "because our shim stubs the matcher they need" and named none of them. Read out of spec_helper.rb:

helpers
stubbed (raise SpecSkip) ruby_exe (:882), ruby_cmd (:883), output_to_fd (:280)
implemented complain (:249), output (:279), be_computed_by (:199)

Naming none of them was the mild version. The docs site named two that are implemented and missed ruby_cmd entirely — corrected in docs#47, where the same read became a gate.

The direction matters: an example using a genuinely stubbed helper skips, but one using complain runs and, when the behaviour is missing, fails. A reader told the list is "the matchers the shim stubs" and sent to look among the skips does not find it there.

The fourth unswept tree

library/, optional/, command_line/ and security/. command_line/ — 32 spec files — was missing from that sentence here, in index.html, on the docs site and in the ruby README.

The pin

conformancefigure moves to v0.8.0, which reads every def … raise SpecSkip out of spec_helper.rb and judges this page in both directions.

Verified with the exact published command the lane runs, fetched through the proxy:

$ go run github.com/go-embedded-ruby/docs/tools/[email protected] --root .
6 total claim(s), 1 version claim(s) and 3 stubbed-helper mention(s) checked
against the gate's 23672 at Ruby 4.0.9 (derived from RUBY_VERSION);
the shim stubs output_to_fd, ruby_cmd, ruby_exe

And it bites — with the line rewritten to "the shim stubs ruby_exe and complain", the same command exits 1:

layouts/_default/list.html:75: calls `complain` a stubbed shim helper; the shim
stubs output_to_fd, ruby_cmd, ruby_exe and not it, so its examples RUN -- and
when the behaviour is missing they FAIL rather than skip

⛔ What it still cannot do

The completeness half applies only once a helper is named, so deleting the enumeration outright would leave nothing to be incomplete about and this lane would stay green. The docs repository closes that with a test over its own content tree; this page has no equivalent yet. Stated rather than left to be discovered.

🤖 Generated with Claude Code

Two corrections, both of a list this page states and nothing checked.

The skip line said 477 examples are skipped "because our shim stubs the
matcher they need" and named none of them. Read out of spec_helper.rb,
they are `ruby_exe` (:882), `ruby_cmd` (:883) and `output_to_fd` (:280).
The docs site named two helpers that are IMPLEMENTED (`complain`,
`output`) and missed `ruby_cmd` entirely; that is fixed in
go-embedded-ruby/docs#47, and the same read is now a gate.

The unswept trees are `library/`, `optional/`, `command_line/` and
`security/`. `command_line/` -- 32 spec files -- was missing from that
sentence here, in index.html, on the docs site and in the ruby README.

The conformancefigure pin moves to v0.8.0, which reads every
`def … raise SpecSkip` out of spec_helper.rb and judges this page in both
directions: a helper called stubbed that is not, and a stubbed helper the
page names nowhere.

Verified with the exact published command this lane runs, fetched through
the proxy:

    $ go run github.com/go-embedded-ruby/docs/tools/[email protected] --root .
    6 total claim(s), 1 version claim(s) and 3 stubbed-helper mention(s) checked
    against the gate's 23672 at Ruby 4.0.9 (derived from RUBY_VERSION);
    the shim stubs output_to_fd, ruby_cmd, ruby_exe

and it bites: with the line rewritten to "stubs `ruby_exe` and
`complain`", the same command exits 1 naming list.html:75 and `complain`.

⛔ What it still cannot do: the completeness half applies only once a
helper is named, so deleting the enumeration outright would leave nothing
to be incomplete about and the lane would stay green. The docs repository
closes that with a test over its own content tree; this page has no
equivalent yet.

Co-Authored-By: Claude Opus 5 <[email protected]>
@tannevaled
tannevaled merged commit ce1e7fb into main Nov 9, 2026
3 checks passed
@tannevaled
tannevaled deleted the stubbed-helpers-and-command-line branch November 9, 2026 12:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant