修复 help text的bug

1. 改进字符串分割过程，以运行更细粒度的分隔控制
2. 加入ArparmaExecutor，以绑定一个响应函数
3. behaviors与formatter的配置移至Namespace, 原Alconna.config仅用于配置解析器类型
4. Alconna构建时不再允许废弃的kwargs参数传入
5. 'Arpamar' -> 'Arparma'
6. 改进 Args 构建， 加入 Arg 类 替代原先的 ArgUnit，并保留参数名后缀传入
7. 可变参数与键值参数需要通过 alconna.typing.MultiVar 与 alconna.typing.KeyWordVar 显式声明， 并提供 alconna.typing.Kw 来进行缩写 (如 Kw @ int)
8. 修复可能存在的内存泄漏问题
9. 原先的 ArgFlag 'H','O','A' 变回 '/','?','!'
10. Args.separators 移除，分割任务转移给 Arg.separators
11. set_default 现在可以传入 factory 参数， 并且必须传入关键字参数

1. 添加通过"+"以组合字符串与选项或者子命令等隐式构建命令的方法
2. 允许自定义内建选项的名称，比如改"--help"为"帮助"
3. Arpamar.find 现在可以用 query_path 了
4. Arpamar.query 现在返回的是MappingProxyType, 若需要修改path的值请用Arpamar.update
5. 修复 bugs
6. 调整lang config
7. 修改 help text 的 bug
8. 调整 completion 样式

1. 修复 bugs
2. 调整 Alconna的构造样式, 将header、command、options等合并; 兼容旧版写法到1.4
3. 原先的builtins迁移至arclet-alconna-tools, 只保留set_default、store_value与version
4. set_default可以附加一个 arg 名
5. 调整repr样式
6. 取消 shortcut的expiration
7. 新增命名空间配置，并将原先部分全局配置划为命名空间下的配置
8. 允许.parse传入参数interrupt(bool)以在参数缺失的情况下可后续自行加参数

Alconna 1.2.0:

1. 修复 bugs
2. 加入 ArgField, 可填入 alias, default_factory等 #50
3. 命令管理器可以获取原始的命令数据 #52
4. 加入命令补全功能, 暂由--comp|-cp触发 #53
5. 加入 CommandMeta, 并取代help_text、is_raise_exception等
6. meta 新增 hide, 可以在命令管理器获取所有帮助时跳过该命令 #51

Alconna 1.1.2:

1. 修复 bugs
2. BasePattern 加入 to 方法

Alconna 1.1.1:

1. Arpamar 泛型支持, 可通过Arpamar[type]指定原指令的类型
2. Alconna 可通过 | 进行组合, 返回命令组

alc = Alconna("{place1}在哪里") | Alconna("哪里有{place1}")
alc.parse("食物在哪里")
alc.parse("哪里有食物")

Alconna 1.1.0:

1. AlconnaDuplication -> Duplication
2. Duplication 现在支持写入参数名或头部名称, 如

command = Alconna("test", Args["foo", int]) + Option("bar", Args["bar", str])

class Demo(Duplication):
    foo: int
    bar: str

3. Arpamar 在执行行为器时可以通过抛出 OutBoundsBehave 使解析失败
4. 修复bugs

日志

1. 将lang迁移到新增的config中，并为config加入了如全局分隔、开启缓存等选项
2. 压缩代码量并规范化
3. --help 选项允许在命令任何部位生效, 并且会根据当前命令选择是否展示选项的帮助信息
4. Args name 的flag附加现在不需要以|分隔
5. Args name 允许用#...为单个Arg提供注释, 其会展示在帮助信息内
6. Args 允许传入 Callable[[A], B] 作为表达, 会自动解析输入类型与输出类型
7. 完善了测试代码, 位于测试文件夹内, 通过入口文件可执行全部测试
8. 加入一个类似beartype的checker
9. 命令头部允许使用非str类型, 即可以Alconna(int)
10. 解析器增加预处理器选项, 允许在分划数据单元前进行转化处理
11. 性能提升, 理想情况最快约为 20w msg/s
12. 删除Alconna.set_action
13. 重构 ObjectPattern
14. 增加 datetime的 BasePattern, 支持传入时间戳或日期文字
15. Analyser 的字段修改, next_data -> popitem, reduce_data -> pushback
16. output_send 合并到 output_manager
17. Option 添加参数priority, 仅在需要选项重载时安排优先级
18. 修复bugs

