Project

General

Profile

Actions

Feature #24655

open

Include details about the required options in the help text

Added by Shira Maximov over 6 years ago. Updated over 4 years ago.

Status:
Assigned
Priority:
Normal
Category:
Other commands
Target version:
-
Difficulty:
Triaged:
Yes
Team Backlog:
Fixed in Releases:
Found in Releases:
In Kanboard:

Description

Cloned from https://bugzilla.redhat.com/show_bug.cgi?id=1360489

Description of problem:
Currently, there are many commands in hammer cli that return extremely generic help messages which do not actually help, or do not specify required options of a given command

Version-Release number of selected component (if applicable):
6.1.9

How reproducible:
100%

Steps to Reproduce:
One example would be:

hammer> content-view create
Could not create the content view:
Error: Could not find organization, please set one of options --organization, --organization-label, --organization-id.
hammer> content-view create -h
Usage:
content-view create [OPTIONS]

Options:
--component-ids COMPONENT_IDS List of component content view version ids for composite views
Comma separated list of values.
--composite Create a composite content view
--description DESCRIPTION Description for the content view
--label LABEL Content view label
--name NAME Name of the content view
--organization ORGANIZATION_NAME Organization name to search by
--organization-id ORGANIZATION_ID organization ID
--organization-label ORGANIZATION_LABEL Organization label to search by
--repositories REPOSITORY_NAMES Comma separated list of values.
--repository-ids REPOSITORY_IDS repository ID
Comma separated list of values.
-h, --help print help
hammer>

--organization, --organization-label, --organization-id should have descriptions that let the user know they are required to use the command.

--repositories should let us know that (truly) we need this to have a real, functional content-view.

The same situation applies to --composite and its relationship to --component-ids.

We basically need an overview of all help texts for hammer cli, or we need to link detailed documentation in this help output if we are going to choose to be blatantly non-specific.


Related issues 2 (1 open1 closed)

Related to Hammer CLI - Feature #21635: Extensible commands in hammerClosedOleh FedorenkoActions
Related to Hammer CLI - Tracker #27706: Make the options more readable in the command helpAssignedOleh Fedorenko

Actions
Actions #1

Updated by Shira Maximov over 6 years ago

Actions #2

Updated by Shira Maximov over 6 years ago

  • Subject changed from Include more detailed help text when invoking hammer commands with --help to Include details about the required options in the help text
Actions #3

Updated by Oleh Fedorenko about 5 years ago

  • Related to Tracker #27706: Make the options more readable in the command help added
Actions #4

Updated by Ondřej Pražák almost 5 years ago

  • Triaged changed from No to Yes
Actions #5

Updated by Shira Maximov over 4 years ago

  • Status changed from New to Assigned
  • Assignee set to Oleh Fedorenko
Actions

Also available in: Atom PDF