API修改意见征集-No.2

[RF-Tar-Railt]

对于现阶段 Alconna 的 api 有更好意见的都可以在这里提出来

以及可能的新 api：

1. 提供更简单的构造方式:

class Alc:
    main = Args[...]
    opt1 = Option(...)
    sub = Subcommand(...)
delegate(Alc).parse(...)

2. ArgPattern提供简易的构造方法，例如

def my_converter(text:str):
    return int(text)
with convert(my_converter, r"\d+") as int_:
    args = Args["foo":int_]

或者是

@pattern_gen("int_", r"\d+")
def my_converter(text:str):
    return int(text)
...
args = Args["foo":"int_"]

3. AlconnaGroup

AlcGp是作为多级结构的替代实现（即解禁subcmd禁止嵌套后的效果）

AlcGp拥有一个标识符，作为对其下命令集的等效父级命令地址

一个命令只能加入一个命令组内，并且加入时其所在命名空间自动替换为其命令组所在命名空间

AlcGp允许嵌套

4. 多separator多支持

即传入separator时可以接受Collection[str]

如

arg = Args["tag;S":str].separate("和", "与", ",")
...
>>> analyse_args(arg, "女仆,双人和百合与纯爱")
{"tag": ("女仆", "双人", "百合", "纯爱")}

[RF-Tar-Railt]

5. 命令重载
   现阶段，重复名字的命令创建会报错。
   可以使用如下方式来覆盖原有命令：

alc = Alconna("test")
alc1 = Alconna("test", override=True)

[RF-Tar-Railt]

6. 上下文

将 Analyser 内的一些临时数据（如header，separators）作为上下文内容，并以此将 Analyser 作为一个单例。

提供一个方法/函数using来创建上下文，Analyser 解析时读取其内容。

除此之外，类似报错选项等数据也可以通过 using 注入

with using(Alconna(...)) as ana:
    res = ana.parse(xxx)

或

with Alconna(...).using() as ana:
    res = ana.parse(xxx)

或

# parse 开始时注入上下文，结束时销毁上下文
Alconna(...).parse(xxx)

[RF-Tar-Railt]

7. 再次拓展header与command

即允许header与command处塞入BasePattern/Type

如 Alconna("test", headers=[int])