Improve misc readability & context in test scripts

.dockerignore

@@ -1,4 +1,4 @@
-# only used for bat-test.dockerfile
+# only used for tests/docker/bat-test.dockerfile
 
 *
 !/syntaxes/

tests/docker/bat-test.dockerfile

@@ -1,4 +1,4 @@
-# usage: through highlight_regression.sh and theme_regression.sh
+# usage: through tests/highlight_regression.sh and tests/theme_regression.sh
 
 FROM curlimages/curl:latest AS fetch-pkg
 LABEL keep=false

tests/docker/syntest.dockerfile

@@ -1,4 +1,4 @@
-# usage: use syntax.py, don't run this manually
+# usage: use tests/syntax.py, don't run this manually
 
 FROM rust:1.59 as build
 LABEL keep=false

tests/highlight_regression.sh

@@ -9,6 +9,7 @@ docker build --quiet -f docker/bat-test.dockerfile -t bat-test ..
 
 vol1="$PWD"/source:/tests/source:ro
 vol2="$PWD"/highlighted:/tests/highlighted
+
 docker run --rm \
     -v "$vol1" -v "$vol2" \
     bat-test

tests/syntax.py

@@ -10,9 +10,9 @@
 
 dockerfile_path = 'docker/syntest.dockerfile'
 image_tag = 'syntest'
-tests_path = '/tests/syntax'
+tests_dir = '/tests/syntax'
 syntaxes_path = '/syntaxes'
-volumes = f'-v="$PWD/syntax":{tests_path} -v="$PWD/../syntaxes":{syntaxes_path}'
+volumes = f'-v="$PWD/syntax":{tests_dir} -v="$PWD/../syntaxes":{syntaxes_path}'
 
 ### cli
 
@@ -42,11 +42,12 @@
     stderr=subprocess.DEVNULL
 )
 if ret != 0: # image doesn't exist
-    print("\033[34m" + "Image not available, building syntest from source..." + "\033[00m")
+    print("\033[34m" + "Docker image not available, building syntest from source..." + "\033[00m")
     subprocess.call(
         f"docker build -t {image_tag} - < {dockerfile_path}",
         shell=True
     )
+    print("\033[34m" + "Docker build ends here." + "\033[00m")
 
 man_syntax_path = Path('../syntaxes/Manpage.sublime-syntax')
 if not man_syntax_path.is_file():
@@ -58,7 +59,7 @@
 
 ### arrange arguments
 
-args = f"{script_args.test_path or tests_path} {syntaxes_path}"
+args = f"{script_args.test_path or tests_dir} {syntaxes_path}"
 if script_args.debug:
     args += " --debug"
 if script_args.summary:

tests/theme_regression.sh

@@ -9,6 +9,7 @@ docker build --quiet -f docker/bat-test.dockerfile -t bat-test ..
 
 vol1="$PWD"/source:/tests/source:ro
 vol2="$PWD"/theme:/tests/theme
+
 docker run --rm \
     -v "$vol1" -v "$vol2" \
     --entrypoint /tests/run_theme_regression.sh \