feat: v0.2.0
This commit is contained in:
306
include/ArgParse.h
Normal file
306
include/ArgParse.h
Normal file
@@ -0,0 +1,306 @@
|
||||
#ifndef CARGPARSE_H
|
||||
#define CARGPARSE_H
|
||||
|
||||
#include <stdbool.h>
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
#define ARG_DEFAULT_HELP_FLAG "--help"
|
||||
|
||||
typedef struct ArgParse ArgParse; // 解析器
|
||||
|
||||
typedef int (*ArgParseCallback)(ArgParse *argParse,
|
||||
char **val,
|
||||
int val_len); // 回调函数
|
||||
|
||||
typedef enum {
|
||||
NOVALUE = 0, // 无值
|
||||
SINGLEVALUE, // 单值 例如： -i https://www.baidu.com
|
||||
MULTIVALUE, // 多值 例如: -s a b c 或 -s a -s b -s c等
|
||||
} ArgParseValueType; // 值类型
|
||||
|
||||
typedef struct CommandArgs {
|
||||
/* 构造属性 */
|
||||
char *short_opt; // 短选项名， 例如： -h
|
||||
char *long_opt; // 长选项 例如： --help
|
||||
char *default_val; // 默认值
|
||||
char *help; // 选项帮助信息
|
||||
ArgParseCallback callback; // 回调函数
|
||||
bool required; // 是否为必选参数
|
||||
ArgParseValueType value_type; // 值类型
|
||||
/* 解析所用到的属性*/
|
||||
char **val; // 解析到的值
|
||||
int val_len; // 解析到的值个数
|
||||
bool is_trigged; // 是否被触发
|
||||
} CommandArgs;
|
||||
|
||||
typedef struct CommandGroup {
|
||||
char *name; // 命令组名
|
||||
char *help; // 命令组帮助信息
|
||||
struct Command **commands; // 命令
|
||||
int commands_len; // 命令个数
|
||||
} CommandGroup;
|
||||
|
||||
typedef struct Command {
|
||||
/* 构造属性 */
|
||||
char *name; // 命令名
|
||||
char *help; // 命令帮助信息
|
||||
CommandGroup *group; // 命令组
|
||||
char *default_val; // 默认值
|
||||
struct CommandArgs **args; // 命令参数
|
||||
int args_len; // 命令参数个数
|
||||
struct Command **sub_commands; // 子命令
|
||||
int sub_commands_len; // 子命令个数
|
||||
ArgParseCallback callback; // 回调函数
|
||||
ArgParseValueType value_type; // 值类型
|
||||
|
||||
/* 解析所用到的属性*/
|
||||
char **val; // 解析到的值
|
||||
int val_len; // 解析到的值个数
|
||||
bool is_trigged; // 是否被触发
|
||||
} Command;
|
||||
|
||||
typedef struct ArgParse {
|
||||
/* 构造属性 */
|
||||
struct Command **commands; // 命令
|
||||
int commands_len; // 命令个数
|
||||
struct CommandArgs **global_args; // 全局参数
|
||||
int global_args_len; // 全局参数个数
|
||||
char *documentation; // 帮助文档
|
||||
/* 解析所用到的属性*/
|
||||
struct Command *current_command; // 当前解析到的命令
|
||||
int argc; // 参数个数
|
||||
char **argv; // 参数列表
|
||||
} ArgParse;
|
||||
|
||||
/** Start---------------构造API---------------- */
|
||||
|
||||
/**
|
||||
* @brief 初始化解析器
|
||||
* @return ArgParse* 解析器指针
|
||||
*/
|
||||
ArgParse *argParseInit(char *documentation);
|
||||
|
||||
/**
|
||||
* @brief 释放解析器
|
||||
* @param argParse 解析器指针
|
||||
* @return void
|
||||
*/
|
||||
void argParseFree(ArgParse *argParse);
|
||||
|
||||
/**
|
||||
* @brief 自动生成帮助信息
|
||||
* @param argParse 解析器指针
|
||||
* @return void
|
||||
*/
|
||||
void argParseAutoHelp(ArgParse *argParse);
|
||||
|
||||
/**
|
||||
* @brief 添加命令
|
||||
* @param argParse 解析器指针
|
||||
* @param name 命令名
|
||||
* @param help 命令帮助信息
|
||||
* @param group_name 命令组名
|
||||
* @return Command* 命令指针
|
||||
*/
|
||||
Command *argParseAddCommand(ArgParse *argParse,
|
||||
char *name,
|
||||
char *help,
|
||||
char *default_val, // 默认值
|
||||
ArgParseCallback callback,
|
||||
CommandGroup *group,
|
||||
ArgParseValueType value_type);
|
||||
|
||||
/**
|
||||
* @brief 添加子命令
|
||||
* @param Parent 父命令指针
|
||||
* @param name 命令名
|
||||
* @param help 命令帮助信息
|
||||
* @param callback 回调函数
|
||||
* @param value_type 值类型
|
||||
* @return Command* 子命令指针
|
||||
*/
|
||||
Command *argParseAddSubCommand(Command *Parent,
|
||||
char *name,
|
||||
char *help,
|
||||
char *default_val,
|
||||
ArgParseCallback callback,
|
||||
CommandGroup *group,
|
||||
ArgParseValueType value_type);
|
||||
|
||||
/**
|
||||
* @brief 添加命令参数
|
||||
* @param command 命令指针
|
||||
* @param long_opt 长选项名
|
||||
* @param short_opt 短选项名
|
||||
* @param default_val 默认值
|
||||
* @param help 选项帮助信息
|
||||
* @param required 是否为必选参数
|
||||
* @param value_type 值类型
|
||||
* @return CommandArgs* 参数指针
|
||||
*/
|
||||
CommandArgs *argParseAddArg(Command *command,
|
||||
char *short_opt,
|
||||
char *long_opt,
|
||||
char *help,
|
||||
char *default_val,
|
||||
ArgParseCallback callback,
|
||||
bool required,
|
||||
ArgParseValueType value_type);
|
||||
|
||||
/**
|
||||
* @brief 添加全局参数
|
||||
* @param argParse 解析器指针
|
||||
* @param short_opt 短选项名
|
||||
* @param long_opt 长选项名
|
||||
* @param default_val 默认值
|
||||
* @param help 选项帮助信息
|
||||
* @param required 是否为必选参数
|
||||
* @param value_type 值类型
|
||||
* @return
|
||||
*/
|
||||
CommandArgs *argParseAddGlobalArg(ArgParse *argParse,
|
||||
char *short_opt,
|
||||
char *long_opt,
|
||||
char *help,
|
||||
char *default_val,
|
||||
ArgParseCallback callback,
|
||||
bool required,
|
||||
ArgParseValueType value_type);
|
||||
|
||||
/**
|
||||
* @brief 禁用自动生成帮助信息
|
||||
*/
|
||||
void argParseDisableAutoHelp();
|
||||
|
||||
/** End---------------构造API---------------- */
|
||||
|
||||
/** Start----------------解析API---------------- */
|
||||
|
||||
/**
|
||||
* @brief 解析命令行参数
|
||||
* @param argParse 解析器指针
|
||||
* @param argc 参数个数
|
||||
* @param argv 参数列表
|
||||
*/
|
||||
void argParseParse(ArgParse *argParse, int argc, char *argv[]);
|
||||
|
||||
/**
|
||||
* @brief 获取当前解析到的命令名
|
||||
* @param argParse 解析器指针
|
||||
* @return char* 命令名
|
||||
*/
|
||||
char *argParseGetCurCommandName(ArgParse *argParse);
|
||||
|
||||
/**
|
||||
* @brief 获取当前解析到的命令的值,针对带值参数
|
||||
* @param argParse 解析器指针
|
||||
* @return char* 命令值
|
||||
*/
|
||||
char *argParseGetCurCommandValue(ArgParse *argParse);
|
||||
/**
|
||||
* @brief 获取当前解析到的命令的值列表,针对带值参数
|
||||
* @param argParse 解析器指针
|
||||
* @param len 值个数buffer
|
||||
* @return char** 命令值列表
|
||||
*/
|
||||
char **argParseGetCurCommandValues(ArgParse *argParse, int *len);
|
||||
|
||||
/**
|
||||
* @brief
|
||||
* 获取当前解析到的命令的参数,当前命令为解析到的最后一个命令或者命令的子命令
|
||||
* @param argParse 解析器指针
|
||||
* @param opt 选项名
|
||||
* @return char* 选项值
|
||||
* @return
|
||||
*/
|
||||
char *argParseGetCurArg(ArgParse *argParse, char *opt);
|
||||
|
||||
/**
|
||||
* @brief 获取当前解析到的命令参数列表,仅适用于多值参数
|
||||
* @param argParse 解析器指针
|
||||
* @param opt 选项名
|
||||
* @param len 参数个数buffer
|
||||
* @return char** 参数列表
|
||||
*/
|
||||
char **argParseGetCurArgList(ArgParse *argParse, char *opt, int *len);
|
||||
|
||||
/**
|
||||
* @brief 获取全局参数
|
||||
* @param argParse 解析器指针
|
||||
* @param opt 选项名
|
||||
* @return char* 选项值
|
||||
*/
|
||||
char *argParseGetGlobalArg(ArgParse *argParse, char *opt);
|
||||
|
||||
/**
|
||||
* @brief 获取全局参数列表,仅适用于多值参数
|
||||
* @param argParse 解析器指针
|
||||
* @param opt 选项名
|
||||
* @param len 参数个数buffer
|
||||
* @return char** 参数列表
|
||||
*/
|
||||
char **argParseGetGlobalArgList(ArgParse *argParse, char *opt, int *len);
|
||||
|
||||
/**
|
||||
* @brief 检查当前解析到的命令的某个参数是否被触发
|
||||
* @param argParse 解析器指针
|
||||
* @param opt 选项名
|
||||
* @return bool 是否被触发
|
||||
*/
|
||||
bool argParseCheckCurArgTriggered(ArgParse *argParse, char *opt);
|
||||
|
||||
/**
|
||||
* @brief 检查当前解析到的命令是否被触发
|
||||
* @param argParse 解析器指针
|
||||
* @param command_name 命令名
|
||||
* @return bool 是否被触发
|
||||
*/
|
||||
bool argParseCheckCommandTriggered(ArgParse *argParse, char *command_name);
|
||||
|
||||
/**
|
||||
* @brief 检查全局参数是否被触发
|
||||
* @param argParse 解析器指针
|
||||
* @param opt 选项名
|
||||
* @return bool 是否被触发
|
||||
*/
|
||||
bool argParseCheckGlobalTriggered(ArgParse *argParse, char *opt);
|
||||
|
||||
/** End----------------解析API---------------- */
|
||||
|
||||
/**
|
||||
* @brief 生成命令帮助信息
|
||||
* @param command 命令指针
|
||||
* @return char* 命令帮助信息
|
||||
*/
|
||||
char *argParseGenerateHelpForCommand(Command *command);
|
||||
|
||||
/**
|
||||
* @brief 生成全局参数帮助信息
|
||||
* @param argParse 解析器指针
|
||||
* @return char* 全局参数帮助信息
|
||||
*/
|
||||
char *argParseGenerateHelp(ArgParse *argParse);
|
||||
|
||||
/**
|
||||
* @brief 生成选项错误信息
|
||||
* @param argParse 解析器指针
|
||||
* @param name 选项名
|
||||
* @param short_flag 是否为短选项
|
||||
* @return char* 选项错误信息
|
||||
*/
|
||||
char *
|
||||
argParseGenerateArgErrorMsg(ArgParse *argParse, char *name, bool short_flag);
|
||||
|
||||
_Noreturn void argParseError(ArgParse *argParse,
|
||||
Command *lastCommand,
|
||||
char *prefix,
|
||||
char *suffix);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif // __cplusplus
|
||||
|
||||
#endif // CARGPARSE_H
|
||||
Reference in New Issue
Block a user