cloud_auth.py

Go to the documentation of this file.

# Copyright (c) 2025-present Aquin Labs Private Limited. All Rights Reserved.
"""Aquin cloud HTTP auth error helpers."""
from __future__ import annotations
 
import httpx
 
 
def cloud_auth_error_exit(api_key: str | None = None) -> None:
    """Print a clear login hint and exit when Aquin cloud rejects the API key."""
    from aquin.auth_config import print_token_rejected, resolve_api_key
 
    print_token_rejected(api_key or resolve_api_key(allow_missing=True) or None)
 
 
def is_cloud_auth_failure(exc: BaseException) -> bool:
    if isinstance(exc, httpx.HTTPStatusError) and exc.response is not None:
        return exc.response.status_code in (401, 403)
    msg = str(exc).lower()
    return "401" in msg or "403" in msg or "unauthorized" in msg
 
 
def exit_if_cloud_auth_error(exc: BaseException) -> None:
    """Exit with a clear login hint when Aquin cloud rejects the API key."""
    if is_cloud_auth_failure(exc):
        cloud_auth_error_exit()