cli icon indicating copy to clipboard operation
cli copied to clipboard

Improve help message with list of available examples

Open derberg opened this issue 3 years ago • 4 comments

Reason/Context

Doing asyncapi new --file-name=asyncapi.yml --example=default-example.yaml --no-tty us super cool, but to get default-example.yaml you need to navigate to CLI installation, go into assets/examples and see the list of examples, or check if they will be listed in the interactive mode. You also need to kind of guess if example name is just the file name or filename with its extension.

So great feature is kind of hidden from users.

Description

Now I get:

$  asyncapi new --help

creates a new asyncapi file

USAGE
  $ asyncapi new

OPTIONS
  -e, --example=example      name of the example to use
  -h, --help                 show CLI help
  -n, --file-name=file-name  name of the file
  -p, --port=port            port in which to start Studio
  -s, --studio               open in Studio
  --no-tty                   do not use an interactive terminal

I should get:

$  asyncapi new --help

creates a new asyncapi file

USAGE
  $ asyncapi new

OPTIONS
  -e, --example=example.fileExtension      name of the example to use. Available examples are:
                                                - default-example.yml
                                                - somethingElseWithSpecificProtocol.json (MQTT)
  -h, --help                 show CLI help
  -n, --file-name=file-name  name of the file
  -p, --port=port            port in which to start Studio
  -s, --studio               open in Studio
  --no-tty                   do not use an interactive terminal

Bonus would be to see also example for asyncapi new at the bottom of help like:

EXAMPLES
  asyncapi new               start creation of a file in interactive mode
  asyncapi new --file-name=my-asyncapi.yml --example=default-example.yml --no-tty        create new file with specific name, using one of examples and without interactive emode

derberg avatar Dec 14 '21 14:12 derberg

This issue has been automatically marked as stale because it has not had recent activity :sleeping:

It will be closed in 120 days if no further activity occurs. To unstale this issue, add a comment with a detailed explanation.

There can be many reasons why some specific issue has no activity. The most probable cause is lack of time, not lack of interest. AsyncAPI Initiative is a Linux Foundation project not owned by a single for-profit company. It is a community-driven initiative ruled under open governance model.

Let us figure out together how to push this issue forward. Connect with us through one of many communication channels we established here.

Thank you for your patience :heart:

github-actions[bot] avatar Jun 04 '22 00:06 github-actions[bot]

@derberg Can you assign this issue to me?

lakshz avatar Jul 11 '22 14:07 lakshz

@LakshyaSatpal we do not practice issues assignment here. I mean we do not look at the assignment field. Just enough you wrote a comment that you are interested in the issue. So nobody else should now kick in with separate implementation, they should ask in the issue first

derberg avatar Jul 11 '22 14:07 derberg

Oh, okay fine.

lakshz avatar Jul 11 '22 17:07 lakshz

This issue has been automatically marked as stale because it has not had recent activity :sleeping:

It will be closed in 120 days if no further activity occurs. To unstale this issue, add a comment with a detailed explanation.

There can be many reasons why some specific issue has no activity. The most probable cause is lack of time, not lack of interest. AsyncAPI Initiative is a Linux Foundation project not owned by a single for-profit company. It is a community-driven initiative ruled under open governance model.

Let us figure out together how to push this issue forward. Connect with us through one of many communication channels we established here.

Thank you for your patience :heart:

github-actions[bot] avatar Nov 09 '22 00:11 github-actions[bot]

It was almost completed but the initial contributor is no longer active.

If anyone can pick up the work from https://github.com/asyncapi/cli/pull/320 that would be awesome. 95% of stuff is already done

derberg avatar Jul 19 '23 11:07 derberg

:tada: This issue has been resolved in version 0.54.0 :tada:

The release is available on:

Your semantic-release bot :package::rocket:

asyncapi-bot avatar Aug 21 '23 07:08 asyncapi-bot