API reference
python:arx:arx.testing.ArxTestRunner
class ArxTestRunner
ArxTestRunner(paths: tuple[str, ...] = DEFAULT_TEST_PATHS, exclude: tuple[str, ...] = (), file_pattern: str = DEFAULT_TEST_FILE_PATTERN, function_pattern: str = DEFAULT_TEST_FUNCTION_PATTERN, name_filter: str = '', fail_fast: bool = False, keep_artifacts: bool = False, list_only: bool = False, link_mode: LinkMode = 'auto')
Source: packages/arx/src/arx/testing.py:193
Python-side compiled test runner for Arx.
Attributes
-
paths — Type: tuple[str, Ellipsis]
-
exclude — Type: tuple[str, Ellipsis]
-
file_pattern — Type: str
-
function_pattern — Type: str
-
name_filter — Type: str
-
fail_fast — Type: bool
-
keep_artifacts — Type: bool
-
list_only — Type: bool
-
link_mode — Type: LinkMode
Methods
-
__init__ —
-
_build_execution_result — Convert one command result into a stable test result object.
-
_build_wrapper_main — Build the generated wrapper `main()` for one selected test.
-
_build_wrapper_module — Build one synthetic module that runs exactly one selected test.
-
_compile_and_run_test — Compile and execute one selected test case in isolation.
-
_discover_test_files — Discover the ordered set of candidate test source files.
-
_discover_tests — Discover valid test functions from one parsed module.
-
_display_path_prefix — Build a path-qualified display prefix for one test file.
-
_match_exclude — Return whether one candidate file matches an exclude glob.
-
_parse_module — Parse one test source file into an IRx-backed module.
-
_print_summary — Print a concise human-readable session summary.
-
_print_test_result — Print one human-readable test result line.
-
_top_level_node_error — Build one runner error for an unsupported top-level node.
-
_validate_test_function — Validate the test-function signature contract.
-
_write_wrapper_artifact — Write a readable wrapper-module artifact for debugging.
-
collect_tests — Collect and filter discovered tests across configured paths.
-
run — Collect, compile, and execute the configured test selection.