mmgen-wallet/test/test-release.sh

#!/usr/bin/env bash
#
# MMGen Wallet, a terminal-based cryptocurrency wallet
# Copyright (C)2013-2025 The MMGen Project <mmgen@tuta.io>
# Licensed under the GNU General Public License, Version 3:
#   https://www.gnu.org/licenses
# Public project repositories:
#   https://github.com/mmgen/mmgen-wallet
#   https://gitlab.com/mmgen/mmgen-wallet

# Tested on Linux, Armbian, Raspbian, MSYS2

# cfg.sh must implement:
#   list_avail_tests()
#   init_groups()
#   init_tests()
. 'test/test-release.d/cfg.sh'

run_test() {
	set +x
	local tests="t_$1" skips="t_$1_skip" continue_on_error="e_$1" have_error=

	while read skip test; do
		[ "$test" ] || continue
		echo "${!skips}" | grep -q $skip && continue

		if [ "$LIST_CMDS" ]; then
			echo $test
		else
			test_disp=$YELLOW${test/\#/$RESET$MAGENTA\#}$RESET
			if [ "${test:0:1}" == '#' ]; then
				echo -e "$test_disp"
			else
				echo -e "${GREEN}Running:$RESET $test_disp"
				eval "$test" || {
					echo -e $RED"test-release.sh: test '$CUR_TEST' failed at command '$test'"$RESET
					have_error=1
					[ "${!continue_on_error}" ] || exit 1
				}
			fi
		fi
	done <<<${!tests}
	if [ "$have_error" ]; then { echo -e "$RED${!continue_on_error}$RESET"; exit 1; }; fi
}

prompt_skip() {
	echo -n "Enter 's' to skip, or ENTER to continue: "; read -n1; echo
	[ "$REPLY" == 's' ] && return 0
	return 1
}

list_avail_tests() {
	echo   "AVAILABLE TESTS:"
	init_tests
	for i in $all_tests; do
		z="d_$i"
		printf "   %-8s - %s\n" $i "${!z}"
	done
	echo
	echo   "AVAILABLE TEST GROUPS:"
	while read a b c; do
		[ "$a" ] && printf "   %-8s - %s\n" $a "$c"
	done <<<$groups_desc
	echo
	echo   "By default, all tests are run"
}

run_tests() {
	[ "$LIST_CMDS" ] || echo "Running tests: $1"
	for t in $1; do
		desc_id="d_$t" desc=${!desc_id}
		if [ "$SKIP_ALT_DEP" ]; then
			ok=$(for a in $noalt_tests $noalt_ok_tests; do if [ $t == $a ]; then echo 'ok'; fi; done)
			if [ ! "$ok" ]; then
				echo -e "${BLUE}Skipping altcoin test '$t'$RESET"
				continue
			fi
		fi
		if [ "$LIST_CMDS" ]; then
			echo -e "\n### $t: $desc"
		else
			echo -e "\n${BLUE}Testing:$RESET $GREEN$desc$RESET"
		fi
		[ "$PAUSE" ] && prompt_skip && continue
		CUR_TEST=$t
		run_test $t
		[ "$LIST_CMDS" ] || echo -e "${BLUE}Finished testing:$RESET $GREEN$desc$RESET"
	done
}

check_tests() {
	for i in $tests; do
		echo "$dfl_tests $extra_tests" | grep -q "\<$i\>" || {
			echo "$i: unrecognized argument"
			exit 1
		}
	done
}

remove_skipped_tests() {
	tests=$(for t in $tests; do
		[ "$(for s in $SKIP_LIST; do [ $t == $s ] && echo y; done)" ] && continue
		echo $t
	done)
	tests=$(echo $tests)
}

list_group_symbols() {
	echo -e "Default tests:\n  $dfl_tests"
	echo -e "Extra tests:\n  $extra_tests"
	echo -e "'noalt' test group:\n  $noalt_tests"
	echo -e "'quick' test group:\n  $quick_tests"
	echo -e "'qskip' test group:\n  $qskip_tests"
}

print_ver_hash() {
	python3 -m pip freeze | grep "^$repo\>" | sed 's/.*sha256=//' | cut -c 1-12
}

do_typescript() {
	if [ "$DARWIN" ]; then script "$1" $2; else script -O "$1" -c "$2"; fi
}

install_package() {
	echo -e "${BLUE}Installing package$YELLOW $repo$RESET"
	rm -rf build dist *.egg-info

	ver=$(print_ver_hash)
	echo -e "${BLUE}Currently installed version is$MAGENTA $ver$RESET"

	cmd="python3 -m build --no-isolation --wheel --config-setting=quiet $STDOUT_DEVNULL"
	echo -e "${BLUE}Executing:$CYAN $cmd$RESET"
	eval $cmd

	cmd="python3 -m pip $QUIET install --break-system-packages dist/*.whl"
	echo -e "${BLUE}Executing:$CYAN $cmd$RESET"
	eval $cmd

	new_ver=$(print_ver_hash)
	if [ "$ver" == "$new_ver" ]; then
		echo -ne "${YELLOW}Version hash is unchanged. Force install? (y/N):$RESET "
		read -n1
		if [ "$REPLY" == 'y' ]; then
			echo
			cmd="python3 -m pip $QUIET install --break-system-packages --force --no-deps dist/*.whl"
			echo -e "${BLUE}Executing:$CYAN $cmd$RESET"
			eval $cmd
		elif [ "$REPLY" ]; then
			echo; return
		else
			return
		fi
	fi

	new_ver=$(print_ver_hash)
	if [ "$ver" == "$new_ver" ]; then
		echo -e "${RED}ERROR: version hash is unchanged$RESET"
		exit 1
	else
		echo -e "${GREEN}OK$RESET"
	fi
}

do_reexec() {
	[ -z "$exec_prog" ] && exec_prog="test/test-release.sh -X $ORIG_ARGS"

	if [ "$sdist_dir" ]; then
		target_dir=$sdist_dir
	elif [ "$clone_dir" ]; then
		target_dir="$orig_cwd/.clone-test"
		clone_dir=$target_dir
	else # TYPESCRIPT=1
		do_typescript "$orig_cwd/$typescript_file" "$exec_prog"
		return
	fi

	rm -rf $target_dir
	mkdir $target_dir

	if [ "$repo" != 'mmgen-wallet' ]; then
		echo -e "${BLUE}Cloning repo $MAGENTA'mmgen-wallet'$RESET ${BLUE}to $YELLOW$target_dir/mmgen-wallet$RESET"
		mkdir -p "$target_dir/mmgen-wallet"
		eval "git clone $orig_cwd/../mmgen-wallet $target_dir/mmgen-wallet $STDOUT_DEVNULL $STDERR_DEVNULL"
	fi

	if [ "$clone_dir" ]; then
		[ "$(git status --porcelain)" ] && VIM_GIT_COMMIT=1 git commit -a
		dest="$clone_dir/$repo"
		rm -rf $dest
		mkdir -p $dest
		echo -e "${BLUE}Cloning repo $MAGENTA'$repo'$BLUE to $YELLOW$dest$RESET"
		eval "git clone . $dest $STDOUT_DEVNULL $STDERR_DEVNULL"
		cd $dest
		echo -e "${BLUE}cd -> $YELLOW$PWD$RESET"
	fi

	if [ "$sdist_dir" ]; then
		rm -rf build dist *.egg-info
		echo -n 'Building sdist...'
		eval "python3 -m build --no-isolation --sdist --config-setting=quiet $STDOUT_DEVNULL"
		echo -e "done\n${BLUE}Unpacking sdist archive to $YELLOW$target_dir$RESET"
		tar -C $target_dir -zxf dist/*.tar.gz
		cd $target_dir/${repo//-/[-_]}-*
		echo -e "${BLUE}cd -> $YELLOW$PWD$RESET"
		if [ "$clone_dir" ]; then rm -rf $clone_dir; fi
	fi

	[ -e 'test/init.sh' ] && test/init.sh $VERBOSE_SHORTOPT

	echo -e "\n${BLUE}Executing test runner: ${CYAN}test/test-release $ORIG_ARGS$RESET\n"

	if [ "$TYPESCRIPT" ]; then
		do_typescript "$orig_cwd/$typescript_file" "$exec_prog"
	else
		eval $exec_prog
	fi
}

install_secp256k1_mod_maybe() {
	if [[ "$repo" =~ ^mmgen[-_]wallet ]]; then
		eval "python3 setup.py build_ext --inplace $STDOUT_DEVNULL"
	fi
}

in_nix_environment() {
	for path in ${PATH//:/ }; do
		realpath -q $path | grep -q '^/nix/store/' && break
	done
}

# start execution

set -e
set -o functrace
set -o errtrace

trap 'echo -e "${GREEN}Exiting at user request$RESET"; exit' INT

umask 0022

orig_cwd=$(pwd)
repo=$(basename $orig_cwd)

if [ "$(uname -m)" == 'armv7l' ]; then
	ARM32=1
elif [ "$(uname -m)" == 'aarch64' ]; then
	ARM64=1
elif [ "$(uname -s)" == 'Darwin' ]; then
	DARWIN=1
	DISTRO='DARWIN'
elif [ "$MSYSTEM" ] && uname -a | grep -qi 'msys'; then
	MSYS2=1
	DISTRO='MSYS2'
fi

[ "$ARM32" -o "$ARM64" ] && {
	PEXPECT_LONG_TIMEOUT=' --pexpect-timeout=300'
	HTTP_LONG_TIMEOUT='MMGEN_HTTP_TIMEOUT=300 '
}

if [ -e '/etc/os-release' ]; then
	DISTRO=$(grep '^ID=' '/etc/os-release' | cut -c 4-)
	[ "$DISTRO" ] || {
		echo 'Unable to determine distro from /etc/os-release. Aborting'
		exit 1
	}
fi

cmdtest_py='test/cmdtest.py -n'
objtest_py='test/objtest.py'
objattrtest_py='test/objattrtest.py'
modtest_py='test/modtest.py --names --quiet'
daemontest_py='test/daemontest.py --names --quiet'
tooltest_py='test/tooltest.py'
tooltest2_py='test/tooltest2.py --names --quiet'
gentest_py='test/gentest.py --quiet'
scrambletest_py='test/scrambletest.py'
altcoin_mod_opts='--quiet'
mmgen_tool='cmds/mmgen-tool'
pylint='PYTHONPATH=. pylint' # PYTHONPATH required by older Pythons (e.g. v3.9)
python='python3'
rounds=10
typescript_file='test-release.out'
STDOUT_DEVNULL='>/dev/null'
STDERR_DEVNULL='2>/dev/null'
QUIET='--quiet'

ORIG_ARGS=$@
PROGNAME=$(basename $0)

init_groups

while getopts hAbcCdDe:fFILlNOps:StTvVX OPT
do
	case "$OPT" in
	h)  printf "  %-16s Test MMGen release\n" "${PROGNAME}:"
		echo   "  USAGE:           $PROGNAME [options] [tests or test group]"
		echo   "  OPTIONS: -h      Print this help message"
		echo   "           -A      Skip tests requiring altcoin modules or daemons"
		echo   "           -b      Buffer keypresses for all invocations of 'test/cmdtest.py'"
		echo   "           -c      Run tests in coverage mode"
		echo   "           -C      Test from cloned repo (can be combined with -S)"
		echo   "           -d      Enable Python Development Mode"
		echo   "           -D      Run tests in deterministic mode"
		echo   "           -e PROG With -C, -S or -T, execute PROG instead of this script"
		echo   "           -f      Speed up the tests by using fewer rounds"
		echo   "           -F      Reduce rounds even further"
		echo   "           -I      Install the package"
		echo   "           -L      List available tests and test groups with description"
		echo   "           -l      List the test name symbols"
		echo   "           -N      Pass the --no-timings switch to test/cmdtest.py"
		echo   "           -O      Use pexpect.spawn rather than popen_spawn where applicable"
		echo   "           -p      Pause between tests"
		echo   "           -s LIST Skip tests in LIST (space-separated)"
		echo   "           -S      Build sdist distribution, unpack, and run test"
		echo   "           -t      Print the tests without running them"
		echo   "           -T      Record a typescript of the screen output in '$typescript_file'"
		echo   "           -v      Run test/cmdtest.py with '--exact-output' and other commands"
		echo   "                   with '--verbose' switch"
		echo   "           -V      Run test/cmdtest.py and other commands with '--verbose' switch"
		echo
		echo   "  For traceback output and error file support, set the EXEC_WRAPPER_TRACEBACK"
		echo   "  environment variable"
		exit ;;
	A)  SKIP_ALT_DEP=1
		cmdtest_py+=" --no-altcoin"
		modtest_py+=" --no-altcoin-deps"
		daemontest_py+=" --no-altcoin-deps"
		scrambletest_py+=" --no-altcoin"
		tooltest2_py+=" --no-altcoin" ;;
	b)  cmdtest_py+=" --buf-keypress" ;;
	c)  mkdir -p 'test/trace'
		touch 'test/trace.acc'
		cmdtest_py+=" --coverage"
		tooltest_py+=" --coverage"
		tooltest2_py+=" --fork --coverage"
		scrambletest_py+=" --coverage"
		python="python3 -m trace --count --file=test/trace.acc --coverdir=test/trace"
		modtest_py="$python $modtest_py"
		daemontest_py="$python $daemontest_py"
		objtest_py="$python $objtest_py"
		objattrtest_py="$python $objattrtest_py"
		gentest_py="$python $gentest_py"
		mmgen_tool="$python $mmgen_tool" ;&
	C)  REEXEC=1 clone_dir="$orig_cwd/.cloned-repo" ;;
	d)  export PYTHONDEVMODE=1
		export PYTHONWARNINGS='error' ;;
	D)  export MMGEN_TEST_SUITE_DETERMINISTIC=1
		export MMGEN_DISABLE_COLOR=1 ;;
	e)  exec_prog=$(realpath $OPTARG) ;;
	f)  rounds=6 FAST=1 fast_opt='--fast' modtest_py+=" --fast" daemontest_py+=" --fast" ;;
	F)  rounds=3 FAST=1 fast_opt='--fast' modtest_py+=" --fast" daemontest_py+=" --fast" ;;
	I)  INSTALL_PACKAGE=1 ;;
	L)  list_avail_tests; exit ;;
	l)  list_group_symbols; exit ;;
	N)  cmdtest_py+=" --no-timings" ;;
	O)  cmdtest_py+=" --pexpect-spawn" ;;
	p)  PAUSE=1 ;;
	s)  SKIP_LIST+=" $OPTARG" ;;
	S)  REEXEC=1 sdist_dir="$orig_cwd/.sdist-test" ;;
	t)  LIST_CMDS=1 ;;
	T)  REEXEC=1 TYPESCRIPT=1 ;;
	v)  EXACT_OUTPUT=1 cmdtest_py+=" --exact-output" ;&
	V)  VERBOSE='--verbose' VERBOSE_SHORTOPT='-v' QUIET=''
		[ "$EXACT_OUTPUT" ] || cmdtest_py+=" --verbose"
		STDOUT_DEVNULL='' STDERR_DEVNULL=''
		modtest_py="${modtest_py/--quiet/--verbose}"
		daemontest_py="${daemontest_py/--quiet/--verbose}"
		altcoin_mod_opts="${altcoin_mod_opts/--quiet/--verbose}"
		tooltest2_py="${tooltest2_py/--quiet/--verbose}"
		gentest_py="${gentest_py/--quiet/--verbose}"
		tooltest_py+=" --verbose"
		mmgen_tool+=" --verbose"
		objattrtest_py+=" --verbose"
		pylint+=" --verbose"
		scrambletest_py+=" --verbose" ;;
	X)  IN_REEXEC=1 ;;
	*)  exit ;;
	esac
done

in_nix_environment && parity --help >/dev/null 2>&1 || SKIP_PARITY=1

[ "$MMGEN_DISABLE_COLOR" -o ! -t 1 ] || {
	RED="\e[31;1m" GREEN="\e[32;1m" YELLOW="\e[33;1m" BLUE="\e[34;1m" MAGENTA="\e[35;1m" CYAN="\e[36;1m"
	RESET="\e[0m"
}

[ "$REEXEC" -a -z "$IN_REEXEC" ] && { do_reexec; exit; }

[ "$exec_prog" ] && { echo "option -e makes no sense without -C, -S, or -T" ; exit; }

[ "$INSTALL_PACKAGE" ] && { install_package; exit; }

[ "$MSYS2" -a ! "$FAST" ] && tooltest2_py+=' --fork'
[ "$EXACT_OUTPUT" -o "$VERBOSE" ] || objtest_py+=" -S"

shift $((OPTIND-1))

case $1 in
	'')        tests=$dfl_tests ;;
	'default') tests=$dfl_tests ;;
	'extra')   tests=$extra_tests ;;
	'noalt')   tests=$noalt_tests
				SKIP_ALT_DEP=1
				cmdtest_py+=" --no-altcoin"
				modtest_py+=" --no-altcoin-deps"
				daemontest_py+=" --no-altcoin-deps"
				scrambletest_py+=" --no-altcoin" ;;
	'quick')   tests=$quick_tests ;;
	'qskip')   tests=$qskip_tests ;;
	*)         tests="$*" ;;
esac

rounds_min=$((rounds / 2))
for n in 2 5 10 20 50 100 200 500 1000; do
	eval "rounds${n}x=$((rounds*n))"
done

init_tests

remove_skipped_tests

check_tests

test/clean.py

install_secp256k1_mod_maybe

start_time=$(date +%s)

run_tests "$tests"

elapsed=$(($(date +%s)-start_time))
elapsed_fmt=$(printf %02d:%02d $((elapsed/60)) $((elapsed%60)))

[ "$LIST_CMDS" ] || {
	if [ "$MMGEN_TEST_SUITE_DETERMINISTIC" ]; then
		echo -e "\n${GREEN}All OK"
	else
		echo -e "\n${GREEN}All OK.  Total elapsed time: $elapsed_fmt$RESET"
	fi
}