Alconna 0.9.0:

1. 将 HelpAction 与 HelpTextFormatter 作为 help 模块
2. 语言配置组件的增强. 现在以语言种类标识符作为父级, 以支持多语言.
3. 为 manager 新增一个记录命令输入的 LruCache. 解析器可以使用这个缓存来避免重复解析. 目前缓存上限为 100.
4. 新增 --shortcut 内置选项, 为命令提供临时快捷命令的创建与删除.
5. 修改 manager 中的 shortcut, 并支持持久化
6. 部分性能优化, 以大致抵消因缓存计算而带来的性能损耗.
7. 部分 api 名称变更:

• pattern -> pattern_gen
• handle_message -> process_message

8. Args 新增 add_argument 方法, 以添加参数.

Alconna 0.9.1:

1. 增添 dest, 其作为选项在 Arpamar 中的实际名称.
2. 增加内建 Argument 方法, 类似于 add_argument, 以便捷创建 Option + Args 的组合.
3. 修复 bug

Alconna 0.9.2:

1. 增强 Arpamar 的功能, 使其更类似于一种接口. 其中的修改有: #42

• 从 get() 变为 query()
• 从 has() 变为 find()
• 从 set() 变为 update()
• 从 update() 变为 execute()
• 增加 get_duplication()
• 增加 source, origin 属性

2. 项目结构调整
3. ArgAction 的执行现在交给 ActionHandler 来处理. #40
4. split 以及 separator 现在需要传入 Set[str] 类型. #39
5. 修复 bug.

Alconna 0.9.3:

1. 合并 ArgPattern 与 TypePattern 为 BasePattern, 并将诸多分散特性(如 anti, any) 移动到 BasePattern 中. #34
2. 取消 Analyser 中有关 arg_handler 的部分
3. AnyStr、AnyDigit、AnyFloat 等现在不被公开.
4. AnyParam 重写为由 BasePattern 实现, 并改名为 AnyOne.
5. alconna.types 变为 alconna.typing.
6. 修复 bug.

Alconna 0.9.4:

1. 修改 Args 的构造方法, 取消使用 slice 传入参数. 请从 Args[foo:int, bar:str:default] 修改为 Args[foo, int][bar, str, default].
2. Option 与 Subcommand 现支持 requires 参数, 该参数允许解析该节点时判断 require 的字段是否存在. #44
3. Option 与 Subcommand 的 requires 可以通过 name 传入, 用空格分隔. 该特性要求 Option 中传入别名时不能用空格.
4. 允许同名的 Option 与 Subcommand 在同一个命令中, 应保证能用 require 参数来区分.
5. 允许简单的选项重载, 如 Option("foo", Args.bar[int]) 可以与 Option("foo") 一起使用.
6. BasePattern 增加 validator 属性, 负责对匹配结果进行验证. #47
7. Args 支持 Annotated 的传入, 如 Args.bar[Annotated[int, lambda x: x > 0]], 或使用 arclet.alconna.typing.Bind
8. 加入 AlconnaGroup 类, 用于组合多个 Alconna 对象. 其解析行为与 Alconna 相同. #46
9. 取消不能构建多个重名的 Alconna 对象, 以 AlconnaGroup 代替. (暂定)
10. 删除 arclet.alconna.components.visitor, 修改 Formatter 的传入参数.
11. 增加 Alconna.config 类方法, 用于设置全局配置.
12. 移出 arclet.alconna.builtin.commandline, 独立为一个模块 alconna-cli.
13. ObjectPattern 移动到 arclet.alconna.builtin.pattern 模块.
14. 修复 bug.

Alconna 0.8.0:

1. Option的alias现在需要传入List[str]，而不是str。
2. help_text内置两个预选板块Usage和Example, 编写规则为"xxx Usage:xxx; Example:xxx;"。
3. 加入TypePattern, 作用为简单的类型转换器, 其可以设置前置转换器, 即可以str -> Path -> bytes。 #34
4. 加入命令的模糊匹配, 在Alconna中传入is_fuzzy_match参数, 可以设置是否模糊匹配。
5. AlconnaString参数规则修改, 现在<xx>表示必选, [xx]表示可选, &xx表示action的值。
6. ArgparseHelpTextFormatter相关格式修改

