exa/xtests/help.toml

[[cmd]]
name = "‘exa --help’ produces the correct help text"
shell = "exa --help"
stdout = { file = "outputs/help.ansitxt" }
stderr = { empty = true }
status = 0
tags = [ 'help ']
-												Use Specsheet for the extended tests

This commit changes the way the extended test suite is run.

Previously, there was a folder full of outputs, and a script that ran exa repeatedly to check the outputs match. This script was hacked-together, with many problems:

• It stops at the first failure, so if one test fails, you have no idea how many actually failed.
• It also didn't actually show you the diff if one was different, it just checked it.
• It combined stdout and stderr, and didn't test the exit status of exa.
• All the output file names were just whatever I felt like calling the file at the time.
• There is no way to only run a few of the tests — you have to run the whole thing each time.
• There's no feel-good overall view where you see how many tests are passing.

I started writing Specsheet to solve this problem (amongst other problems), and now, three and a half years later, it's finally ready for prime time.

The tests are now defined as data rather than as a script. The outputs have a consistent naming convention (directory_flags.ansitxt), and they check stdout, stderr, and exit status separately. Specsheet also lets simple outputs (empty, non-empty, or one-line error messages) can be written inline rather than needing to be in files.

So even though this pretty much runs the same tests as the run.sh script did, the tests are now more organised, making it easy to see where tests are missing and functionality is not being tested.

											
										
										
											2020-10-17 19:39:44 +00:00
+								[[cmd]]
 								name = "‘exa --help’ produces the correct help text"
 								shell = "exa --help"
 								stdout = { file = "outputs/help.ansitxt" }
 								stderr = { empty = true }
 								status = 0
 								tags = [ 'help ']