Skip to content

fix: add format hint to --param flag description (fixes #1977)#2175

Closed
gavin913427-hash wants to merge 1 commit into
asyncapi:masterfrom
gavin913427-hash:fix/param-flag-description
Closed

fix: add format hint to --param flag description (fixes #1977)#2175
gavin913427-hash wants to merge 1 commit into
asyncapi:masterfrom
gavin913427-hash:fix/param-flag-description

Conversation

@gavin913427-hash
Copy link
Copy Markdown

What does this PR do?

Improves the --param flag description to include the expected format, so users don't have to fail first to discover the correct syntax (fixes #1977)

Changes

Updated the --param flag description in src/apps/cli/internal/flags/generate/sharedFlags.ts:

Before: Additional param to pass to templates
After: Additional param to pass to templates (format: name=value)

This matches the format shown in the error message from parseParams.ts:

Invalid param ${input}. It must be in the format of --param name1=value1 name2=value2

Why this matters

Users trying common formats like --param name:value or --param name:value will now see the correct format in --help before encountering an error, improving the CLI's UX.

Related issue(s)

Fixes #1977

Checklist

  • Updated flag description
  • Added changeset
  • No test changes needed (no tests assert this description)

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented May 4, 2026

🦋 Changeset detected

Latest commit: 4f2c4bf

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
@asyncapi/cli Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@sonarqubecloud
Copy link
Copy Markdown

sonarqubecloud Bot commented May 4, 2026

@github-project-automation github-project-automation Bot moved this from To Triage to Done in CLI - Kanban May 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

[BUG] Clarify usage format for --param flag in help command

2 participants