用途:parseArger Core 是 parseArger 的核心功能技能,用于生成、解析或修改 bash 参数解析脚本。
使用前先判断目标文件是否存在:不存在则用 generate 创建新脚本;已存在则用 parse 修改。运行前需确认 parseArger 命令可执行:先尝试直接运行 parseArger(在 PATH 中),否则回退到项目根目录下的 ./parseArger,不可臆断位置。
生成新解析器:使用 parseArger generate --output /path/to/script.sh [OPTIONS]。不加 --output 时仅输出到 stdout。可用 --pos 定义位置参数、--opt 定义选项、--flag 定义标志、--nested 定义命名空间选项,另有 --help-message、--version-opt、--leftovers、--verbose-level 等全局设置。生成的变量命名规则为 $arg<name>(连字符转为下划线),嵌套选项为关联数组。
解析或修改已有文件:使用 parseArger parse FILE [OPTIONS],常用 -i/--inplace 直接修改,可继续用 --pos、--opt、--flag 追加参数,或用 --set-version 更新版本。
重要限制:脚本中 # @parseArger-parsing 与 # @parseArger-parsing-end 之间的生成代码不要手动编辑;要修改参数解析,应编辑文件顶部的 # @parseArger 声明,再运行 parseArger parse FILE --inplace 重新生成。parse 仅适用于已存在且包含 # @parseArger 注释、由 parseArger 创建的文件。子命令可通过带 --subcommand 的位置参数及 --subcommand-directory 指定脚本目录来实现。更多收费、平台等信息暂未提供。