5f4a280458
- Add QdrantMigrationError exception - Implement automatic data migration - Support workspace-based partitioning - Add migration verification logic - Update collection naming scheme
114 lines
3.8 KiB
Python
114 lines
3.8 KiB
Python
from __future__ import annotations
|
|
|
|
import httpx
|
|
from typing import Literal
|
|
|
|
|
|
class APIStatusError(Exception):
|
|
"""Raised when an API response has a status code of 4xx or 5xx."""
|
|
|
|
response: httpx.Response
|
|
status_code: int
|
|
request_id: str | None
|
|
|
|
def __init__(
|
|
self, message: str, *, response: httpx.Response, body: object | None
|
|
) -> None:
|
|
super().__init__(message, response.request, body=body)
|
|
self.response = response
|
|
self.status_code = response.status_code
|
|
self.request_id = response.headers.get("x-request-id")
|
|
|
|
|
|
class APIConnectionError(Exception):
|
|
def __init__(
|
|
self, *, message: str = "Connection error.", request: httpx.Request
|
|
) -> None:
|
|
super().__init__(message, request, body=None)
|
|
|
|
|
|
class BadRequestError(APIStatusError):
|
|
status_code: Literal[400] = 400 # pyright: ignore[reportIncompatibleVariableOverride]
|
|
|
|
|
|
class AuthenticationError(APIStatusError):
|
|
status_code: Literal[401] = 401 # pyright: ignore[reportIncompatibleVariableOverride]
|
|
|
|
|
|
class PermissionDeniedError(APIStatusError):
|
|
status_code: Literal[403] = 403 # pyright: ignore[reportIncompatibleVariableOverride]
|
|
|
|
|
|
class NotFoundError(APIStatusError):
|
|
status_code: Literal[404] = 404 # pyright: ignore[reportIncompatibleVariableOverride]
|
|
|
|
|
|
class ConflictError(APIStatusError):
|
|
status_code: Literal[409] = 409 # pyright: ignore[reportIncompatibleVariableOverride]
|
|
|
|
|
|
class UnprocessableEntityError(APIStatusError):
|
|
status_code: Literal[422] = 422 # pyright: ignore[reportIncompatibleVariableOverride]
|
|
|
|
|
|
class RateLimitError(APIStatusError):
|
|
status_code: Literal[429] = 429 # pyright: ignore[reportIncompatibleVariableOverride]
|
|
|
|
|
|
class APITimeoutError(APIConnectionError):
|
|
def __init__(self, request: httpx.Request) -> None:
|
|
super().__init__(message="Request timed out.", request=request)
|
|
|
|
|
|
class StorageNotInitializedError(RuntimeError):
|
|
"""Raised when storage operations are attempted before initialization."""
|
|
|
|
def __init__(self, storage_type: str = "Storage"):
|
|
super().__init__(
|
|
f"{storage_type} not initialized. Please ensure proper initialization:\n"
|
|
f"\n"
|
|
f" rag = LightRAG(...)\n"
|
|
f" await rag.initialize_storages() # Required\n"
|
|
f" \n"
|
|
f" from lightrag.kg.shared_storage import initialize_pipeline_status\n"
|
|
f" await initialize_pipeline_status() # Required for pipeline operations\n"
|
|
f"\n"
|
|
f"See: https://github.com/HKUDS/LightRAG#important-initialization-requirements"
|
|
)
|
|
|
|
|
|
class PipelineNotInitializedError(KeyError):
|
|
"""Raised when pipeline status is accessed before initialization."""
|
|
|
|
def __init__(self, namespace: str = ""):
|
|
msg = (
|
|
f"Pipeline namespace '{namespace}' not found. "
|
|
f"This usually means pipeline status was not initialized.\n"
|
|
f"\n"
|
|
f"Please call 'await initialize_pipeline_status()' after initializing storages:\n"
|
|
f"\n"
|
|
f" from lightrag.kg.shared_storage import initialize_pipeline_status\n"
|
|
f" await initialize_pipeline_status()\n"
|
|
f"\n"
|
|
f"Full initialization sequence:\n"
|
|
f" rag = LightRAG(...)\n"
|
|
f" await rag.initialize_storages()\n"
|
|
f" await initialize_pipeline_status()"
|
|
)
|
|
super().__init__(msg)
|
|
|
|
|
|
class PipelineCancelledException(Exception):
|
|
"""Raised when pipeline processing is cancelled by user request."""
|
|
|
|
def __init__(self, message: str = "User cancelled"):
|
|
super().__init__(message)
|
|
self.message = message
|
|
|
|
|
|
class QdrantMigrationError(Exception):
|
|
"""Raised when Qdrant data migration from legacy collections fails."""
|
|
|
|
def __init__(self, message: str):
|
|
super().__init__(message)
|
|
self.message = message
|