SuperAPI AI 工具集

assert

测试与质量

查看项目

更新于 10-16 06:16

技能介绍

用途:assert 是 x-cmd 提供的测试断言模块,用于验证命令执行结果、文件系统状态、变量状态和输出内容是否符合预期,适用于 shell 脚本的自动化测试与 CI/CD 流程。

主要能力:校验命令的成功或失败(以退出码 0 表示成功、非零表示失败,配合 set -e 可中断脚本);检验文件是否存在、是否非空等文件系统状态;校验变量类型(如 is-int)以及变量状态;检查 stdout/stderr 是否匹配预期模式或内容。

用法:命令形式为 x assert,例如校验命令成功与整数判断写为 x assert true [ 1 -eq 1 ]、x assert is-int 10 20 30;文件检查写为 x assert is-file /etc/hosts、x assert is-nonempty ./log.txt。支持取反:命令检查用 !,类型或文件检查用 ^。许多子命令支持一次批量检查多个值或文件。检测变量泄漏时,先用 x assert var save 保存状态,运行函数后再用 x assert var cmp 比较。校验复杂多行输出时,可用 stdout 配合 heredoc。

适用场景:需要对命令、文件、变量或输出做回归与断言校验的脚本与测试环境。

限制:资料未提供该模块的具体安装命令、参数全集、返回格式细节及平台兼容性信息。