Thanks to visit codestin.com
Credit goes to github.com

Skip to content

fix: show descriptions for the assert and run subcommands in --help#65

Merged
PeterKneale merged 2 commits into
mainfrom
fix/subcommand-help-descriptions
Jun 25, 2026
Merged

fix: show descriptions for the assert and run subcommands in --help#65
PeterKneale merged 2 commits into
mainfrom
fix/subcommand-help-descriptions

Conversation

@PeterKneale

Copy link
Copy Markdown
Owner

Summary

The assert and run subcommands rendered with blank descriptions in bioassert --help because their Commands enum variants had no /// doc comment, unlike suggest. This adds doc comments matching the existing README wording so every subcommand describes itself.

Before:

Commands:
  assert
  run
  suggest  Inspect a file and write a set of suggested default assertions for review
  help     Print this message or the help of the given subcommand(s)

After:

Commands:
  assert   Evaluate a single assertion passed as one quoted string
  run      Evaluate every assertion in a file (defaults to assertions.txt)
  suggest  Inspect a file and write a set of suggested default assertions for review
  help     Print this message or the help of the given subcommand(s)

Notes

  • Help text only. No grammar, dispatch, or behaviour changes.
  • cli is a private module in the binary, so there is no library API change.
  • tests/cli_flags_test.rs asserts only on Usage: substrings, so the suite stays green; full cargo test passes locally.

🤖 Generated with Claude Code

Copilot AI review requested due to automatic review settings June 25, 2026 07:04

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR fixes the bioassert --help output by adding missing Rust doc comments to the assert and run clap subcommand enum variants, so they render non-blank descriptions like suggest already does.

Changes:

  • Added a help/description doc comment for the assert subcommand.
  • Added a help/description doc comment for the run subcommand.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot AI review requested due to automatic review settings June 25, 2026 07:11
@PeterKneale PeterKneale force-pushed the fix/subcommand-help-descriptions branch from 0cb310c to 32abd8a Compare June 25, 2026 07:11

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

@PeterKneale PeterKneale force-pushed the fix/subcommand-help-descriptions branch from 32abd8a to 189a91a Compare June 25, 2026 07:13
PeterKnealeCMRI and others added 2 commits June 25, 2026 17:18
The assert and run subcommands rendered with blank descriptions in
`bioassert --help` because their Commands enum variants had no doc
comment, unlike suggest. Add `///` doc comments matching the README
wording so all subcommands describe themselves.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
Adding the doc comment made rustfmt collapse `Assert { assertion: String }`
onto one line. Apply it so `cargo fmt --check` passes.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
@PeterKneale PeterKneale force-pushed the fix/subcommand-help-descriptions branch from 189a91a to 5d6c848 Compare June 25, 2026 07:18
Copilot AI review requested due to automatic review settings June 25, 2026 07:18

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

@PeterKneale PeterKneale merged commit d585e7f into main Jun 25, 2026
4 checks passed
@PeterKneale PeterKneale deleted the fix/subcommand-help-descriptions branch June 25, 2026 07:22
@github-actions github-actions Bot mentioned this pull request Jun 25, 2026
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.

3 participants