mc5-api-client 1.0.0__py3-none-any.whl

mc5_api_client/exceptions.py

@@ -0,0 +1,78 @@
+# ────────────[ CHIZOBA ]────────────────────────────
+# | Email    : chizoba2026@hotmail.com
+# | File     : exceptions.py
+# | License  : MIT License © 2026 Chizoba
+# | Brief    : Custom exceptions for MC5 API Client
+# ────────────────★─────────────────────────────────
+
+"""
+Custom exceptions for the MC5 API Client.
+"""
+
+
+class MC5APIError(Exception):
+    """Base exception for all MC5 API related errors."""
+    
+    def __init__(self, message: str, status_code: int = None, response_data: dict = None):
+        super().__init__(message)
+        self.message = message
+        self.status_code = status_code
+        self.response_data = response_data or {}
+    
+    def __str__(self) -> str:
+        if self.status_code:
+            return f"MC5APIError ({self.status_code}): {self.message}"
+        return f"MC5APIError: {self.message}"
+
+
+class AuthenticationError(MC5APIError):
+    """Raised when authentication fails."""
+    
+    def __init__(self, message: str = "Authentication failed"):
+        super().__init__(message, status_code=401)
+
+
+class RateLimitError(MC5APIError):
+    """Raised when rate limit is exceeded."""
+    
+    def __init__(self, message: str = "Rate limit exceeded", retry_after: int = None):
+        super().__init__(message, status_code=429)
+        self.retry_after = retry_after
+
+
+class InvalidCredentialsError(AuthenticationError):
+    """Raised when provided credentials are invalid."""
+    
+    def __init__(self, message: str = "Invalid username or password"):
+        super().__init__(message)
+
+
+class TokenExpiredError(AuthenticationError):
+    """Raised when access token has expired."""
+    
+    def __init__(self, message: str = "Access token has expired"):
+        super().__init__(message)
+
+
+class InsufficientScopeError(MC5APIError):
+    """Raised when token lacks required scope for an operation."""
+    
+    def __init__(self, required_scope: str):
+        message = f"Insufficient scope. Required: {required_scope}"
+        super().__init__(message, status_code=403)
+        self.required_scope = required_scope
+
+
+class NetworkError(MC5APIError):
+    """Raised when network connectivity issues occur."""
+    
+    def __init__(self, message: str = "Network error occurred"):
+        super().__init__(message)
+
+
+class ValidationError(MC5APIError):
+    """Raised when request validation fails."""
+    
+    def __init__(self, message: str = "Validation failed", field: str = None):
+        super().__init__(message, status_code=400)
+        self.field = field

mc5_api_client-1.0.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chizoba
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.