优化 usage 和 help 输出

[kioz-wang]

提供更清晰简洁的 usage 和 help

[kioz-wang]

[kioz@kinuc zargs]$ zig build ex-mess -- -h
Usage: demo [-h|--help] [-v]... [--] {sub0|sub1}

This is a demo

Version 1.0     Author <kioz.wang@gmail.com>

Options:
[-h|--help]             Show this help then exit
[-v]...                 (default=0)

Commands:
sub0
sub1                     This is an empty subCmd

[kioz@kinuc zargs]$ zig build ex-mess -- sub0 -h
Usage: sub0 [-h|--help] [-v]... [--oint {OPTIONAL_INT}] --int {PositiveNumber} --bool {BOOL} [--color {COLOR}] [--colorp {COLORP}] --lastc {word} --word {WORD} --3word {[3]3WORD} --num {[]N}... [--] {POS_INT} [{Num}] [{[2]Num}]

Options:
[-h|--help]             Show this help then exit
[-v]...                 (default=0)

Options with arguments:
[--oint {OPTIONAL_INT}]     (default=1)
--int {PositiveNumber}      give me a u32
--bool {BOOL}           give me a bool
[--color {COLOR}]       give me a color
                        (default=Blue)
                        (enum{ Red, Green, Blue })
[--colorp {COLORP}]     give me another color
                        (default=White)
--lastc {word}          give me a word
--word {WORD}
--3word {[3]3WORD}      give me three words
--num {[]N}...

Positional arguments:
[{Num}]                 give me a u32
                        (default=9)
{POS_INT}               give me a u32
[{[2]Num}]              give me two u32
                        (default={ 1, 2 })

[kioz@kinuc zargs]$ zig build ex-mess -- sub1 -h
Usage: sub1 [-h|--help]

This is an empty subCmd

Options:
[-h|--help]             Show this help then exit

[kioz-wang]

[kioz@kinuc zargs]$ zig build ex-02 -- -h
Usage: demo [-h|--help] [-v]... [--log {LOGFILE}] [--] {install|remove}

This is a demo intended to be showcased in the README.

Author <KiozWang>       Homepage https://github.com/kioz-wang/zargs

Options:
[-h|--help]             Show this help then exit
[-v]...                 help of verbose
                        (default=0)

Options with arguments:
[--log {LOGFILE}]       Store log into a file
                        (default=null)

Commands:
install
remove
(alias{ rm, uninstall, del })

[kioz@kinuc zargs]$ zig build ex-02 -- install -h
Usage: install [-h|--help] [-c|--count {COUNT}] -o|--out {OUTPUT} [--] {NAME}

Options:
[-h|--help]             Show this help then exit

Options with arguments:
[-c|--count {COUNT}]    (default=10)
                        (ranges{ [5,7), [13,∞) })
                        (choices{ 10, 11 })
(alias short{ n, t } long{ cnt })
-o|--out {OUTPUT}

Positional arguments:
{NAME}                  (raw_choices{ gcc, clang })

[kioz@kinuc zargs]$ zig build ex-02 -- remove -h
Usage: remove [-h|--help] [-v]... [-c {CNT}] [--] {NAME}

Options:
[-h|--help]             Show this help then exit
[-v]...                 (default=0)

Options with arguments:
[-c {CNT}]              (default=9)

Positional arguments:
{NAME}

[kioz-wang]

[kioz@kinuc zargs]$ zig build ex-05 -- -h
Usage: config [-h|--help] [--] {SUB}

Options:
[-h|--help]             Show this help then exit

Positional arguments:
{SUB}                   (enum{ A, B, C, D })

[kioz@kinuc zargs]$ zig build ex-05 -- A -h
view opt<short<h>>
Usage: A [-h|--help] [-v|--verbose]... [-i|--ignore] [-o|--out {OUTPUT}] [--] {B}

Options:
[-h|--help]             Show this help then exit
[-v|--verbose]...       (default=0)
[-i|--ignore]           (default=false)

Options with arguments:
[-o|--out {OUTPUT}]     (default=null)

Commands:
B

[kioz-wang]

$ -h|--help
# Command name、选项的 short 和 long 都会有多个值。取第一个为正式名，其余为别名（alias）。在 Usage 中，只使用正式名

Usage: {name} [所有仅有short的选项] [其他选项] [带选项参数] [--] [位置参数] # 可选参数在后
# 带选项参数中，选项和参数要用下划线连接为一个整体
# 如果选项有 short 和 long，那么应当用`|`连接

# 以下，如果选项有 short 和 long，应当用`, `连接
# 别名需要在所有内容输出后，另起一行输出。不管是选项还是Command name，都用`, `连接：`(alias -a, -b, --alias)`, `(alias u, un)`
Options:
...
Options with Arguments:
...
Positional Arguments / Commands:
...
# 选项和可选参数并不以`[]`包围，而是按`Style.new().dim()`显示

以上，需要 Meta 提供以下格式化能力：所有接口都将会被调用，并返回一个 bool 表示是否真的有输出。

• formatOptions(self, w, prefix, seperator)
• formatAlignSpace(self, w, is_first) 其中会计算 formatOptions 和 argname 的长度（不包含 console_codes），然后输出对应数量的空格。空格数量在编译期就可以确定下来
• formatAlias(self, w)
• formatHelp(self, w)
• formatDefault(self, w)
• formatValues(self, w) 包括 ranges 和 choices，以及当 T 为枚举时，列出所有枚举值
• formatInputs(self, w) 指 raw_choices
• formatInCommandHelp(self, w)

需要 Command 提供以下格式化能力：

• formatTitle(self, w, title)
• formatUsage(self, w)
• formatHelp(self, w)
• formatAlias(self, w)
• formatOptions(self, w)
• formatOptionsWithArguments(self, w)
• formatPositionalArguments(self, w)

#20 难搞呀

所有 format 方法都放在一个新的类型中，新类型包含 Meta 或 Command，以及 w，从而避免重复传参

终端属性要如何传递到 format 方法中？新类型中，要包含属性配置