__init__.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# oct/testing/__init__.py
 
"""
Purpose
-------
The ``oct test`` v1.0 SEED (Plan 189, spec-10 slice 2): the §9
workspace/package discovery + selection layer as a pure library. The
frozen v0.x ``oct test`` CLI is untouched (ADR-T-14); the v1.0 CLI
cutover will consume this package. The oc_chat stand-in
(``oc_chat/oc_chat/testing/``) stays independent until the §20.4
retirement - the two trees share naming, never imports.
 
Responsibilities
----------------
- Re-export the public surface: the §12.4 error taxonomy as data
  (``errors``), the §9 manifest test view (``manifest``), and the §9
  precedence + ADR-T-12 walk (``discovery``).
- No CLI, no entry point, no ``sys.exit`` anywhere in the package -
  exits are data the future CLI slice maps at its boundary.
 
Diagnostics
-----------
Domain: OCT-TESTING
Levels:
    L2: lifecycle events
    L3: semantic details
    L4: deep tracing
 
Contracts
---------
- ``oct.core.workspace`` is a read-only dependency; this package
  layers on top of the v0.25 loader without modifying it.
- Import surface is stable for the v1.0 CLI slice: everything in
  ``__all__`` here is the consumable API.
 
Dependencies
------------
- oct.testing.errors (re-exported: the §12.4 error taxonomy as data)
- oct.testing.manifest (re-exported: the §9 manifest test view)
- oct.testing.discovery (re-exported: the §9 precedence and ADR-T-12 walk)
- oct.core.diagnostics (_dbg structured logger; imported but never called here)
"""
 
from __future__ import annotations
 
from oct.testing.discovery import (
    CWD_RESOLUTION_MESSAGE,
    MODE_SINGLE_PACKAGE,
    MODE_WORKSPACE,
    WALK_LEVELS,
    DiscoveryResult,
    SinglePackage,
    discover,
    walk_for_package,
)
from oct.testing.errors import (
    CWD_RESOLUTION_FAILED,
    EXIT_CONFIGURATION_ERROR,
    EXIT_ORCHESTRATOR_ERROR,
    IMPLEMENTATION_CODE_CATALOG,
    KIND_CONFIGURATION,
    KIND_ORCHESTRATOR,
    KIND_SIGNAL,
    MANIFEST_TEST_BLOCK_INVALID,
    OctTestError,
    PACKAGE_UNKNOWN,
    SEVERITY_FATAL,
    SEVERITY_WARNING,
    WORKSPACE_AND_PACKAGE_BOTH_PASSED,
    WORKSPACE_FILE_NOT_FOUND,
    WORKSPACE_MANIFEST_INVALID,
    exit_code_for_kind,
)
from oct.testing.manifest import (
    DEFAULT_TEST_PROFILE,
    TEST_PROFILES,
    PackageTestConfig,
    TestManifest,
    load_test_manifest,
)
# OCT-LINT: disable-file=dbg_usage reason="Plan 263: a re-export package root with no function or method, so any _dbg call here would run before oc_diagnostics.init() and add a RuntimeWarning to every oct invocation"
from oct.core.diagnostics import _dbg
 
__all__ = [
    "CWD_RESOLUTION_FAILED",
    "CWD_RESOLUTION_MESSAGE",
    "DEFAULT_TEST_PROFILE",
    "DiscoveryResult",
    "EXIT_CONFIGURATION_ERROR",
    "EXIT_ORCHESTRATOR_ERROR",
    "IMPLEMENTATION_CODE_CATALOG",
    "KIND_CONFIGURATION",
    "KIND_ORCHESTRATOR",
    "KIND_SIGNAL",
    "MANIFEST_TEST_BLOCK_INVALID",
    "MODE_SINGLE_PACKAGE",
    "MODE_WORKSPACE",
    "OctTestError",
    "PACKAGE_UNKNOWN",
    "PackageTestConfig",
    "SEVERITY_FATAL",
    "SEVERITY_WARNING",
    "SinglePackage",
    "TEST_PROFILES",
    "TestManifest",
    "WALK_LEVELS",
    "WORKSPACE_AND_PACKAGE_BOTH_PASSED",
    "WORKSPACE_FILE_NOT_FOUND",
    "WORKSPACE_MANIFEST_INVALID",
    "discover",
    "exit_code_for_kind",
    "load_test_manifest",
    "walk_for_package",
]