forked from bonsai/harakit
61 lines
2.4 KiB
Plaintext
61 lines
2.4 KiB
Plaintext
|
The testing suite contains two main trees (plus translations for strings used in
|
|||
|
|
the shell scripts): the Bonsai tree and the POSIX tree:
|
|||
|
|
|
|||
|
|
.
|
|||
|
|
├── bonsai
|
|||
|
|
│ ├── test_env
|
|||
|
|
│ ├── dj.sh
|
|||
|
|
│ ├── false.sh
|
|||
|
|
│ ├── fop.sh
|
|||
|
|
│ ├── hru.sh
|
|||
|
|
│ ├── intcmp.sh
|
|||
|
|
│ ├── mm.sh
|
|||
|
|
│ ├── strcmp.sh
|
|||
|
|
│ └── true.sh
|
|||
|
|
├── locales
|
|||
|
|
│ ├── en_US.UTF-8
|
|||
|
|
│ └── tok
|
|||
|
|
├── posix
|
|||
|
|
│ ├── bin
|
|||
|
|
│ │ ├── cat
|
|||
|
|
│ │ ├── false
|
|||
|
|
│ │ └── true
|
|||
|
|
│ └── posix_env
|
|||
|
|
├── README
|
|||
|
|
└── test.sh
|
|||
|
|
|
|||
|
|
The Bonsai tree tests the functionality of Harakit utilities for regressions and
|
|||
|
|
other issues relating to compliance to our standards of practice.
|
|||
|
|
|
|||
|
|
The POSIX tree tests the use of Harakit utilities in place of the standard usage
|
|||
|
|
of POSIX utilities. These scripts test the ability of Harakit to comply to POSIX
|
|||
|
|
standards using its native utilities in shell scripts as a compatibility shim.
|
|||
|
|
Each shell script in the top directory should contain a set of tests for each
|
|||
|
|
POSIX utility and be named for that utility. The bin directory should contain
|
|||
|
|
a set of shim scripts which will be imported into the path as POSIX utilities.
|
|||
|
|
Each test will compare the behavior of the shim script to the real utility on
|
|||
|
|
the system.
|
|||
|
|
|
|||
|
|
Currently, due to the limitations of POSIX shell quoting, a subset of argument
|
|||
|
|
parsing is supported: arguments containing characters from POSIX’s Portable
|
|||
|
|
Filename Character Set [0].
|
|||
|
|
|
|||
|
|
The bonsai/test_env and posix/posix_env files contain prerequisite shared
|
|||
|
|
environments for each of the tests. These scripts both contain lines which set
|
|||
|
|
the shell to write all commands run in them (-x) and to fail if any command
|
|||
|
|
fails (-e). See set(1p) for more information.
|
|||
|
|
|
|||
|
|
Both sets of tests also inherit the environment set by the test.sh script, which
|
|||
|
|
sets the $BIN environment variable to the bin directory at the root of the
|
|||
|
|
project for easy and idiomatic access to the built Harakit binaries. When
|
|||
|
|
calling the POSIX test scripts, test.sh also sets the variable $realutil to be
|
|||
|
|
the absolute path to the currently tested utility’s counterpart on the system.
|
|||
|
|
|
|||
|
|
[0] <https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html#tag_03_282>
|
|||
|
|
|
|||
|
|
--
|
|||
|
|
Copyright © 2024 Emma Tebibyte <emma@tebibyte.media>
|
|||
|
|
|
|||
|
|
This work is licensed under CC BY-SA 4.0. To view a copy of this license, visit
|
|||
|
|
<http://creativecommons.org/licenses/by-sa/4.0/>.
|