Alconna 0.8.1-0.8.2:

1. 修改了一些docstring
2. 修改参数前缀, 现需要以后缀形式传入, 以';'为开头, 并用'|'分割。 #35
3. 参数前缀现通过单个大写字母表示, 具体对应如下:

• 'S' <= '*'
• 'W' <= '**'
• 'O' <= '?'
• 'K' <= '@'
• 'H' <= '_'
• 'F' <= '#'
• 'A' <= '!'

4. 参数标识符现增加数字, 以表示指定长度的可变参数, 如'foo;S'表示能接收任意长度的可变参数, 'foo;3'表示接收长度为3的可变参数。 #35
5. Args现在允许传入分隔符, 通过Args.separate(xx)或Args / xx设置
6. 加入pattern装饰器函数, 用以便捷的创建ArgPattern对象 #35
7. 加入delegate装饰器函数, 用以便捷的创建Alconna对象
8. 修复bug

Alconna 0.8.3:

1. 命令头的正则支持格式修改, 由原来的f"{表达式}"改为"{名称:类型或表达式}"
2. 加入语言文件配置, 可以通过Alconna.load_config_file加载自定义的语言文件, 格式为json
3. 为选项与子命令的匹配也加入了模糊匹配
4. 选项与子命令的separator可以传入空字符串, Alconna会据此自动分割 #35
5. 部分API修改, 暂时去除from_dict方法
6. 修复了一些bug

Alconna 0.7.0

1. 依据 #21 进行了相关调整, 不兼容0.7以下
2. 以下多个组件或模块进行了修改, 具体内容请查看 更新日志

• Alconna
• TemplateCommand
• Subcommand
• Arpamar
• ArgAction
• AlconnaDecorate
• alconna.analyser

3. 增加alconna.analysis,

Alconna 0.7.1:

1. 增加alconna.builtin.construct.AlconnaFire，为Alconna的Fire-like方法. #22 其会尝试根据传入的对象生成Alconna
2. 增加 UnionArg, 其传入的列表中可以包含ArgPattern、Type与实际值. 为choice的改进
3. Args支持传入Union[...]格式的参数
4. 增加 ObjectPattern, 其会尝试从对象中生成ArgPattern, 并在解析成功后创建实例
5. action现支持传入异步函数 #23
6. AlconnaString现在会读取locals的值

Alconna 0.7.2:

1. 改进AlconnaFire方法, 其可通过AlconnaFire.instance获取目标对象的可能实例 #27
2. 加入SequenceArg与MappingArg, 其对应解析列表、元组、集合与字典
3. Subcommand在其Args未解析时抛出异常
4. Arpamar现在可以获取subcommands与error_info
5. 增强Format #25
6. 修改help—action相关

Alconna 0.7.3:

1. 优化结构
2. 增加AlconnaFire的Config, 用来约束AlconnaFire的参数 #27
3. AlconnaFire现在可以解析子命令, 通过Config传入get_subcommand=True来启用 #26
4. 更好的parameter-helptext
5. 新增Args构造方法a = Args.xxx[value, default]
6. util.chain_filter重新归并到Analyser.handle_message里
7. 增加Force类, 用以标记arg类型不需要进行转换; 或者在key前面加上"#"
8. 支持传入键值对参数与可变键值对参数, 分别用"@"和"**""标记
9. 支持将参数设为可选(即未解析成功时不报错而是跳过), 用"?"标记
10. Arpamar可以通过XXX.opt.arg1、XXX.sub.sub_opt.arg2等方式获取参数值
11. 修复bug

Alconna 0.7.4 ~ 0.7.4.3

1. 修复BUG
2. 加入Alconna.local_args
3. 增加_key前缀, 用以隐藏参数注解

Alconna 0.7.5

1. 内部类型改进, MessageChain -> DataCollection #29
2. 加入ArpamarBehavior, 用以解析后的预处理, 并提供三个预制的behavior: #30

• set_default: 当某个选项未被输入时, 使用该行为添加一个默认值
• exclusion: 当指定的两个选项同时出现时报错
• cool_down: 限制命令调用频率

