Function check_cached_download

ci/util/download_breadcrumb.py:185–220

Check if a URL has been downloaded and cached successfully. Args: cache_dir: Base cache directory url: URL to check expected_filename: If provided, also verify this file exists Returns: Path to the cached artifact directory if complete, None otherwise

(
    cache_dir: Path, url: str, expected_filename: Optional[str] = None
)

def check_cached_download(
    cache_dir: Path, url: str, expected_filename: Optional[str] = None
) -> Optional[Path]:
    """
    Check if a URL has been downloaded and cached successfully.

    Args:
        cache_dir: Base cache directory
        url: URL to check
        expected_filename: If provided, also verify this file exists

    Returns:
        Path to the cached artifact directory if complete, None otherwise
    """
    artifact_dir = get_cache_artifact_dir(cache_dir, url)
    breadcrumb_path = get_breadcrumb_path(cache_dir, url)

    # Check if breadcrumb indicates completion
    if not is_download_complete(breadcrumb_path):
        return None

    # Check if artifact directory exists
    if not artifact_dir.exists():
        logger.warning(
            f"Breadcrumb exists but artifact directory missing: {artifact_dir}"
        )
        return None

    # If expected filename provided, verify it exists
    if expected_filename:
        expected_path = artifact_dir / expected_filename
        if not expected_path.exists():
            logger.warning(f"Expected file missing: {expected_path}")
            return None

    return artifact_dir