Function cmd_test

examples/API Test/test_api.py:733–763

Run the smoke test suite. Self-discovers the live command surface.

(api: SerialStudioAPI, args)

def cmd_test(api: SerialStudioAPI, args) -> int:
    """Run the smoke test suite. Self-discovers the live command surface."""
    print(bold("=" * 60))
    print(bold("Serial Studio API Smoke Test"))
    print(bold("=" * 60))
    print()
    print(dim("This suite exercises a handful of read-only commands per scope"))
    print(dim("and checks protocol-level invariants. It does NOT verify every"))
    print(dim("command's behavior -- use the live registry (api.getCommands)"))
    print(dim("for that."))

    suite = TestSuite("Serial Studio API")

    try:
        test_protocol(api, suite)
        commands = test_command_registry(api, suite)

        if commands is not None:
            available = {c.get("name", "") for c in commands}
            test_smoke(api, suite, available)
            test_blocked_commands(api, suite, available)
    except KeyboardInterrupt:
        print(error("\n[INTERRUPTED] Tests cancelled by user"))
    except Exception as e:
        print(error(f"\n[FATAL] Unexpected error: {e}"))
        import traceback

        traceback.print_exc()

    suite.print_summary()
    return 0 if suite.failed == 0 else 1


# =============================================================================