Skip to content

Surface "latest" first as recommended version in local --help#266

Merged
sdairs merged 1 commit into
mainfrom
issue-265-help-latest-recommended
Jun 18, 2026
Merged

Surface "latest" first as recommended version in local --help#266
sdairs merged 1 commit into
mainfrom
issue-265-help-latest-recommended

Conversation

@sdairs

@sdairs sdairs commented Jun 17, 2026

Copy link
Copy Markdown
Collaborator

Closes #265.

For local commands, the --help text enumerating version specs now lists latest first and marks it as recommended.

Changes

All in crates/clickhousectl/src/local/cli.rs:

  • local install<VERSION> arg help now reads "latest" (recommended), "stable", "lts", partial like "25.12", or exact like "25.12.9.61".
  • local use — both the <VERSION> arg help and the after_help spec enumeration now lead with "latest" (recommended).
  • local server start — the --version/-v flag help and the after_help ("Accepts same specs as install/use…") now lead with "latest" (recommended).

Testing

  • cargo build, cargo clippy, and cargo test --bins all clean.
  • Manually verified rendered --help output for local use.

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only changes to clap help strings; no runtime or version-resolution behavior is modified.

Overview
Updates clickhousectl local CLI help so version specs consistently list "latest" (recommended) first wherever users pick a ClickHouse version.

local install and local use argument help, plus local use and local server start after_help text, now enumerate latest before stable, lts, partial, and exact versions. The server start --version / -v flag help matches the same ordering and wording.

Reviewed by Cursor Bugbot for commit 11e0c93. Bugbot is set up for automated code reviews on this repo. Configure here.

Issue #265: the local help text enumerating version specs omitted
"latest" and didn't recommend a default. Update install, use, and
server start (--version + after_help) so the spec enumeration lists
"latest" (recommended) first.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@sdairs sdairs requested a review from iskakaushik as a code owner June 17, 2026 16:26

@iskakaushik iskakaushik left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

LGTM

@sdairs sdairs merged commit 6484121 into main Jun 18, 2026
3 checks passed
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.

[enhancement]: local --help should list 'latest' first as the recommended version

2 participants