Skip to content

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

Open
gavin913427-hash wants to merge 1 commit intoasyncapi:masterfrom
gavin913427-hash:fix/param-flag-description
Open

fix: add format hint to --param flag description (fixes #1977)#2175
gavin913427-hash wants to merge 1 commit intoasyncapi: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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: To Triage

Development

Successfully merging this pull request may close these issues.

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

1 participant