如何在BATS测试脚本中回显文件名并解决语法错误？

这个问题我之前也碰到过，核心原因是BATS的内置环境变量初始化时机的限制，我来给你拆解下解决方案：

为什么你的代码会报错？ #

你直接在脚本顶层写echo $BATS_TEST_FILENAME会触发语法错误，因为BATS的特殊环境变量（比如$BATS_TEST_FILENAME）只有在测试函数（@test块）或者BATS提供的文件级钩子函数中才会被正确初始化。顶层代码执行时，这些变量还未被设置，所以会出现"operand expected"的错误。

正确的实现方式（无需修改测试名） #

BATS提供了两个文件级的钩子函数，专门用来处理整个测试文件的前置/后置操作，完美匹配你的需求：

方案1：在测试文件的所有测试开始前输出文件名 #

使用setup_file钩子，它会在当前测试文件的所有测试用例执行前仅运行一次：

#!/usr/bin/env bats
load test_helper

# 在当前测试文件的所有测试启动前执行
setup_file() {
  # 用basename只提取文件名，若需要完整路径直接用$BATS_TEST_FILENAME即可
  echo "---- TEST NAME IS $(basename "$BATS_TEST_FILENAME")"
}

@test "run cloned mission" {
  # 你的测试逻辑示例
  true
}

@test "addition using bc" {
  # 你的测试逻辑示例
  result=$(echo "2+3" | bc)
  [ "$result" -eq 5 ]
}

方案2：在测试文件的所有测试完成后输出文件名 #

如果希望在测试组结尾显示文件名，改用teardown_file钩子，它会在当前测试文件的所有测试用例执行完成后仅运行一次：

#!/usr/bin/env bats
load test_helper

# 在当前测试文件的所有测试完成后执行
teardown_file() {
  echo "---- TEST NAME IS $(basename "$BATS_TEST_FILENAME")"
}

@test "run cloned mission" {
  true
}

@test "addition using bc" {
  result=$(echo "2+3" | bc)
  [ "$result" -eq 5 ]
}

运行效果 #

当你执行多个BATS测试文件时，每个文件的测试用例块会按你期望的格式输出：

---- TEST NAME IS test_clone.bats
✓ run cloned mission
✓ addition using bc
---- TEST NAME IS test_addition.bats
✓ run cloned mission
✓ addition using bc

完全不需要修改任何测试用例的名称，就能实现不同测试文件间的文件名标识。

内容的提问来源于stack exchange，提问作者Nir Tal