ci: fix ShellCheck linting for BATS tests (#3347)

* updated `lint.sh` to lint BATS (again)
* fix linting errors

test/tests/parallel/set1/spam_virus/amavis.bats

@@ -61,18 +61,22 @@ function teardown_file() {
   export CONTAINER_NAME=${CONTAINER1_NAME}
 
   local AMAVIS_DEFAULTS_FILE='/etc/amavis/conf.d/20-debian_defaults'
+  # shellcheck disable=SC2016
   _run_in_container grep '\$sa_tag_level_deflt' "${AMAVIS_DEFAULTS_FILE}"
   assert_success
   assert_output --partial '= 2.0'
 
+  # shellcheck disable=SC2016
   _run_in_container grep '\$sa_tag2_level_deflt' "${AMAVIS_DEFAULTS_FILE}"
   assert_success
   assert_output --partial '= 6.31'
 
+  # shellcheck disable=SC2016
   _run_in_container grep '\$sa_kill_level_deflt' "${AMAVIS_DEFAULTS_FILE}"
   assert_success
   assert_output --partial '= 10.0'
 
+  # shellcheck disable=SC2016
   _run_in_container grep '\$sa_spam_subject_tag' "${AMAVIS_DEFAULTS_FILE}"
   assert_success
   assert_output --partial "= '***SPAM*** ';"

test/tests/parallel/set1/spam_virus/postgrey_enabled.bats

@@ -132,5 +132,5 @@ function _should_have_log_entry() {
 
 # `lines` is a special BATS variable updated via `run`:
 function _should_output_number_of_lines() {
-  assert_equal "${#lines[@]}" $1
+  assert_equal "${#lines[@]}" "${1}"
 }

test/tests/parallel/set1/spam_virus/postscreen.bats

@@ -6,7 +6,7 @@ CONTAINER1_NAME='dms-test_postscreen_enforce'
 CONTAINER2_NAME='dms-test_postscreen_sender'
 
 function setup() {
-  CONTAINER1_IP=$(_get_container_ip ${CONTAINER1_NAME})
+  CONTAINER1_IP=$(_get_container_ip "${CONTAINER1_NAME}")
 }
 
 function setup_file() {
@@ -70,6 +70,7 @@ function _should_wait_turn_speaking_smtp() {
   local SMTP_TEMPLATE=$3
   local EXPECTED=$4
 
+  # shellcheck disable=SC2016
   local UGLY_WORKAROUND='exec 3<>/dev/tcp/'"${TARGET_CONTAINER_IP}"'/25 && \
     while IFS= read -r cmd; do \
       head -1 <&3; \

test/tests/parallel/set1/spam_virus/rspamd_dkim.bats

@@ -64,7 +64,7 @@ function teardown_file() { _default_teardown ; }
   assert_output --partial "Finished DKIM key creation"
   _run_in_container_bash "[[ -f ${SIGNING_CONF_FILE} ]]"
   assert_success
-  _exec_in_container_bash "echo "blabla" >${SIGNING_CONF_FILE}"
+  _exec_in_container_bash "echo 'blabla' >${SIGNING_CONF_FILE}"
   local INITIAL_SHA512_SUM=$(_exec_in_container sha512sum "${SIGNING_CONF_FILE}")
 
   __create_key

test/tests/parallel/set1/spam_virus/rspamd_full.bats

@@ -58,6 +58,7 @@ function setup_file() {
 function teardown_file() { _default_teardown ; }
 
 @test "Postfix's main.cf was adjusted" {
+  # shellcheck disable=SC2016
   _run_in_container grep -F 'smtpd_milters = $rspamd_milter' /etc/postfix/main.cf
   assert_success
   _run_in_container postconf rspamd_milter
@@ -171,6 +172,7 @@ function teardown_file() { _default_teardown ; }
   MODULE_PATH='/etc/rspamd/override.d/testmodule4.something'
   _run_in_container_bash "[[ -f ${MODULE_PATH} ]]"
   assert_success
+  # shellcheck disable=SC2016
   _run_in_container grep -F 'some very long line with "weird $charact"ers' "${MODULE_PATH}"
   assert_success
   _run_in_container grep -F 'and! ano. ther &line' "${MODULE_PATH}"

test/tests/parallel/set3/container_configuration/hostname.bats

@@ -193,6 +193,7 @@ function _should_be_configured_to_fqdn() {
   assert_success
 
   # Amavis
+  # shellcheck disable=SC2016
   _run_in_container grep '^\$myhostname' /etc/amavis/conf.d/05-node_id
   assert_output "\$myhostname = \"${EXPECTED_FQDN}\";"
   assert_success

test/tests/parallel/set3/container_configuration/process_check_restart.bats

@@ -179,12 +179,12 @@ function _should_restart_when_killed() {
 function _check_if_process_is_running() {
   local PROCESS=${1}
   local MIN_SECS_RUNNING
-  [[ -n ${2} ]] && MIN_SECS_RUNNING="--older ${2}"
+  [[ -n ${2:-} ]] && MIN_SECS_RUNNING=('--older' "${2}")
 
-  local IS_RUNNING=$(docker exec "${CONTAINER_NAME}" pgrep --list-full ${MIN_SECS_RUNNING} "${PROCESS}")
+  local IS_RUNNING=$(docker exec "${CONTAINER_NAME}" pgrep --list-full "${MIN_SECS_RUNNING[@]}" "${PROCESS}")
 
   # When no matches are found, nothing is returned. Provide something we can assert on (helpful for debugging):
-  if [[ ! ${IS_RUNNING} =~ "${PROCESS}" ]]
+  if [[ ! ${IS_RUNNING} =~ ${PROCESS} ]]
   then
     echo "'${PROCESS}' is not running"
     return 1

test/tests/parallel/set3/scripts/helper_functions.bats

@@ -4,6 +4,7 @@ BATS_TEST_NAME_PREFIX='[Scripts] (helper functions) '
 SOURCE_BASE_PATH="${REPOSITORY_ROOT:?Expected REPOSITORY_ROOT to be set}/target/scripts/helpers"
 
 @test '(network.sh) _sanitize_ipv4_to_subnet_cidr' {
+  # shellcheck source=../../../../../target/scripts/helpers/network.sh
   source "${SOURCE_BASE_PATH}/network.sh"
 
   run _sanitize_ipv4_to_subnet_cidr '255.255.255.255/0'
@@ -17,7 +18,9 @@ SOURCE_BASE_PATH="${REPOSITORY_ROOT:?Expected REPOSITORY_ROOT to be set}/target/
 }
 
 @test '(utils.sh) _env_var_expect_zero_or_one' {
+  # shellcheck source=../../../../../target/scripts/helpers/log.sh
   source "${SOURCE_BASE_PATH}/log.sh"
+  # shellcheck source=../../../../../target/scripts/helpers/utils.sh
   source "${SOURCE_BASE_PATH}/utils.sh"
 
   ZERO=0
@@ -40,7 +43,9 @@ SOURCE_BASE_PATH="${REPOSITORY_ROOT:?Expected REPOSITORY_ROOT to be set}/target/
 }
 
 @test '(utils.sh) _env_var_expect_integer' {
+  # shellcheck source=../../../../../target/scripts/helpers/log.sh
   source "${SOURCE_BASE_PATH}/log.sh"
+  # shellcheck source=../../../../../target/scripts/helpers/utils.sh
   source "${SOURCE_BASE_PATH}/utils.sh"
 
   INTEGER=1234

test/tests/serial/test_helper.bats

@@ -1,3 +1,5 @@
+# shellcheck disable=SC2314,SC2317
+
 load "${REPOSITORY_ROOT}/test/test_helper/common"
 
 BATS_TEST_NAME_PREFIX='test helper functions:'

test/tests/serial/tests.bats

@@ -164,6 +164,7 @@ function teardown_file() { _default_teardown ; }
 }
 
 @test "amavis: old virusmail is wipped by cron" {
+  # shellcheck disable=SC2016
   _exec_in_container_bash 'touch -d "`date --date=2000-01-01`" /var/lib/amavis/virusmails/should-be-deleted'
   _run_in_container_bash '/usr/local/bin/virus-wiper'
   assert_success
@@ -172,6 +173,7 @@ function teardown_file() { _default_teardown ; }
 }
 
 @test "amavis: recent virusmail is not wipped by cron" {
+  # shellcheck disable=SC2016
   _exec_in_container_bash 'touch -d "`date`"  /var/lib/amavis/virusmails/should-not-be-deleted'
   _run_in_container_bash '/usr/local/bin/virus-wiper'
   assert_success