Commit | Line | Data |
---|---|---|
644e0364 | 1 | #!/bin/bash |
644e0364 | 2 | # |
0235b0db | 3 | # SPDX-License-Identifier: GPL-2.0-only |
644e0364 | 4 | # |
0235b0db | 5 | # Copyright (c) 2019 Michael Jeanson <mjeanson@efficios.com> |
07ff3b19 | 6 | # Copyright (C) 2019-2023 Philippe Proulx <pproulx@efficios.com> |
644e0364 | 7 | |
07ff3b19 PP |
8 | # Source this file at the beginning of a shell script test to access |
9 | # useful testing variables and functions: | |
10 | # | |
11 | # SH_TAP=1 | |
12 | # | |
13 | # if [[ -n ${BT_TESTS_SRCDIR:-} ]]; then | |
14 | # UTILSSH=$BT_TESTS_SRCDIR/utils/utils.sh | |
15 | # else | |
16 | # UTILSSH=$(dirname "$0")/../utils/utils.sh | |
17 | # fi | |
18 | # | |
19 | # # shellcheck source=../utils/utils.sh | |
20 | # source "$UTILSSH" | |
21 | # | |
22 | # Make sure the relative path to `utils.sh` (this file) above is | |
23 | # correct (twice). | |
644e0364 | 24 | |
07ff3b19 | 25 | # An unbound variable is an error |
644e0364 MJ |
26 | set -u |
27 | ||
07ff3b19 PP |
28 | # Name of the OS on which we're running, if not set. |
29 | # | |
30 | # One of: | |
31 | # | |
32 | # `mingw`: MinGW (Windows) | |
33 | # `darwin`: macOS | |
34 | # `linux`: Linux | |
35 | # `cygwin`: Cygwin (Windows) | |
36 | # `unsupported`: Anything else | |
37 | # | |
38 | # See <https://en.wikipedia.org/wiki/Uname#Examples> for possible values | |
39 | # of `uname -s`. | |
40 | # | |
41 | # Do some translation to ease our life down the road for comparison. | |
42 | # Export it so that executed commands can use it. | |
75e396f6 | 43 | if [ -z "${BT_TESTS_OS_TYPE:-}" ]; then |
a0baab4a SM |
44 | BT_TESTS_OS_TYPE="$(uname -s)" |
45 | case "$BT_TESTS_OS_TYPE" in | |
5058d31b | 46 | MINGW*) |
a0baab4a | 47 | BT_TESTS_OS_TYPE="mingw" |
5058d31b JR |
48 | ;; |
49 | Darwin) | |
a0baab4a | 50 | BT_TESTS_OS_TYPE="darwin" |
5058d31b JR |
51 | ;; |
52 | Linux) | |
a0baab4a | 53 | BT_TESTS_OS_TYPE="linux" |
5058d31b | 54 | ;; |
df9db467 | 55 | CYGWIN*) |
a0baab4a | 56 | BT_TESTS_OS_TYPE="cygwin" |
df9db467 | 57 | ;; |
5058d31b | 58 | *) |
a0baab4a | 59 | BT_TESTS_OS_TYPE="unsupported" |
5058d31b JR |
60 | ;; |
61 | esac | |
62 | fi | |
a0baab4a | 63 | export BT_TESTS_OS_TYPE |
5058d31b | 64 | |
7030f9fe PP |
65 | # Sets and exports, if not set: |
66 | # | |
67 | # • `BT_TESTS_SRCDIR` to the base source directory of tests. | |
68 | # • `BT_TESTS_BUILDDIR` to the base build directory of tests. | |
69 | _set_vars_srcdir_builddir() { | |
70 | # If `readlink -f` is available, then get a resolved absolute path | |
71 | # to the tests source directory. Otherwise, make do with a relative | |
72 | # path. | |
73 | local -r scriptdir="$(dirname "${BASH_SOURCE[0]}")" | |
74 | local testsdir | |
644e0364 | 75 | |
7030f9fe PP |
76 | if readlink -f "." >/dev/null 2>&1; then |
77 | testsdir=$(readlink -f "$scriptdir/..") | |
78 | else | |
79 | testsdir="$scriptdir/.." | |
80 | fi | |
81 | ||
82 | # Base source directory of tests | |
83 | if [ -z "${BT_TESTS_SRCDIR:-}" ]; then | |
84 | BT_TESTS_SRCDIR="$testsdir" | |
85 | fi | |
86 | export BT_TESTS_SRCDIR | |
87 | ||
88 | # Base build directory of tests | |
89 | if [ -z "${BT_TESTS_BUILDDIR:-}" ]; then | |
90 | BT_TESTS_BUILDDIR="$testsdir" | |
91 | fi | |
92 | export BT_TESTS_BUILDDIR | |
93 | } | |
644e0364 | 94 | |
7030f9fe PP |
95 | _set_vars_srcdir_builddir |
96 | unset -f _set_vars_srcdir_builddir | |
e46cbefe | 97 | |
07ff3b19 | 98 | # Source the generated environment file if it's present |
e46cbefe | 99 | if [ -f "${BT_TESTS_BUILDDIR}/utils/env.sh" ]; then |
05ffcfc0 | 100 | # shellcheck disable=SC1091 |
e46cbefe | 101 | . "${BT_TESTS_BUILDDIR}/utils/env.sh" |
644e0364 MJ |
102 | fi |
103 | ||
07ff3b19 | 104 | # Path to the `babeltrace2` command, if not set |
75e396f6 | 105 | if [ -z "${BT_TESTS_BT2_BIN:-}" ]; then |
4881a20e | 106 | BT_TESTS_BT2_BIN="$BT_TESTS_BUILDDIR/../src/cli/babeltrace2" |
a0baab4a | 107 | if [ "$BT_TESTS_OS_TYPE" = "mingw" ]; then |
27e2c58d JR |
108 | BT_TESTS_BT2_BIN="${BT_TESTS_BT2_BIN}.exe" |
109 | fi | |
644e0364 MJ |
110 | fi |
111 | export BT_TESTS_BT2_BIN | |
112 | ||
07ff3b19 PP |
113 | # This doesn't need to be exported, but it needs to remain set for |
114 | # run_python_bt2() to use it. | |
115 | # | |
116 | # TODO: Remove when `tests/bindings/python/bt2/test_plugin.py` is fixed. | |
644e0364 MJ |
117 | BT_PLUGINS_PATH="${BT_TESTS_BUILDDIR}/../src/plugins" |
118 | ||
07ff3b19 | 119 | # Colon-separated list of project plugin paths, if not set |
75e396f6 | 120 | if [ -z "${BT_TESTS_BABELTRACE_PLUGIN_PATH:-}" ]; then |
e8cafc6e | 121 | BT_TESTS_BABELTRACE_PLUGIN_PATH="${BT_PLUGINS_PATH}/ctf:${BT_PLUGINS_PATH}/utils:${BT_PLUGINS_PATH}/text:${BT_PLUGINS_PATH}/lttng-utils" |
644e0364 | 122 | fi |
e46cbefe | 123 | export BT_TESTS_BABELTRACE_PLUGIN_PATH |
644e0364 | 124 | |
07ff3b19 | 125 | # Directory containing the Python plugin provider library, if not set |
75e396f6 | 126 | if [ -z "${BT_TESTS_PROVIDER_DIR:-}" ]; then |
b14c7bf1 MJ |
127 | BT_TESTS_PROVIDER_DIR="${BT_TESTS_BUILDDIR}/../src/python-plugin-provider/.libs" |
128 | fi | |
e46cbefe | 129 | export BT_TESTS_PROVIDER_DIR |
b14c7bf1 | 130 | |
07ff3b19 | 131 | # Directory containing the built `bt2` Python package, if not set |
75e396f6 | 132 | if [ -z "${BT_TESTS_PYTHONPATH:-}" ]; then |
644e0364 MJ |
133 | BT_TESTS_PYTHONPATH="${BT_TESTS_BUILDDIR}/../src/bindings/python/bt2/build/build_lib" |
134 | fi | |
e46cbefe | 135 | export BT_TESTS_PYTHONPATH |
644e0364 | 136 | |
07ff3b19 | 137 | # Name of the `awk` command to use when testing, if not set |
75e396f6 | 138 | if [ -z "${BT_TESTS_AWK_BIN:-}" ]; then |
644e0364 MJ |
139 | BT_TESTS_AWK_BIN="awk" |
140 | fi | |
141 | export BT_TESTS_AWK_BIN | |
142 | ||
07ff3b19 | 143 | # Name of the `grep` command to use when testing, if not set |
75e396f6 | 144 | if [ -z "${BT_TESTS_GREP_BIN:-}" ]; then |
644e0364 MJ |
145 | BT_TESTS_GREP_BIN="grep" |
146 | fi | |
147 | export BT_TESTS_GREP_BIN | |
148 | ||
07ff3b19 | 149 | # Name of the `python3` command to use when testing, if not set |
75e396f6 | 150 | if [ -z "${BT_TESTS_PYTHON_BIN:-}" ]; then |
644e0364 MJ |
151 | BT_TESTS_PYTHON_BIN="python3" |
152 | fi | |
153 | export BT_TESTS_PYTHON_BIN | |
154 | ||
07ff3b19 PP |
155 | # Major and minor version of the `python3` command to use when testing. |
156 | # | |
157 | # This doesn't need to be exported, but it needs to remain set for | |
158 | # run_python() to use it. | |
7747a39f PP |
159 | BT_TESTS_PYTHON_VERSION=$($BT_TESTS_PYTHON_BIN -c 'import sys; print("{}.{}".format(sys.version_info.major, sys.version_info.minor))') |
160 | ||
07ff3b19 | 161 | # Name of the `python3-config` command to use when testing, if not set |
75e396f6 | 162 | if [ -z "${BT_TESTS_PYTHON_CONFIG_BIN:-}" ]; then |
e23e08c4 MJ |
163 | BT_TESTS_PYTHON_CONFIG_BIN="python3-config" |
164 | fi | |
242ddcb7 | 165 | export BT_TESTS_PYTHON_CONFIG_BIN |
e23e08c4 | 166 | |
07ff3b19 | 167 | # Name of the `sed` command to use when testing, if not set |
75e396f6 | 168 | if [ -z "${BT_TESTS_SED_BIN:-}" ]; then |
644e0364 MJ |
169 | BT_TESTS_SED_BIN="sed" |
170 | fi | |
171 | export BT_TESTS_SED_BIN | |
172 | ||
07ff3b19 | 173 | # Name of the `cc` command to use when testing, if not set |
75e396f6 | 174 | if [ -z "${BT_TESTS_CC_BIN:-}" ]; then |
0b0893d4 SM |
175 | BT_TESTS_CC_BIN="cc" |
176 | fi | |
177 | export BT_TESTS_CC_BIN | |
178 | ||
07ff3b19 | 179 | # Whether or not to enable AddressSanitizer, `0` (disabled) if not set. |
75e396f6 | 180 | if [ -z "${BT_TESTS_ENABLE_ASAN:-}" ]; then |
0b0893d4 SM |
181 | BT_TESTS_ENABLE_ASAN="0" |
182 | fi | |
183 | export BT_TESTS_ENABLE_ASAN | |
184 | ||
07ff3b19 | 185 | # Directory containing test data |
644e0364 | 186 | BT_TESTS_DATADIR="${BT_TESTS_SRCDIR}/data" |
07ff3b19 PP |
187 | |
188 | # Directory containing test CTF traces | |
644e0364 | 189 | BT_CTF_TRACES_PATH="${BT_TESTS_DATADIR}/ctf-traces" |
644e0364 | 190 | |
07ff3b19 | 191 | # Source the shell TAP utilities if `SH_TAP` is `1` |
75e396f6 | 192 | if [ "${SH_TAP:-}" = 1 ]; then |
e46cbefe MJ |
193 | # shellcheck source=./tap/tap.sh |
194 | . "${BT_TESTS_SRCDIR}/utils/tap/tap.sh" | |
195 | fi | |
196 | ||
07ff3b19 PP |
197 | # Removes the CR characters from the file having the path `$1`. |
198 | # | |
199 | # This is sometimes needed on Windows with text files. | |
200 | # | |
201 | # We can't use the `--string-trailing-cr` option of `diff` because | |
202 | # Solaris doesn't have it. | |
90a8a0f2 | 203 | bt_remove_cr() { |
717a01a7 | 204 | "$BT_TESTS_SED_BIN" -i'' -e 's/\r//g' "$1" |
90a8a0f2 SM |
205 | } |
206 | ||
07ff3b19 | 207 | # Prints `$1` without CR characters. |
10ba5f69 | 208 | bt_remove_cr_inline() { |
07ff3b19 | 209 | "$BT_TESTS_SED_BIN" 's/\r//g' "$1" |
10ba5f69 OD |
210 | } |
211 | ||
07ff3b19 PP |
212 | # Runs the `$BT_TESTS_BT2_BIN` command within an environment which can |
213 | # import the `bt2` Python package, redirecting the standard output to | |
214 | # the `$1` file and the standard error to the `$2` file. | |
22703f66 | 215 | # |
07ff3b19 PP |
216 | # The remaining arguments are forwarded to the `$BT_TESTS_BT2_BIN` |
217 | # command. | |
22703f66 | 218 | # |
07ff3b19 | 219 | # Returns the exit status of the executed `$BT_TESTS_BT2_BIN`. |
22703f66 SM |
220 | bt_cli() { |
221 | local stdout_file="$1" | |
222 | local stderr_file="$2" | |
223 | shift 2 | |
224 | local args=("$@") | |
225 | ||
ea458b95 | 226 | echo "Running: $BT_TESTS_BT2_BIN ${args[*]}" >&2 |
22703f66 SM |
227 | run_python_bt2 "$BT_TESTS_BT2_BIN" "${args[@]}" 1>"$stdout_file" 2>"$stderr_file" |
228 | } | |
644e0364 | 229 | |
07ff3b19 | 230 | # Checks the differences between: |
ff89ed28 | 231 | # |
07ff3b19 | 232 | # • The (expected) contents of the file having the path `$1`. |
ff89ed28 | 233 | # |
07ff3b19 | 234 | # • The contents of another file having the path `$2`. |
ff89ed28 | 235 | # |
07ff3b19 PP |
236 | # Both files are passed through bt_remove_cr_inline() to remove CR |
237 | # characters. | |
238 | # | |
239 | # Returns 0 if there's no difference, or not zero otherwise. | |
ff89ed28 | 240 | bt_diff() { |
a70b6702 SM |
241 | local expected_file="$1" |
242 | local actual_file="$2" | |
ff89ed28 | 243 | local ret=0 |
ff89ed28 | 244 | |
10ba5f69 | 245 | diff -u <(bt_remove_cr_inline "$expected_file") <(bt_remove_cr_inline "$actual_file") 1>&2 |
ff89ed28 | 246 | |
ea458b95 | 247 | return $? |
ff89ed28 MJ |
248 | } |
249 | ||
58db335e FD |
250 | # Checks the difference between: |
251 | # | |
07ff3b19 PP |
252 | # • What the `$BT_TESTS_BT2_BIN` command prints to its standard output |
253 | # when given the third and following arguments of this function. | |
254 | # | |
255 | # • The file having the path `$1`. | |
256 | # | |
257 | # as well as the difference between: | |
58db335e | 258 | # |
07ff3b19 PP |
259 | # • What the `$BT_TESTS_BT2_BIN` command prints to its standard error |
260 | # when given the third and following arguments of this function. | |
58db335e | 261 | # |
07ff3b19 | 262 | # • The file having the path `$2`. |
644e0364 | 263 | # |
07ff3b19 PP |
264 | # Returns 0 if there's no difference, or 1 otherwise, also printing said |
265 | # difference to the standard error. | |
644e0364 | 266 | bt_diff_cli() { |
58db335e FD |
267 | local expected_stdout_file="$1" |
268 | local expected_stderr_file="$2" | |
269 | shift 2 | |
53cc240b MJ |
270 | local args=("$@") |
271 | ||
58db335e FD |
272 | local temp_stdout_output_file |
273 | local temp_stderr_output_file | |
644e0364 | 274 | local ret=0 |
a70b6702 SM |
275 | local ret_stdout |
276 | local ret_stderr | |
644e0364 | 277 | |
7132b838 PP |
278 | temp_stdout_output_file="$(mktemp -t actual-stdout.XXXXXX)" |
279 | temp_stderr_output_file="$(mktemp -t actual-stderr.XXXXXX)" | |
644e0364 | 280 | |
22703f66 | 281 | bt_cli "$temp_stdout_output_file" "$temp_stderr_output_file" "${args[@]}" |
58db335e | 282 | |
a70b6702 SM |
283 | bt_diff "$expected_stdout_file" "$temp_stdout_output_file" "${args[@]}" |
284 | ret_stdout=$? | |
285 | bt_diff "$expected_stderr_file" "$temp_stderr_output_file" "${args[@]}" | |
286 | ret_stderr=$? | |
287 | ||
288 | if ((ret_stdout != 0 || ret_stderr != 0)); then | |
289 | ret=1 | |
290 | fi | |
58db335e | 291 | |
ff89ed28 | 292 | rm -f "$temp_stdout_output_file" "$temp_stderr_output_file" |
644e0364 | 293 | |
ff89ed28 MJ |
294 | return $ret |
295 | } | |
296 | ||
07ff3b19 PP |
297 | # Checks the difference between: |
298 | # | |
299 | # • The content of the file having the path `$1`. | |
300 | # | |
301 | # • What the `$BT_TESTS_BT2_BIN` command prints to the standard output | |
302 | # when executed with: | |
303 | # | |
304 | # 1. The CTF trace directory `$2`. | |
305 | # 2. The arguments `-c` and `sink.text.details`. | |
306 | # 3. The third and following arguments of this function. | |
644e0364 | 307 | # |
07ff3b19 PP |
308 | # Returns 0 if there's no difference, or 1 otherwise, also printing said |
309 | # difference to the standard error. | |
644e0364 | 310 | bt_diff_details_ctf_single() { |
58db335e | 311 | local expected_stdout_file="$1" |
53cc240b MJ |
312 | local trace_dir="$2" |
313 | shift 2 | |
314 | local extra_details_args=("$@") | |
58db335e | 315 | expected_stderr_file="/dev/null" |
644e0364 MJ |
316 | |
317 | # Compare using the CLI with `sink.text.details` | |
8b729209 PP |
318 | bt_diff_cli "$expected_stdout_file" "$expected_stderr_file" "$trace_dir" \ |
319 | "-c" "sink.text.details" "${extra_details_args[@]+${extra_details_args[@]}}" | |
644e0364 MJ |
320 | } |
321 | ||
07ff3b19 PP |
322 | # Like bt_diff_details_ctf_single(), except that `$1` is the path to a |
323 | # program which generates the CTF trace to compare to. | |
324 | # | |
325 | # The program `$1` receives the path to a temporary, empty directory | |
326 | # where to write the CTF trace as its first argument. | |
644e0364 MJ |
327 | bt_diff_details_ctf_gen_single() { |
328 | local ctf_gen_prog_path="$1" | |
58db335e | 329 | local expected_stdout_file="$2" |
53cc240b MJ |
330 | shift 2 |
331 | local extra_details_args=("$@") | |
644e0364 MJ |
332 | |
333 | local temp_trace_dir | |
334 | local ret | |
335 | ||
336 | temp_trace_dir="$(mktemp -d)" | |
337 | ||
338 | # Run the CTF trace generator program to get a CTF trace | |
339 | if ! "$ctf_gen_prog_path" "$temp_trace_dir" 2>/dev/null; then | |
340 | echo "ERROR: \"$ctf_gen_prog_path\" \"$temp_trace_dir\" failed" >&2 | |
341 | rm -rf "$temp_trace_dir" | |
342 | return 1 | |
343 | fi | |
344 | ||
345 | # Compare using the CLI with `sink.text.details` | |
8b729209 PP |
346 | bt_diff_details_ctf_single "$expected_stdout_file" "$temp_trace_dir" \ |
347 | "${extra_details_args[@]+${extra_details_args[@]}}" | |
644e0364 MJ |
348 | ret=$? |
349 | rm -rf "$temp_trace_dir" | |
350 | return $ret | |
351 | } | |
352 | ||
07ff3b19 | 353 | # Like `grep`, but using `$BT_TESTS_GREP_BIN`. |
407d3b10 SM |
354 | bt_grep() { |
355 | "$BT_TESTS_GREP_BIN" "$@" | |
356 | } | |
644e0364 | 357 | |
db01f759 SM |
358 | # ok() with the test name `$3` on the result of bt_grep() matching the |
359 | # pattern `$1` within the file `$2`. | |
360 | bt_grep_ok() { | |
361 | local pattern=$1 | |
362 | local file=$2 | |
363 | local test_name=$3 | |
364 | ||
365 | bt_grep --silent "$pattern" "$file" | |
366 | ||
367 | local ret=$? | |
368 | ||
369 | if ! ok $ret "$test_name"; then | |
370 | { | |
371 | echo "Pattern \`$pattern\` doesn't match the contents of \`$file\`:" | |
372 | echo '--- 8< ---' | |
373 | cat "$file" | |
374 | echo '--- >8 ---' | |
375 | } >&2 | |
376 | fi | |
377 | ||
378 | return $ret | |
379 | } | |
380 | ||
07ff3b19 | 381 | # Forwards the arguments to `coverage run`. |
644e0364 MJ |
382 | check_coverage() { |
383 | coverage run "$@" | |
384 | } | |
385 | ||
07ff3b19 PP |
386 | # Executes a command within an environment which can import the testing |
387 | # Python modules (in `tests/utils/python`). | |
1e14ec65 | 388 | run_python() { |
7747a39f PP |
389 | local our_pythonpath="${BT_TESTS_SRCDIR}/utils/python" |
390 | ||
5f62b715 | 391 | if [[ $BT_TESTS_PYTHON_VERSION =~ 3.[45] ]]; then |
07ff3b19 PP |
392 | # Add a local directory containing a `typing.py` to `PYTHONPATH` |
393 | # for Python 3.4 and Python 3.5 which either don't offer the | |
394 | # `typing` module at all, or offer a partial one. | |
7747a39f PP |
395 | our_pythonpath="$our_pythonpath:${BT_TESTS_SRCDIR}/utils/python/typing" |
396 | fi | |
397 | ||
398 | PYTHONPATH="${our_pythonpath}${PYTHONPATH:+:}${PYTHONPATH:-}" "$@" | |
1e14ec65 PP |
399 | } |
400 | ||
07ff3b19 PP |
401 | # Executes a command within an environment which can import the testing |
402 | # Python modules (in `tests/utils/python`) and the `bt2` Python package. | |
644e0364 | 403 | run_python_bt2() { |
0b0893d4 | 404 | local lib_asan |
1e14ec65 PP |
405 | local -x "BABELTRACE_PYTHON_BT2_NO_TRACEBACK=1" |
406 | local -x "BABELTRACE_PLUGIN_PATH=${BT_TESTS_BABELTRACE_PLUGIN_PATH}" | |
407 | local -x "LIBBABELTRACE2_PLUGIN_PROVIDER_DIR=${BT_TESTS_PROVIDER_DIR}" | |
408 | local -x "BT_TESTS_DATADIR=${BT_TESTS_DATADIR}" | |
409 | local -x "BT_CTF_TRACES_PATH=${BT_CTF_TRACES_PATH}" | |
410 | local -x "BT_PLUGINS_PATH=${BT_PLUGINS_PATH}" | |
411 | local -x "PYTHONPATH=${BT_TESTS_PYTHONPATH}${PYTHONPATH:+:}${PYTHONPATH:-}" | |
644e0364 | 412 | |
0408934a SM |
413 | local main_lib_path="${BT_TESTS_BUILDDIR}/../src/lib/.libs" |
414 | ||
07ff3b19 PP |
415 | # Set the library search path so that the Python 3 interpreter can |
416 | # load `libbabeltrace2`. | |
a0baab4a | 417 | if [ "$BT_TESTS_OS_TYPE" = "mingw" ] || [ "$BT_TESTS_OS_TYPE" = "cygwin" ]; then |
1e14ec65 | 418 | local -x PATH="${main_lib_path}${PATH:+:}${PATH:-}" |
a0baab4a | 419 | elif [ "$BT_TESTS_OS_TYPE" = "darwin" ]; then |
1e14ec65 | 420 | local -x DYLD_LIBRARY_PATH="${main_lib_path}${DYLD_LIBRARY_PATH:+:}${DYLD_LIBRARY_PATH:-}" |
644e0364 | 421 | else |
1e14ec65 | 422 | local -x LD_LIBRARY_PATH="${main_lib_path}${LD_LIBRARY_PATH:+:}${LD_LIBRARY_PATH:-}" |
e23e08c4 MJ |
423 | fi |
424 | ||
07ff3b19 PP |
425 | # On Windows, an embedded Python 3 interpreter needs a way to locate |
426 | # the path to its internal modules: set the `PYTHONHOME` variable to | |
427 | # the prefix from `python3-config`. | |
a0baab4a | 428 | if [ "$BT_TESTS_OS_TYPE" = "mingw" ]; then |
1e14ec65 PP |
429 | local -x PYTHONHOME |
430 | ||
431 | PYTHONHOME=$($BT_TESTS_PYTHON_CONFIG_BIN --prefix) | |
644e0364 MJ |
432 | fi |
433 | ||
07ff3b19 | 434 | # If AddressSanitizer is used, we must preload `libasan.so` so that |
0b0893d4 SM |
435 | # libasan doesn't complain about not being the first loaded library. |
436 | # | |
07ff3b19 PP |
437 | # Python and sed (executed as part of the Libtool wrapper) produce |
438 | # some leaks, so we must unfortunately disable leak detection. | |
439 | # | |
440 | # Append it to existing `ASAN_OPTIONS` variable, such that we | |
441 | # override the user's value if it contains `detect_leaks=1`. | |
75e396f6 | 442 | if [ "${BT_TESTS_ENABLE_ASAN:-}" = "1" ]; then |
407d3b10 | 443 | if ${BT_TESTS_CC_BIN} --version | head -n 1 | bt_grep -q '^gcc'; then |
1e14ec65 PP |
444 | lib_asan="$(${BT_TESTS_CC_BIN} -print-file-name=libasan.so)" |
445 | local -x LD_PRELOAD="${lib_asan}${LD_PRELOAD:+:}${LD_PRELOAD:-}" | |
2d12d310 | 446 | fi |
0b0893d4 | 447 | |
1e14ec65 | 448 | local -x "ASAN_OPTIONS=${ASAN_OPTIONS:-}${ASAN_OPTIONS:+,}detect_leaks=0" |
0b0893d4 SM |
449 | fi |
450 | ||
1e14ec65 | 451 | run_python "$@" |
644e0364 MJ |
452 | } |
453 | ||
07ff3b19 PP |
454 | # Runs the Python tests matching the pattern `$2` (optional, `*` if |
455 | # missing) in the directory `$1` using `testrunner.py`. | |
644e0364 | 456 | # |
07ff3b19 PP |
457 | # This function uses run_python_bt2(), therefore such tests can import |
458 | # the testing Python modules (in `tests/utils/python`) and the `bt2` | |
459 | # Python package. | |
644e0364 MJ |
460 | run_python_bt2_test() { |
461 | local test_dir="$1" | |
07ff3b19 | 462 | local test_pattern="${2:-'*'}" |
644e0364 MJ |
463 | |
464 | local ret | |
465 | local test_runner_args=() | |
466 | ||
467 | test_runner_args+=("$test_dir") | |
75e396f6 | 468 | if [ -n "${test_pattern}" ]; then |
644e0364 MJ |
469 | test_runner_args+=("${test_pattern}") |
470 | fi | |
471 | ||
75e396f6 | 472 | if test "${BT_TESTS_COVERAGE:-}" = "1"; then |
644e0364 MJ |
473 | python_exec="check_coverage" |
474 | else | |
475 | python_exec="${BT_TESTS_PYTHON_BIN}" | |
476 | fi | |
477 | ||
478 | run_python_bt2 \ | |
479 | "${python_exec}" \ | |
480 | "${BT_TESTS_SRCDIR}/utils/python/testrunner.py" \ | |
a818a617 FD |
481 | --pattern "$test_pattern" \ |
482 | "$test_dir" \ | |
483 | ||
644e0364 MJ |
484 | ret=$? |
485 | ||
75e396f6 | 486 | if test "${BT_TESTS_COVERAGE_REPORT:-}" = "1"; then |
644e0364 MJ |
487 | coverage report -m |
488 | fi | |
489 | ||
75e396f6 | 490 | if test "${BT_TESTS_COVERAGE_HTML:-}" = "1"; then |
644e0364 MJ |
491 | coverage html |
492 | fi | |
493 | ||
494 | return $ret | |
495 | } | |
89ec984e | 496 | |
07ff3b19 PP |
497 | # Generates a CTF trace into the directory `$2` from the moultipart |
498 | # document `$1` using `mctf.py`. | |
89ec984e SM |
499 | gen_mctf_trace() { |
500 | local input_file="$1" | |
501 | local base_dir="$2" | |
502 | ||
503 | diag "Running: ${BT_TESTS_PYTHON_BIN} ${BT_TESTS_SRCDIR}/utils/python/mctf.py --base-dir ${base_dir} ${input_file}" | |
ec48dce5 | 504 | run_python "${BT_TESTS_PYTHON_BIN}" "${BT_TESTS_SRCDIR}/utils/python/mctf.py" \ |
89ec984e SM |
505 | --base-dir "${base_dir}" "${input_file}" |
506 | } |