Split flags by categories in --help

[feedmeapples]

What was changed

Splits all flags in --help output by categories:

• Main (ie. command specific options)
• Client (--namespace, --address, etc)
• Formatting
• Pagination

Why?

structuring --help

Checklist

1. Closes

2. How was this tested:

Added a new test TestFlagCategory_IsSet that verifies that all flags have category set. Categories need to be set as otherwise flags will not appear in --help

manually ran:

 workflow list -h                                                                                                                                                                                     ✔ 
NAME:
   temporal workflow list - List Workflow Executions based on a Query

USAGE:
   temporal workflow list [command options] [arguments...]

OPTIONS:
   Client Options:

   --address value                  host:port for Temporal frontend service [$TEMPORAL_CLI_ADDRESS]
   --codec-auth value               Authorization header to set for requests to Codec Server [$TEMPORAL_CLI_CODEC_AUTH]
   --codec-endpoint value           Remote Codec Server Endpoint [$TEMPORAL_CLI_CODEC_ENDPOINT]
   --color value                    when to use color: auto, always, never. (default: "auto")
   --context-timeout value          Optional timeout for context of RPC call in seconds (default: 5) [$TEMPORAL_CONTEXT_TIMEOUT]
   --env value                      Env name to read the client environment variables from [$TEMPORAL_CLI_ADDRESS]
   --namespace value, -n value      Temporal workflow namespace (default: "default") [$TEMPORAL_CLI_NAMESPACE]
   --tls-ca-path value              Path to server CA certificate [$TEMPORAL_CLI_TLS_CA]
   --tls-cert-path value            Path to x509 certificate [$TEMPORAL_CLI_TLS_CERT]
   --tls-disable-host-verification  Disable tls host name verification (tls must be enabled) (default: false) [$TEMPORAL_CLI_TLS_DISABLE_HOST_VERIFICATION]
   --tls-key-path value             Path to private key [$TEMPORAL_CLI_TLS_KEY]
   --tls-server-name value          Override for target server name [$TEMPORAL_CLI_TLS_SERVER_NAME]
   --yes, -y                        Confirm all prompts (default: false)

   Formatting Options:

   --fields value            customize fields to print. Set to 'long' to automatically print more of main fields
   --output value, -o value  format output as: table, json, card. (default: "table")
   --time-format value       format time as: relative, iso, raw. (default: "relative")

   Main Options:

   --archived               List archived Workflow Executions (EXPERIMENTAL) (default: false)
   --query value, -q value  Filter results using SQL like query. See https://docs.temporal.io/docs/tctl/workflow/list#--query for details

   Pagination Options:

   --limit value   number of items to print (default: 0)
   --no-pager, -P  disable interactive pager (default: false)
   --pager value   pager to use: less, more, favoritePager.. [$PAGER]

3. Any docs updates needed?

[bergundy]

Do you need this category if it’s the only one for this command?

[feedmeapples]

not necessarily, added because of the test https://github.com/temporalio/temporal-cli/pull/23/files#diff-69e989ed305c5b5e8b15f1b35372ce98285d02e907045f743c7c89bac6de3979R188

[bergundy]

I checked the output, it's redundant, I'd remove and exclude this command from the test.

[bergundy]

Admit to not testing this out to get a feel for the experience but from looking at the code I agree with what you did here