args-test

参数解析示例说明

本示例用于演示 Redant 对多种参数格式的处理方式，以及命令解析与参数解析之间的优先级关系。

关联文档：README · 设计文档

解析流程图

flowchart TD
    A[接收输入参数] --> B{是否命中子命令}
    B -- 是 --> C[执行子命令]
    B -- 否 --> D[识别参数格式]
    D --> E[位置参数]
    D --> F[查询串参数]
    D --> G[表单参数]
    D --> H[JSON 参数]
    E --> I[进入处理器]
    F --> I
    G --> I
    H --> I

解析状态图

stateDiagram-v2
    [*] --> 等待输入
    等待输入 --> 命令匹配
    命令匹配 --> 参数分类
    参数分类 --> 参数解析成功
    参数分类 --> 参数解析失败
    参数解析成功 --> 处理完成
    参数解析失败 --> 输出错误
    处理完成 --> [*]
    输出错误 --> [*]

支持的参数格式

1) 位置参数

./args-test multi arg1 arg2 arg3

2) 查询串格式

./args-test query "name=张三&age=30&tags=go&tags=cli"

• 使用 & 分隔多个键值对
• 允许重复键
• 在处理器中使用 ParseQueryArgs() 解析

3) 表单格式

./args-test form "user=admin email=admin@example.com active=true"

• 使用空格分隔多个键值对
• 支持带引号的值
• 在处理器中使用 ParseFormArgs() 解析

4) JSON 格式

./args-test json '{"id":123,"title":"测试","count":42}'
./args-test json '["v1","v2","v3"]'

• 支持 JSON 对象与数组
• 在处理器中使用 ParseJSONArgs() 解析

子命令与参数冲突优先级

flowchart LR
    A[输入 token] --> B{是否匹配子命令}
    B -- 是 --> C[按子命令执行]
    B -- 否 --> D[按参数格式继续解析]

规则：

1. 优先做子命令匹配。
2. 未命中子命令时，再按参数格式识别与解析。

常用测试命令

./args-test conflict "value=test"
./args-test conflict sub
./args-test complex "pos1" "flag1=value1" "flag2=100"
./test.sh

说明

• 含特殊字符参数请使用引号包裹。
• JSON 建议使用单引号包裹，避免 shell 转义问题。
• 位置参数与键值参数可混用，但应保持顺序可读。