xparse-client 0.2.19__py3-none-any.whl → 0.3.0b8__py3-none-any.whl

tests/unit/test_exceptions.py

@@ -0,0 +1,182 @@
+"""异常类测试"""
+
+
+from xparse_client.exceptions import (
+    APIError,
+    AuthenticationError,
+    ConfigurationError,
+    ConnectorError,
+    DestinationError,
+    NotFoundError,
+    PermissionDeniedError,
+    PipelineError,
+    RateLimitError,
+    RequestTimeoutError,
+    ServerError,
+    SourceError,
+    ValidationError,
+    XParseClientError,
+)
+
+
+class TestXParseClientError:
+    """基础异常类测试"""
+
+    def test_basic_error(self):
+        """测试基础错误创建"""
+        error = XParseClientError("测试错误")
+        assert error.message == "测试错误"
+        assert error.details == {}
+        assert str(error) == "测试错误"
+
+    def test_error_with_details(self):
+        """测试带详情的错误"""
+        error = XParseClientError("测试错误", details={"key": "value"})
+        assert error.details == {"key": "value"}
+        assert "key=value" in str(error)
+
+    def test_to_dict(self):
+        """测试序列化为字典"""
+        error = XParseClientError("测试错误", details={"key": "value"})
+        result = error.to_dict()
+        assert result["error_type"] == "XParseClientError"
+        assert result["message"] == "测试错误"
+        assert result["details"] == {"key": "value"}
+
+
+class TestConfigurationError:
+    """配置错误测试"""
+
+    def test_configuration_error(self):
+        """测试配置错误"""
+        error = ConfigurationError(
+            "缺少必要参数",
+            details={"missing": ["app_id"]},
+        )
+        assert isinstance(error, XParseClientError)
+        assert error.message == "缺少必要参数"
+
+
+class TestValidationError:
+    """验证错误测试"""
+
+    def test_validation_error_with_field(self):
+        """测试带字段信息的验证错误"""
+        error = ValidationError(
+            "无效的值",
+            field="filename",
+            value="test.xyz",
+        )
+        assert error.field == "filename"
+        assert error.value == "test.xyz"
+        assert "field" in error.details
+        assert "value" in error.details
+
+
+class TestAPIError:
+    """API 错误测试"""
+
+    def test_api_error_with_status(self):
+        """测试带状态码的 API 错误"""
+        error = APIError(
+            "请求失败",
+            status_code=500,
+            request_id="req-123",
+        )
+        assert error.status_code == 500
+        assert error.request_id == "req-123"
+        assert "status=500" in str(error)
+        assert "request_id=req-123" in str(error)
+
+    def test_authentication_error(self):
+        """测试认证错误"""
+        error = AuthenticationError(
+            "无效的 API 密钥",
+            status_code=401,
+        )
+        assert isinstance(error, APIError)
+        assert error.status_code == 401
+
+    def test_permission_denied_error(self):
+        """测试权限错误"""
+        error = PermissionDeniedError(
+            "无权访问",
+            status_code=403,
+        )
+        assert isinstance(error, APIError)
+
+    def test_not_found_error(self):
+        """测试资源不存在错误"""
+        error = NotFoundError(
+            "资源不存在",
+            resource_type="job",
+            resource_id="job-123",
+            status_code=404,
+        )
+        assert error.resource_type == "job"
+        assert error.resource_id == "job-123"
+
+    def test_rate_limit_error(self):
+        """测试限流错误"""
+        error = RateLimitError(
+            "请求过于频繁",
+            retry_after=60,
+            status_code=429,
+        )
+        assert error.retry_after == 60
+
+    def test_server_error(self):
+        """测试服务器错误"""
+        error = ServerError(
+            "内部服务器错误",
+            status_code=500,
+        )
+        assert isinstance(error, APIError)
+
+    def test_timeout_error(self):
+        """测试超时错误"""
+        error = RequestTimeoutError(
+            "请求超时",
+            timeout_seconds=30.0,
+        )
+        assert error.timeout_seconds == 30.0
+
+
+class TestConnectorError:
+    """连接器错误测试"""
+
+    def test_source_error(self):
+        """测试数据源错误"""
+        error = SourceError(
+            "无法连接 S3",
+            connector_type="s3",
+            operation="connect",
+        )
+        assert error.connector_type == "s3"
+        assert error.operation == "connect"
+        assert isinstance(error, ConnectorError)
+
+    def test_destination_error(self):
+        """测试目的地错误"""
+        error = DestinationError(
+            "写入 Milvus 失败",
+            connector_type="milvus",
+            operation="write",
+        )
+        assert error.connector_type == "milvus"
+        assert isinstance(error, ConnectorError)
+
+
+class TestPipelineError:
+    """Pipeline 错误测试"""
+
+    def test_pipeline_error(self):
+        """测试 Pipeline 错误"""
+        error = PipelineError(
+            "处理文件失败",
+            stage="parse",
+            filename="test.pdf",
+        )
+        assert error.stage == "parse"
+        assert error.filename == "test.pdf"
+        assert isinstance(error, XParseClientError)