3. 加入NodeVisitor与HelpFormatter, 并将原先给CommandNode的help生成转移给Formatter #24
4. 加入AlconnaMessageProxy, 用作对外适配接口

Alconna 0.7.6

1. 增加对Graia系的原生支持, 位于arclet.alconna.graia; 请用pip install arclet-alconna[graia]获取
2. header现在可支持非文字类元素与文字混用的解析, 原来的方式请改用元组(非文本元素, 文本)
3. 增加Alconna 对 /与@ 运算符的支持, 作用为重置命名空间
4. 增加Alconna 对 + 运算符的支持, 作用为增加选项
5. Args 可直接传入 str, 即Args["foo":"foo"] -> Args["foo"]
6. Format中的format slot可以直接写入类型, 如"{name: str}"

Alconna 0.7.7

1. 加入Argparser风格的HelpFormatter
2. 加入AlconnaDuplication, 旨在提供更好的解析结果使用
3. option的name与alias现在会根据长度自动倒换
4. 修复Bug

Alconna 0.6.0:

1. 加入click-like构造方法，具体内容在alconna/decorate里 #13
2. 加入命令行功能，目前功能为便捷式编写Alconna与便捷查看docstring #16
3. 性能优化, 包含正则参数解析的速度提升大约10%
4. Option支持重复输入，此时多个解析结果会以列表形式存放

Alconna 0.6.1:

1. 性能优化加强, 现在纯字符串匹配可以跑到60000msg/s (与之相对, 匹配其他消息元素可以跑到10w msg/s, re出来挨打)
2. commandline增加一个analysis功能，可以把命令转为命令格式
3. 修复Bug

Alconna 0.6.2:

1.修复几个Bug 2.加入from_dict与to_dict，暂时无法支持保存action #17 3.命令行功能加入using

Alconna 0.6.3:

1. 修复命令行的Bug
2. 加入变长参数的支持, 可以在参数名前面添加一个*来表示变长参数

Alconna 0.6.4:

1. 加入快捷指令功能, 可以用一段特殊的字符串来表示命令 #18
2. 加入arg-choice, 可以指定参数的可选值
3. 修改docstring, 使其变得更加可读
4. 加入commandManager.broadcast功能, 可以广播命令

Alconna 0.6.5:

1. 可以自定义all_command_help
2. 加入anti-arg, 用以反向检查参数 #20
3. 修复一些bug

Alconna 0.5.1: 优化整体结构；完善了action相关；修改参数默认值的bug Alconna 0.5.2: 紧急修复Action无法返回值的bug Alconna 0.5.3: 增加自定义消息元素过滤；headers支持传入消息元素 Alconna 0.5.4: 优化结构；Arpamar 现可直接以XXX.name方式获取参数 Alconna 0.5.5: from_sting可以传入option了；修复bug Alconna 0.5.6: 修复Bug; 增加了Email的参数匹配 Alconna 0.5.7: 修复非ArgPattern修饰的参数无法解析消息元素的Bug Alconna 0.5.8: 加入有序匹配模式与命令缓存, 能使性能大大提升 Alconna 0.5.9: help选项可用传入一自定义函数已达到直接发送帮助说明的效果；规范format方法；from_string现在可以用#加入帮助说明；加入commandManager，帮助管理所有命令；支持解析原始消息链

Alconna 0.4.1：加入 AnyParam类型 (单次泛匹配)与AllParam类型 (全部泛匹配);修改部分逻辑 Alconna 0.4.2：加入AnyFloat预制正则; Args构造支持传入元组; 增加两种简易构造Alconna的形式; 修复Bug Alconna 0.4.3：加入Action (暂时只针对Option); Args解析出来的结果 (如bool值, int值) 会转为指定的类型

Alconna 0.3.1: 加入Args类、main_argument -> main_args, 砍掉了Default Alconna 0.3.2: 取消了pydantic的依赖，结构优化，加入Option的alias功能 Alconna 0.3.3: 修改Args内部构造、加入Pattern (仍向下兼容), 并为两个引入魔术方法；修改exception Alconna 0.3.4: 参数传入改进，代码审核改进

0.2.1: 内置Help功能 0.2.2： 微调

0.1.1 Alconna基础功能 0.1.2 Arpamar结构简化+支持Graia v5形式的消息链 0.1.3 取消Letoderea的依赖，AlconnaParser改回Cesloi内