# @drevops/bats-helpers 中文文档

规范地址：https://npmcn.com/package/%40drevops/bats-helpers/

版本：2\.0\.0
npm 元数据更新时间：2026-08-05T20:36:58.816Z
中文译文更新时间：2026-11-13T01:55:45.889Z
软件包许可：GPL-3\.0-or-later

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40drevops/bats-helpers
原文对照：https://npmcn.com/package/%40drevops/bats-helpers/?lang=original
项目主页：https://github.com/drevops/bats-helpers
源码仓库：https://github.com/drevops/bats-helpers

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：396 kB，35 个文件
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2023-03-20T12:54:27.630Z
- 最新版本发布：2026-08-05T20:36:58.642Z
- 近 30 天下载量：2509（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 3 个）

## 中文简介

BATS测试的助手和断言.

## 安装

```sh
npm install @drevops/bats-helpers
```

也可以使用：`pnpm add @drevops/bats-helpers`、`yarn add @drevops/bats-helpers`、`bun add @drevops/bats-helpers`

## README

[![BATS helpers logo](https://placehold.jp/000000/ffffff/200x200.png?text=BATS%20helpers&css=%7B%22border-radius%22%3A%22%20100px%22%7D)](https://bats-helpers.drevops.com/)

# BATS 帮助者

[![GitHub Issues](https://img.shields.io/github/issues/drevops/bats-helpers.svg)](https://github.com/drevops/bats-helpers/issues) [![GitHub Pull Requests](https://img.shields.io/github/issues-pr/drevops/bats-helpers.svg)](https://github.com/drevops/bats-helpers/pulls) [![Test shell](https://github.com/drevops/bats-helpers/actions/workflows/test-shell.yml/badge.svg)](https://github.com/drevops/bats-helpers/actions/workflows/test-shell.yml) [![codecov](https://codecov.io/gh/drevops/bats-helpers/graph/badge.svg?token=O0ZYROWCCK)](https://codecov.io/gh/drevops/bats-helpers) ![GitHub release (latest by date)](https://img.shields.io/github/v/release/drevops/bats-helpers) ![LICENSE](https://img.shields.io/github/license/drevops/bats-helpers) ![Renovate](https://img.shields.io/badge/renovate-enabled-green?logo=renovatebot)

* * *

助手和对 [贝斯](https://github.com/bats-core/bats-core) 测试.

## 目录

-   [特征](https://npmcn.com/package/%40drevops/bats-helpers/#readme--features)
-   [安装](https://npmcn.com/package/%40drevops/bats-helpers/#readme--installation)
-   [使用量](https://npmcn.com/package/%40drevops/bats-helpers/#readme--usage)
-   [文档](https://npmcn.com/package/%40drevops/bats-helpers/#readme--documentation)
-   [API 参考](https://npmcn.com/package/%40drevops/bats-helpers/#readme--api-reference)
-   [捐款](https://npmcn.com/package/%40drevops/bats-helpers/#readme--contributing)

## \* 特性

-   请求命令输出,其单个行,退出状态,标准出错,字符串,文件,目录和git寄存器.
-   字形,正则表达式和格式相匹配,以大小写灵敏度为明确选择.
-   命令用每个调用输出,退出状态和副作用来嘲弄,以及用相匹配的参数选择的响应.
-   每一个被嘲弄的呼叫的指令记录, 声称为序列, 并报告为统一指令.
-   模拟预期,当它们没有被利用时,或者当一个意外的呼叫到来时,没有通过测试.
-   一个选入的沙盒模式,其中名称拒绝一个未嵌入的命令,其中包含一个必须运行为真实的命令的允许列表,以及一份离开模拟边界的一切报告.
-   步跑的顺序 被嘲笑的呼叫和输出断言.
-   在创建它去掉的东西的代码旁边注册了被推迟的清理.
-   重试任何同步的, 以尝试计数、 延迟和可选的最后期限为界限 .
-   在许多测试案例上运行一种功能的数据提供者,包括指定案例、每个案例的可分性、选定的断言和矩阵扩展.
-   用于建造和恢复测试沙盒的固定和备案设施.
-   一个纯文本档案,用于在测试中宣布一个完整的固定文件树的内线,将一个目录串回到它,并且用每个文件的diffs对它主张一个目录.
-   TUI帮助驾驶带有脚本解答的交互式脚本,以最后期限为界并断言反对被打印的脚本的提示.

## \* 安装

要求数 [蝙蝠分数](https://github.com/bats-core/bats-core) `1.13` 或更新,和巴什 `4.0` 或更新。 巴什号舰 `3.2`,所以安装一个当前 `brew install bash`。 。 。 .

### 国家预防机制

```shell
npm install -D bats-helpers@npm:@drevops/bats-helpers
```

这也将安装 `bats-core`。 。 。 .

### 从源

1.  点击 `Code` - > (中文) `Download ZIP` 输入 [GitHub 用户界面](https://github.com/drevops/bats-helpers)。 。 。 .
2.  提取文件到想要的位置 。 通常,在什么地方旁边 `bats-core` 已经定位.

## 使用量

创建一个 `_loader.bash` 包含内容的 BATS 测试旁边的文件 :

```bash
# For NPM installation:
export BATS_LIB_PATH="${BATS_TEST_DIRNAME}/../node_modules"

# For source installation:
# export BATS_LIB_PATH="<path/to/extracted/files>"

bats_load_library bats-helpers
```

然后使用 `load _loader.bash` 每个 BATS 测试文件中 :

```bats
#!/usr/bin/env bats
load _loader.bash

@test "My test" {
 run ls
 assert_success
}
```

## 页:1

每个页面都记录一个库模块,并列出模块所读取的变量,以及它们改变的行为。 匹配模式是一个例外, 描述每个断言的家庭份额。 这个 [API 参考](https://npmcn.com/package/%40drevops/bats-helpers/#readme--api-reference) 下面将每个公共功能链接到文件的页面.

| 页次 | 来源 | 封面 |
| --- | --- | --- |
| [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md) | [`src/assert.command.bash`](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 命令运行中的输出、退出状态和标准错误 `run` |
| [直线断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md) | [`src/assert.line.bash`](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 按指数、任何行和计数分列的捕获流的个别行数 |
| [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md) | [`src/assert.string.bash`](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 平庸的弦, 和断言背后的弦工具 |
| [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md) | [`src/assert.file.bash`](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 文件、目录和符号链接 |
| [Git 断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-git.md) | [`src/assert.git.bash`](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.git.bash) | Git 寄存器和它们跟踪的文件 |
| [匹配模式](https://npmcn.com/package/%40drevops/bats-helpers/docs/match-modes.md) | [`src/assert.string.bash`](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 针是怎样读取的,以及病例是否重要 |
| [报告失败](https://npmcn.com/package/%40drevops/bats-helpers/docs/failure-reporting.md) | [`src/assert.base.bash`](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.base.bash) | 每一次失败报告的形状, 以及如何提出一个 |
| [嘲笑](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md) | [`src/mock.bash`](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 命令嘲笑、呼叫日志、参数规格、严格性和沙盒模式 |
| [步长跑](https://npmcn.com/package/%40drevops/bats-helpers/docs/steps.md) | [`src/steps.bash`](https://npmcn.com/package/%40drevops/bats-helpers/src/steps.bash) | 被嘲笑的电话和产出断言的序列 |
| [数据提供者](https://npmcn.com/package/%40drevops/bats-helpers/docs/dataprovider.md) | [`src/dataprovider.bash`](https://npmcn.com/package/%40drevops/bats-helpers/src/dataprovider.bash) | 在许多测试案件中运行一个功能 |
| [交互式脚本](https://npmcn.com/package/%40drevops/bats-helpers/docs/tui.md) | [`src/tui.bash`](https://npmcn.com/package/%40drevops/bats-helpers/src/tui.bash) | 驾驶一个提问的脚本 |
| [重试](https://npmcn.com/package/%40drevops/bats-helpers/docs/retry.md) | [`src/retry.bash`](https://npmcn.com/package/%40drevops/bats-helpers/src/retry.bash) | 不久就变成现实的条件 |
| [清理](https://npmcn.com/package/%40drevops/bats-helpers/docs/cleanup.md) | [`src/cleanup.bash`](https://npmcn.com/package/%40drevops/bats-helpers/src/cleanup.bash) | 推迟的每次测试清理 |
| [固定设备](https://npmcn.com/package/%40drevops/bats-helpers/docs/fixtures.md) | [`src/fixture.bash`](https://npmcn.com/package/%40drevops/bats-helpers/src/fixture.bash) | 建筑、倾倒和主张文件树 |
| [文件公用事业](https://npmcn.com/package/%40drevops/bats-helpers/docs/files.md) | [`src/file.bash`](https://npmcn.com/package/%40drevops/bats-helpers/src/file.bash) | 创建、裁剪、备份和恢复文件 |

## API 参考

每个公共功能,定义它的文件,以及文档的页面. 其名字从下划线开始的功能是内部的,不属于公共API的一部分,可能在任何发布时不经通知而改变或消失.

| 函数 | 来源 | 说明 | 文档 |
| --- | --- | --- | --- |
| `flunk` | [(原始内容存档于2018-07-21). profile.base.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.base.bash) | 信息、堆栈追踪和稳定路径的测试失败 | [报告失败](https://npmcn.com/package/%40drevops/bats-helpers/docs/failure-reporting.md#failure-reporting) |
| `format_error` | [(原始内容存档于2018-07-21). profile.base.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.base.bash) | 将失败报告格式化为对齐行的标题块 | [报告失败](https://npmcn.com/package/%40drevops/bats-helpers/docs/failure-reporting.md#failure-reporting) |
| `assert_empty` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串为空 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_not_empty` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串不是空的 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_equal` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定两个字符串是相等的 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_contains` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串包含子字符串 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_contains_case` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串包含子字符串, 对大小写敏感 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_not_contains` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串不包含子字符串 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_not_contains_case` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串不包含子字符串, 区分大小写 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_starts_with` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串以子字符串开头 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_starts_with_case` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确认字符串以子字符串开头,对大小写敏感 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_not_starts_with` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串不是以子字符串开头 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_not_starts_with_case` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串不以子字符串开头, 区分大小写 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_ends_with` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串以子字符串结尾 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_ends_with_case` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串以子字符串结尾, 区分大小写 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_not_ends_with` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串不会以子字符串结尾 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_not_ends_with_case` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串不会以子字符串结尾, 区分大小写 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_matches` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串匹配正则表达式 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_matches_case` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串匹配正则表达式, 区分大小写 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_not_matches` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串不匹配正则表达式 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_not_matches_case` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串不匹配正则表达式, 区分大小写 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_matches_format` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串匹配格式字符串 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_matches_format_case` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串匹配格式字符串, 区分大小写 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_not_matches_format` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串与格式字符串不符 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `assert_string_not_matches_format_case` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 确定字符串不匹配格式字符串,对大小写敏感 | [字符串断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#assertions) |
| `string_match` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 报告针头是否与干草堆相匹配,而不断言 | [串接公用事业](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#string-utilities) |
| `string_format_to_regex` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 将格式字符串翻译为扩展正则表达式 | [串接公用事业](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#string-utilities) |
| `string_random` | [维护. string.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.string.bash) | 生成一个随机的字母数字字符串, 8 个字符默认长 | [串接公用事业](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-string.md#string-utilities) |
| `assert_success` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 认定命令成功 | [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#output) |
| `assert_failure` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确认命令失败 | [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#output) |
| `assert_output` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确定命令输出精确的字符串 | [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#output) |
| `assert_output_contains` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 显示输出包含子字符串 | [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#output) |
| `assert_output_contains_case` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 显示输出包含一个子字符串, 区分大小写 | [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#output) |
| `assert_output_not_contains` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 表示输出不包含子字符串 | [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#output) |
| `assert_output_not_contains_case` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 显示输出不包含子字符串, 区分大小写 | [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#output) |
| `assert_output_matches` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 显示输出匹配正则表达式 | [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#output) |
| `assert_output_matches_case` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 显示输出匹配正则表达式, 区分大小写 | [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#output) |
| `assert_output_not_matches` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 显示输出不匹配正则表达式 | [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#output) |
| `assert_output_not_matches_case` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 显示输出不匹配正则表达式, 区分大小写 | [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#output) |
| `assert_output_matches_format` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 显示输出匹配格式字符串 | [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#output) |
| `assert_output_matches_format_case` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 显示输出匹配格式字符串, 区分大小写 | [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#output) |
| `assert_output_not_matches_format` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 显示输出不符合格式字符串 | [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#output) |
| `assert_output_not_matches_format_case` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 显示输出不匹配格式字符串, 区分大小写 | [命令断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#output) |
| `assert_status` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确定命令退出时有确切状态 | [退出状态](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#exit-statuses) |
| `assert_failure_status` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确定一个命令在精确状态下失败 | [退出状态](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#exit-statuses) |
| `assert_status_general_error` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确认命令退出状态 `1` | [退出状态](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#exit-statuses) |
| `assert_status_command_not_found` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确认命令退出状态 `127` | [退出状态](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#exit-statuses) |
| `assert_stderr` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确定命令会给 STDERR 写精确的字符串 | [标准错误](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#standard-error) |
| `assert_stderr_empty` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确认一个命令没有写给 STDERR | [标准错误](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#standard-error) |
| `assert_stderr_captured` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确定STDERR与输出分开捕获 | [标准错误](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#standard-error) |
| `assert_stderr_contains` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确定 STDERR 包含下字符串 | [标准错误](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#standard-error) |
| `assert_stderr_contains_case` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确定 STDERR 包含一个子字符串, 区分大小写 | [标准错误](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#standard-error) |
| `assert_stderr_not_contains` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确定 STDERR 不包含子字符串 | [标准错误](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#standard-error) |
| `assert_stderr_not_contains_case` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确定 STDERR 不包含子字符串, 对大小写敏感 | [标准错误](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#standard-error) |
| `assert_stderr_matches` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确定 STDERR 匹配正则表达式 | [标准错误](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#standard-error) |
| `assert_stderr_matches_case` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确定 STDERR 匹配正则表达式, 区分大小写 | [标准错误](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#standard-error) |
| `assert_stderr_not_matches` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 认定 STDERR 不匹配正则表达式 | [标准错误](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#standard-error) |
| `assert_stderr_not_matches_case` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 认定 STDERR 不匹配正则表达式, 区分大小写 | [标准错误](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#standard-error) |
| `assert_stderr_matches_format` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确定 STDERR 匹配格式字符串 | [标准错误](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#standard-error) |
| `assert_stderr_matches_format_case` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确定 STDERR 匹配格式字符串, 区分大小写 | [标准错误](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#standard-error) |
| `assert_stderr_not_matches_format` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确定 STDERR 不匹配格式字符串 | [标准错误](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#standard-error) |
| `assert_stderr_not_matches_format_case` | [维护。命令。bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.command.bash) | 确定 STDERR 不匹配格式字符串, 区分大小写 | [标准错误](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-command.md#standard-error) |
| `assert_line` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定索引中的行等于字符串 | [直线断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#by-index) |
| `assert_line_not` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定索引中的行不等于字符串 | [直线断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#by-index) |
| `assert_line_contains` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定索引中的行包含字符串 | [直线断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#by-index) |
| `assert_line_contains_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定索引中的行包含对大小写敏感的字符串 | [直线断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#by-index) |
| `assert_line_not_contains` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定索引中的行不包含字符串 | [直线断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#by-index) |
| `assert_line_not_contains_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定索引中的行不包含字符串, 区分大小写 | [直线断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#by-index) |
| `assert_line_matches` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定索引中的行匹配正则表达式 | [直线断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#by-index) |
| `assert_line_matches_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定索引中的行匹配正则表达式, 区分大小写 | [直线断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#by-index) |
| `assert_line_not_matches` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定索引中的行与正则表达式不符 | [直线断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#by-index) |
| `assert_line_not_matches_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定索引中的行不匹配正则表达式, 区分大小写 | [直线断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#by-index) |
| `assert_line_matches_format` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定索引中的行匹配格式字符串 | [直线断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#by-index) |
| `assert_line_matches_format_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定索引中的行匹配格式字符串,对大小写敏感 | [直线断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#by-index) |
| `assert_line_not_matches_format` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定索引中的行与格式字符串不符 | [直线断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#by-index) |
| `assert_line_not_matches_format_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定索引中的行不匹配格式字符串, 区分大小写 | [直线断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#by-index) |
| `assert_any_line` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定某些行等于字符串 | [任意行](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#any-line) |
| `assert_no_line` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定无行等于字符串 | [任意行](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#any-line) |
| `assert_any_line_contains` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定某些行包含字符串 | [任意行](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#any-line) |
| `assert_any_line_contains_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定某些行包含字符串, 区分大小写 | [任意行](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#any-line) |
| `assert_no_line_contains` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定无行包含字符串 | [任意行](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#any-line) |
| `assert_no_line_contains_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定没有行包含字符串, 区分大小写 | [任意行](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#any-line) |
| `assert_any_line_matches` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定一些行匹配正则表达式 | [任意行](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#any-line) |
| `assert_any_line_matches_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定一些行匹配正则表达式, 区分大小写 | [任意行](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#any-line) |
| `assert_no_line_matches` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定没有匹配正则表达式的行 | [任意行](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#any-line) |
| `assert_no_line_matches_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定无行匹配正则表达式, 区分大小写 | [任意行](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#any-line) |
| `assert_any_line_matches_format` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定一些行匹配格式字符串 | [任意行](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#any-line) |
| `assert_any_line_matches_format_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定一些行匹配格式字符串, 区分大小写 | [任意行](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#any-line) |
| `assert_no_line_matches_format` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定没有匹配格式字符串的行 | [任意行](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#any-line) |
| `assert_no_line_matches_format_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定没有匹配格式字符串的行, 区分大小写 | [任意行](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#any-line) |
| `assert_line_count` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定行数 | [计数](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#counts) |
| `assert_line_count_not` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确认行数不同 | [计数](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#counts) |
| `assert_line_count_contains` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 显示有多少行包含字符串 | [计数](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#counts) |
| `assert_line_count_contains_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 显示有多少行包含字符串, 区分大小写 | [计数](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#counts) |
| `assert_line_count_not_contains` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定有多少行不包含字符串 | [计数](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#counts) |
| `assert_line_count_not_contains_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定有多少行不包含字符串, 区分大小写 | [计数](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#counts) |
| `assert_line_count_matches` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定多少行匹配正则表达式 | [计数](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#counts) |
| `assert_line_count_matches_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定多少行匹配正则表达式, 区分大小写 | [计数](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#counts) |
| `assert_line_count_not_matches` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定有多少行不匹配正则表达式 | [计数](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#counts) |
| `assert_line_count_not_matches_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 显示有多少行不匹配正则表达式, 区分大小写 | [计数](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#counts) |
| `assert_line_count_matches_format` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 显示与格式字符串相匹配的行数 | [计数](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#counts) |
| `assert_line_count_matches_format_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 指定多少行匹配格式字符串, 区分大小写 | [计数](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#counts) |
| `assert_line_count_not_matches_format` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定有多少行不匹配格式字符串 | [计数](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#counts) |
| `assert_line_count_not_matches_format_case` | [主张. line.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.line.bash) | 确定多少行不匹配格式字符串, 区分大小写 | [计数](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-line.md#counts) |
| `assert_file_exists` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定文件存在 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_file_not_exists` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定文件不存在 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_file_contains` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定文件包含字符串 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_file_contains_case` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定文件包含字符串, 区分大小写 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_file_not_contains` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定文件不包含字符串 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_file_not_contains_case` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定文件不包含字符串, 区分大小写 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_file_matches` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定文件匹配正则表达式 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_file_matches_case` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定一个文件匹配正则表达式, 区分大小写 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_file_not_matches` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定文件与正则表达式不符 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_file_not_matches_case` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定文件不匹配正则表达式, 区分大小写 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_file_matches_format` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定文件匹配格式字符串 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_file_matches_format_case` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定一个文件匹配格式字符串, 区分大小写 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_file_not_matches_format` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定文件不符合格式字符串 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_file_not_matches_format_case` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定文件不匹配格式字符串, 区分大小写 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_files_equal` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定两个文件相等 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#comparing-files) |
| `assert_files_equal_ignore_spaces` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定两个文件是平等的, 忽略空白行和空白更改 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#comparing-files) |
| `assert_files_not_equal` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定两个文件不相等 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#comparing-files) |
| `assert_files_not_equal_ignore_spaces` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定两个文件不相等, 忽略空白行和空白更改 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#comparing-files) |
| `assert_binary_files_equal` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定两个二进制文件是相等的 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_binary_files_not_equal` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定两个二进制文件不相等 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_file_mode` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 选择文件权限模式 | [文件断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#files) |
| `assert_dir_exists` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确认目录存在 | [目录和符号链接](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#directories-and-symlinks) |
| `assert_dir_not_exists` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确认目录不存在 | [目录和符号链接](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#directories-and-symlinks) |
| `assert_dir_empty` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定目录为空 | [目录和符号链接](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#directories-and-symlinks) |
| `assert_dir_not_empty` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定目录不是空的 | [目录和符号链接](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#directories-and-symlinks) |
| `assert_dir_contains_string` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定目录在其文件中包含字符串 | [搜索目录](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#searching-a-directory) |
| `assert_dir_contains_string_case` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确认一个目录在其一个文件中包含字符串, 区分大小写 | [搜索目录](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#searching-a-directory) |
| `assert_dir_not_contains_string` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定目录在其任何文件中不包含字符串 | [搜索目录](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#searching-a-directory) |
| `assert_dir_not_contains_string_case` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确认一个目录在其任何文件中都不包含字符串,对大小写敏感 | [搜索目录](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#searching-a-directory) |
| `assert_dir_matches` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定目录的文件匹配正则表达式 | [搜索目录](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#searching-a-directory) |
| `assert_dir_matches_case` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定目录文件匹配正则表达式, 区分大小写 | [搜索目录](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#searching-a-directory) |
| `assert_dir_not_matches` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定目录文件与正则表达式不匹配 | [搜索目录](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#searching-a-directory) |
| `assert_dir_not_matches_case` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定目录中没有任何文件匹配正则表达式, 区分大小写 | [搜索目录](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#searching-a-directory) |
| `assert_dirs_equal` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定两个目录是平等的 | [目录和符号链接](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#directories-and-symlinks) |
| `assert_symlink_exists` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 确定存在象征性联系 | [目录和符号链接](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#directories-and-symlinks) |
| `assert_symlink_not_exists` | [profile.file.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.file.bash) | 认定不存在象征性联系 | [目录和符号链接](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-file.md#directories-and-symlinks) |
| `assert_git_repo` | [profile.git.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.git.bash) | 确定目录是 git 仓库 | [Git 断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-git.md#git-assertions) |
| `assert_git_not_repo` | [profile.git.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.git.bash) | 确定目录不是 git 仓库 | [Git 断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-git.md#git-assertions) |
| `assert_git_clean` | [profile.git.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.git.bash) | 确定 git 仓库是干净的 | [Git 断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-git.md#git-assertions) |
| `assert_git_not_clean` | [profile.git.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.git.bash) | 确认 git 仓库不干净 | [Git 断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-git.md#git-assertions) |
| `assert_git_file_tracked` | [profile.git.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.git.bash) | 确认文件以 git 跟踪 | [Git 断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-git.md#git-assertions) |
| `assert_git_file_not_tracked` | [profile.git.bash (英语)](https://npmcn.com/package/%40drevops/bats-helpers/src/assert.git.bash) | 确定文件没有用 git 跟踪 | [Git 断言](https://npmcn.com/package/%40drevops/bats-helpers/docs/assertions-git.md#git-assertions) |
| `cleanup_register` | [清理. bash](https://npmcn.com/package/%40drevops/bats-helpers/src/cleanup.bash) | 在当前测试完成后注册运行的命令 | [清理](https://npmcn.com/package/%40drevops/bats-helpers/docs/cleanup.md#cleanup) |
| `cleanup_run` | [清理. bash](https://npmcn.com/package/%40drevops/bats-helpers/src/cleanup.bash) | 按倒序运行已注册命令。 呼叫从 `teardown()` | [清理](https://npmcn.com/package/%40drevops/bats-helpers/docs/cleanup.md#composing-with-your-teardown) |
| `cleanup_registry_path` | [清理. bash](https://npmcn.com/package/%40drevops/bats-helpers/src/cleanup.bash) | 解析存储在 | [清理沙盒](https://npmcn.com/package/%40drevops/bats-helpers/docs/cleanup.md#cleanup-sandbox) |
| `retry_run` | [重试. bash](https://npmcn.com/package/%40drevops/bats-helpers/src/retry.bash) | 运行一个命令直至它成功或达到约束 | [重试](https://npmcn.com/package/%40drevops/bats-helpers/docs/retry.md#retry) |
| `file_mktouch` | [文件.bash 存档](https://npmcn.com/package/%40drevops/bats-helpers/src/file.bash) | 创建文件和任何缺少的父目录 | [文件公用事业](https://npmcn.com/package/%40drevops/bats-helpers/docs/files.md#file-utilities) |
| `file_trim` | [文件.bash 存档](https://npmcn.com/package/%40drevops/bats-helpers/src/file.bash) | 删除文件的最后一行 | [文件公用事业](https://npmcn.com/package/%40drevops/bats-helpers/docs/files.md#file-utilities) |
| `file_read_env` | [文件.bash 存档](https://npmcn.com/package/%40drevops/bats-helpers/src/file.bash) | 用来自 `./.env` 范围中的文件 | [文件公用事业](https://npmcn.com/package/%40drevops/bats-helpers/docs/files.md#file-utilities) |
| `file_backup_path` | [文件.bash 存档](https://npmcn.com/package/%40drevops/bats-helpers/src/file.bash) | 确定文件的备份位置 | [文件备份](https://npmcn.com/package/%40drevops/bats-helpers/docs/files.md#file-backups) |
| `file_add_var` | [文件.bash 存档](https://npmcn.com/package/%40drevops/bats-helpers/src/file.bash) | 在文件中添加一个可变任务, 首先支持文件 | [文件备份](https://npmcn.com/package/%40drevops/bats-helpers/docs/files.md#file-backups) |
| `file_restore` | [文件.bash 存档](https://npmcn.com/package/%40drevops/bats-helpers/src/file.bash) | 从备份中恢复一个文件 `file_add_var` | [文件备份](https://npmcn.com/package/%40drevops/bats-helpers/docs/files.md#file-backups) |
| `fixture_prepare_dir` | [(原始内容存档于2018-09-21) (英语). petture.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/fixture.bash) | 为固定创建空目录, 删除任何已存在的内容 | [固定设备](https://npmcn.com/package/%40drevops/bats-helpers/docs/fixtures.md#fixtures) |
| `fixture_export_codebase` | [(原始内容存档于2018-09-21) (英语). petture.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/fixture.bash) | 将代码库导出至最晚的目的地目录 | [固定设备](https://npmcn.com/package/%40drevops/bats-helpers/docs/fixtures.md#fixtures) |
| `fixture_create_dir` | [(原始内容存档于2018-09-21) (英语). petture.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/fixture.bash) | 从 STDIN 读取的归档创建文件树 | [固定树](https://npmcn.com/package/%40drevops/bats-helpers/docs/fixtures.md#fixture-trees) |
| `fixture_dump_dir` | [(原始内容存档于2018-09-21) (英语). petture.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/fixture.bash) | 打印目录为归档 | [固定树](https://npmcn.com/package/%40drevops/bats-helpers/docs/fixtures.md#fixture-trees) |
| `fixture_assert_dir` | [(原始内容存档于2018-09-21) (英语). petture.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/fixture.bash) | 确定目录持有从 STDIN 读取的归档文件树 | [固定树](https://npmcn.com/package/%40drevops/bats-helpers/docs/fixtures.md#fixture-trees) |
| `dataprovider_run` | [数据提供者.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/dataprovider.bash) | 运行在 `TEST_CASES` 数组 | [平面阵列](https://npmcn.com/package/%40drevops/bats-helpers/docs/dataprovider.md#flat-array) |
| `dataprovider_run_cases` | [数据提供者.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/dataprovider.bash) | 运行函数所声明的大小写 | [已宣布的案件](https://npmcn.com/package/%40drevops/bats-helpers/docs/dataprovider.md#declared-cases) |
| `dataprovider_case` | [数据提供者.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/dataprovider.bash) | 宣布并管理一个案件 | [已宣布的案件](https://npmcn.com/package/%40drevops/bats-helpers/docs/dataprovider.md#declared-cases) |
| `dataprovider_matrix` | [数据提供者.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/dataprovider.bash) | 将数值列表扩展为笛卡尔产品 | [矩阵](https://npmcn.com/package/%40drevops/bats-helpers/docs/dataprovider.md#matrix) |
| `mock_setup` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 设相取笑. 呼叫从 `setup()` | [设置函数](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#setup-functions) |
| `mock_create` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 创建可跟踪的模拟程序 | [设置函数](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#setup-functions) |
| `mock_command` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 隐藏提供的命令 | [设置函数](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#setup-functions) |
| `mock_set_output` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 设置模拟器的输出 | [设置函数](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#setup-functions) |
| `mock_set_status` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 设置模拟器的退出状态 | [设置函数](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#setup-functions) |
| `mock_set_side_effect` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 设定模拟执行时要运行的 shell 代码 | [设置函数](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#setup-functions) |
| `mock_set_strict` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 拒绝模拟者的期望没有涵盖的呼叫 | [严格性](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#strictness) |
| `mock_set_forward` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 运行呼叫的真实命令 | [参数规格](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#argument-specifications) |
| `mock_spec_add` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 在模拟中添加参数规格 | [参数规格](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#argument-specifications) |
| `mock_spec_arg` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 限制规格的一个参数位置 | [参数规格](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#argument-specifications) |
| `mock_spec_count` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 选择规格接受的参数数 | [参数规格](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#argument-specifications) |
| `mock_spec_set_output` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 设置一个规格响应的输出 | [参数规格](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#argument-specifications) |
| `mock_spec_set_status` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 设置退出状态 | [参数规格](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#argument-specifications) |
| `mock_spec_set_side_effect` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 设定 shell 代码为规格运行 | [参数规格](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#argument-specifications) |
| `mock_log_exclude` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 从序列比较中排除命令 | [调用日志](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#call-log) |
| `mock_log_print` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 按顺序返回每个有记录的呼叫 | [调用日志](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#call-log) |
| `mock_get_call_num` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 返回模拟器被调用的次数 | [占星函数](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#assertion-functions) |
| `mock_get_call_args` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 返回调用模拟的参数 | [占星函数](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#assertion-functions) |
| `mock_get_call_user` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 返回调用模拟器的用户 | [占星函数](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#assertion-functions) |
| `mock_get_call_env` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 从模拟调用返回环境变量值 | [占星函数](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#assertion-functions) |
| `mock_assert_call_args` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 说明模拟的论据 | [占星函数](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#assertion-functions) |
| `mock_assert_calls` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 确定每个被嘲笑的呼叫的顺序 | [调用日志](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#call-log) |
| `mock_assert_no_calls` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 宣称在被排除在外的命令之外没有被嘲弄的命令 | [调用日志](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#call-log) |
| `mock_assert_called` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 确认命令被称作 | [调用日志](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#call-log) |
| `mock_assert_not_called` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 表示未调用命令 | [调用日志](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#call-log) |
| `mock_verify` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 确信每一个期望都得到满足 | [严格性](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#strictness) |
| `mock_sandbox_enable` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 启用沙盒模式 。 允许列表的参数种子 | [沙盒模式](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#sandbox-mode) |
| `mock_sandbox_allow` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 允许命令运行为真实 | [沙盒模式](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#allowing-a-command-to-run-for-real) |
| `mock_sandbox_disable` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 恢复 `PATH` 启用模式时保存 | [沙盒模式](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#sandbox-mode) |
| `mock_sandbox_enabled` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 报告是否启用了沙盒模式 | [沙盒模式](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#sandbox-mode) |
| `mock_sandbox_report` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 打印已拒绝的命令和已逃脱的命令 | [逃出来的是什么](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#what-escaped) |
| `mock_path_check` | [模拟.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/mock.bash) | 警告时 `PATH` 更改于 `mock_setup` | [重写 PATH 时](https://npmcn.com/package/%40drevops/bats-helpers/docs/mocking.md#when-path-is-rewritten) |
| `steps_run` | [步骤.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/steps.bash) | 运行 `setup` 或 `assert` 阶段 `STEPS` 数组 | [步长跑](https://npmcn.com/package/%40drevops/bats-helpers/docs/steps.md#step-runner) |
| `tui_run` | [tu.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/tui.bash) | 运行名为 `SCRIPT_FILE`在STDIN上输入答案 | [交互式脚本](https://npmcn.com/package/%40drevops/bats-helpers/docs/tui.md#interactive-scripts) |
| `tui_assert_prompts` | [tu.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/tui.bash) | 显示提示的出现顺序, 忽略大小写 | [即时命令](https://npmcn.com/package/%40drevops/bats-helpers/docs/tui.md#prompt-order) |
| `tui_assert_prompts_case` | [tu.bash](https://npmcn.com/package/%40drevops/bats-helpers/src/tui.bash) | 显示提示的出现顺序, 区分大小写 | [即时命令](https://npmcn.com/package/%40drevops/bats-helpers/docs/tui.md#prompt-order) |

## 捐款

见 [`CONTRIBUTING.md`](https://npmcn.com/package/%40drevops/bats-helpers/CONTRIBUTING.md) 用于本地开发设置,起伏和测试命令,以及释放程序.

* * *

_此寄存器是使用 [脚手架](https://getscaffold.dev/) 项目模板_

## 常见问题

### @drevops/bats-helpers 是什么？

BATS测试的助手和断言\.

### 如何安装 @drevops/bats-helpers？

在项目目录运行 npm install @drevops/bats-helpers，或使用 pnpm add / yarn add / bun add。

### @drevops/bats-helpers 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/drevops\_\_bats-helpers 是否存在。

### @drevops/bats-helpers 可以商用吗？

@drevops/bats-helpers 使用 GPL-3\.0-or-later 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以 GPL-3\.0 兼容许可开源，并附带专利与反锁定条款。仅内部使用不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。

### @drevops/bats-helpers 的下载量有多少？

根据 npm 官方下载统计，@drevops/bats-helpers 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,509 次，日均约 84 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @drevops/bats-helpers 还在维护吗？

最新版本 2\.0\.0 发布于 2026/08/06（3 个月前）；至今共发布 12 个版本，其中过去 12 个月发布了 3 个；首次发布于 2023/03/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。