The test file (*.test) from the theATL/atlsh/tests directory is mirrored to the theATL/tests directory via a soft link.
- The theATL test environment is created without changes to the atlsh distribution.
Massive parallel testing with the automake make check was implemented in the theATL/tests directory.
- An adaptation to the atltest tool and the *.test files was required.
The largest adaptation was made to the test cases (*.test) provided by TCL.
- By default, TCL only supports sequential testing.
- By default, TCL uses the same temporary file name across different test cases.

atltest

atltest is a wrapper around atltest and primarily serves to provide the correct environment from
the build and source directory, as well as an automake-specific adjustment that affects the sequence of test-option* and test-case.

#!/bin/bash
#+
#:   @file         NHI1/theATL/bin/atltest
#:   @brief        tag: nhi1-release-250425
#:   @copyright    (C) NHI - #1 - Project - Group
#:                 This software has NO permission to copy,
#:                 please contact AUTHOR for additional information
#:
 
# atltest ..
# 
# This script is used to run the "atltest" tool from the Makefile. 
# The environment must be configured so that "atltest" only has access 
# to the data from the "build" and "source" directory.
#
# example :
#
# 1. options last   > atltest FILE-PATTERN options..
# 2. options first  > atltest options.. FILE-PATTERN
 
abs_local_path="$(realpath -- "$0")" || exit 1
abs_local_dir="${abs_local_path%/*}"
abs_atlsh_dir="${abs_local_dir%/*}/atlsh"
 
# get "abs_top_builddir"
if [[ -f "${NHI1_abs_top_builddir:-NHI1_abs_top_builddir_UNKNOWN}/theATL/atlsh/unix/atlBuild.sh" ]] ; then
  # get it from the "NHI1" environment (only as subproject)
  abs_atlsh_builddir="${NHI1_abs_top_builddir}/theATL/atlsh"
elif [[ -f "$abs_atlsh_dir/unix/atlBuild.sh" ]] ; then
  # get it from "in-source" build
  abs_atlsh_builddir="$abs_atlsh_dir"
else
  echo "error: atlBuild.sh not found" 1>&2 ; exit 1
fi
 
# source build environment - setup with "configure"
# set: TCL_TOP_SOURCE_DIR TCL_TOP_BUILD_DIR LD_LIBRARY_PATH ATL_LIBPATH ATL_LIBRARY
source "$abs_atlsh_builddir/unix/atlBuild.sh"
 
# if "atltest" not already build → build it
if [[ ! -f "$TCL_TOP_BUILD_DIR/unix/atltest" ]] ; then
  make --directory "$TCL_TOP_BUILD_DIR/unix" atltest || exit 2
fi
 
#set -x
 
declare -i justone="$(( $# == 1 ))"
 
# validate arguments
while true ; do
  first="$(realpath -- "$1")"
  last="${@: -1}"
 
  # check if test script is first - called by user
  for a in $first ; do
    [[ ! -f "$a" ]] && break
    f="$first"
    d="${f%/*}"
    shift
    set -- -file "${f##*/}" -testdir "$d" -tmpdir "${d/$TCL_TOP_SOURCE_DIR/$TCL_TOP_BUILD_DIR}" "$@"
    if (( justone )) ; then
      : set -- "$@" -verbose bpt
    fi
    break 2
  done
    
  # check if test script is last - called by 'make check'
  for a in $last ; do
    [[ ! -f "$a" ]] && break
    f="$last"
    d="${f%/*}"
    set -- -file "${f##*/}" -testdir "$d" -tmpdir "${d/$TCL_TOP_SOURCE_DIR/$TCL_TOP_BUILD_DIR}" "${@:1:$(( $# - 1 ))}"
    break 2
  done
 
  echo "error: unable to find test script in '$*'" 1>&2 ; exit 3
 
done
 
#ldd "$TCL_TOP_BUILD_DIR/unix/atltest"
 
exec "$TCL_TOP_BUILD_DIR/unix/atltest" "$TCL_TOP_SOURCE_DIR/../tests/all.tcl" "$@"
 
# vim: path+=../tests

Makefile.am

automake file to configure the local directory

#+
#:   @file         NHI1/theATL/tests/Makefile.am
#:   @brief        tag: nhi1-release-250425
#:   @copyright    (C) NHI - #1 - Project - Group
#:                 This software has NO permission to copy,
#:                 please contact AUTHOR for additional information
#:
 
EXTRA_DIST = README_TESTS.md $(srcdir)/*.tcl $(srcdir)/*.test
 
# set "TEST_FILES" created by ".makefile_index.bash"
include .index.mk
 
TESTS = $(TEST_FILES)
 
debug:
        @echo TESTS=$(TESTS)
 
# README_TESTS.md
help:
        less $(srcdir)/README_TESTS.md
 
log:
        test -f $(builddir)/test-suite.log && less -S $(builddir)/test-suite.log || true
 
test:
        for t in $(TESTS); do \
          $(srcdir)/../bin/atltest "$(srcdir)/$$t" -verbose bpt $(TEST_LOG_FLAGS); \
        done
 
link:
        cd "$(srcdir)" && find . -type l -delete && ln -s ../atlsh/tests/*.test .
 
TEST_EXTENSIONS = .test
# using: ../bin/atltest
TEST_LOG_COMPILER = $(srcdir)/../bin/atltest
 
#! Attention: to add your own FLAGS use "TEST_LOG_FLAGS"
# NO test on parallel "make check" - Some tests simply do not work in parallel mode.
AM_TEST_LOG_FLAGS = -constraints parallel -verbose e
 
# BEGIN-MAKEFILE-INDEX
index-local:
        cd "$(srcdir)" && bash ./.makefile_index.bash
# END-MAKEFILE-INDEX

atlBuild.sh

The goal of atlBuild.sh is the same as for atlConfig.sh except that atlBuild.sh only configures the build environment - using only paths from the build directory or the source directory.

# atlBuild.sh --
#
# This shell script (for sh) is automatically generated by the Tcl configuration script. 
# It creates shell variables for use within the TCL build environment.
# This script is intended for use by Tcl tools so they don't have to figure everything 
# out themselves.
#
# The information in this file refers to a specific platform.
 
# Tcl's version number.
TCL_VERSION='@TCL_VERSION@'
TCL_MAJOR_VERSION='@TCL_MAJOR_VERSION@'
TCL_MINOR_VERSION='@TCL_MINOR_VERSION@'
TCL_PATCH_LEVEL='@TCL_PATCH_LEVEL@'
 
# Must be absolute to so the corresponding atltest's tcl_library is absolute.
TCL_TOP_SOURCE_DIR='@TCL_REAL_SOURCE_DIR@'
TCL_TOP_BUILD_DIR='@TCL_REAL_BUILD_DIR@'
 
# Resetting the LIB_RUNTIME_DIR below is required so that the generated
# atltest executable gets the build directory burned into its ld search path.
# This keeps atltest from picking up an already installed version of the Tcl
# library.
export @LD_LIBRARY_PATH_VAR@='@abs_builddir@:${@LD_LIBRARY_PATH_VAR@}'
export ATL_LIBPATH='@abs_builddir@/pkgs'
export ATL_LIBRARY='@TCL_SRC_DIR@/library'

additional information

README_TESTS

Table of Contents

atltest

Makefile.am

atlBuild.sh

additional information