编写Bible

往Bible增加代码.

代码必须仅仅使用 bash 内建函数或功能.
- 如果代码执行不能始终正常工作，强烈建议增加失败回调以允许程序正常回退到外部程序.
- 失败回调距离: ${HOSTNAME:-$(hostname)}
如果可能的话，将代码封装在函数中.
- 这样做可以方便测试程序的编写.
- 这将同样方便 shellcheck 正确的扫描检测.
- 另外一个好处是展示一个工作用例.
编写一些用例.
- 显示一些输入和输出.

在函数上标记 sh 表示可以被扫描和单元测试.

```sh
# Shellcheck 将会扫描分析，测试脚本将会获取到这个函数.
func() {
    # Usage: func "arg"
    :
}
```

在代码上标记 shell 表示这段代码将被忽略.

```shell
# Shorter file creation syntax.
:>file
```

测试单元举例说明:

test_upper() {
    result="$(upper "HeLlO")"
    assert_equals "$result" "HELLO"
}

步骤:

编写测试脚本.
- 名字命名为 test_func_name
- 将函数输出存储在变量中 ($result or ${result[@]}).
- 调用 assert_equals 测试变量和预期输出之间的相等性。
测试脚本将自动执行它. 👍

运行 test.sh 的同时也将在代码上执行shellcheck.

cd pure-bash-bible
./test.sh