Class FingerprintResult

ci/util/test_types.py:161–204

Type-safe fingerprint result with test metadata for cache display

@typechecked
@dataclass
class FingerprintResult:
    """Type-safe fingerprint result with test metadata for cache display"""

    hash: str
    elapsed_seconds: Optional[str] = None
    status: Optional[str] = None
    # Test result metadata - stored when tests complete for display on cache hits
    num_tests_run: Optional[int] = None
    num_tests_passed: Optional[int] = None
    duration_seconds: Optional[float] = None
    test_name: Optional[str] = None  # Human-readable test category name

    def get_cache_summary(self) -> str:
        """Get a human-readable summary of cached test results"""
        if self.num_tests_run is not None and self.num_tests_passed is not None:
            duration_str = (
                f" in {self.duration_seconds:.2f}s" if self.duration_seconds else ""
            )
            return f"{self.num_tests_passed}/{self.num_tests_run} passed{duration_str}"
        return ""

    def should_skip(self, current: "FingerprintResult") -> bool:
        """
        Determine if we should skip running tests based on fingerprint comparison.

        Args:
            current: The current fingerprint calculated from the codebase

        Returns:
            True if we should skip (cache hit), False if we should run tests

        Logic:
            - Skip if hash matches AND previous status was "success"
            - Always run if hash differs (code changed)
            - Always run if previous status was not "success" (previous failure)
        """
        if self.hash != current.hash:
            # Code changed - must run
            return False
        if self.status != "success":
            # Previous run failed - must run again
            return False
        # Hash matches and previous run succeeded - safe to skip
        return True


def process_test_flags(args: TestArgs) -> TestArgs: