arx.testing

arx.testing

Source: packages/arx/src/arx/testing.py

title: Arx compiled test runner helpers.

Classes

AssertionFailureReport

title: Parsed machine-readable assertion failure report.
attributes:
  source:
    type: str
  line:
    type: int
  col:
    type: int
  message:
    type: str

DiscoveredTestCase

title: One discovered compiled test case.
attributes:
  name:
    type: str
  function_name:
    type: str
  file:
    type: Path

TestExecutionResult

title: Result from running one compiled test case.
attributes:
  name:
    type: str
  passed:
    type: bool
  returncode:
    type: int
  stdout:
    type: str
  stderr:
    type: str
  assertion_failure:
    type: AssertionFailureReport | None
  artifact_dir:
    type: Path | None

TestRunSummary

title: Summary for one `arx test` session.
attributes:
  selected:
    type: int
  executed:
    type: int
  passed:
    type: int
  failed:
    type: int
  exit_code:
    type: int
  results:
    type: tuple[TestExecutionResult, Ellipsis]

TestRunError(RuntimeError)

title: Internal error raised while collecting or running compiled tests.
attributes:
  artifact_dir:
    type: Path | None

ArxTestRunner

title: 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

collect_tests(self) -> tuple[DiscoveredTestCase, ...]

title: Collect and filter discovered tests across configured paths.
returns:
  type: tuple[DiscoveredTestCase, Ellipsis]

run(self) -> TestRunSummary

title: Collect, compile, and execute the configured test selection.
returns:
  type: TestRunSummary