Spaces:
Sleeping
Sleeping
Download apps/python-sdk/firecrawl/v2/utils/error_handler.py from s-eto-hub/firecrawl-api: direct link, hf CLI and curl.
- Browser
- Download file 4.2 kB
-
https://huggingface.co/spaces/s-eto-hub/firecrawl-api/resolve/main/apps/python-sdk/firecrawl/v2/utils/error_handler.py
- Command line
-
hf download hf://spaces/s-eto-hub/firecrawl-api/apps/python-sdk/firecrawl/v2/utils/error_handler.py
-
curl -L -o error_handler.py https://huggingface.co/spaces/s-eto-hub/firecrawl-api/resolve/main/apps/python-sdk/firecrawl/v2/utils/error_handler.py
4.2 kB
| """ | |
| Error handling utilities for v2 API. | |
| """ | |
| import requests | |
| from typing import Dict, Any, Optional | |
| class FirecrawlError(Exception): | |
| """Base exception for Firecrawl API errors.""" | |
| def __init__(self, message: str, status_code: Optional[int] = None, response: Optional[requests.Response] = None): | |
| super().__init__(message) | |
| self.status_code = status_code | |
| self.response = response | |
| class BadRequestError(FirecrawlError): | |
| """Raised when the request is invalid (400).""" | |
| pass | |
| class UnauthorizedError(FirecrawlError): | |
| """Raised when the request is unauthorized (401).""" | |
| pass | |
| class PaymentRequiredError(FirecrawlError): | |
| """Raised when payment is required (402).""" | |
| pass | |
| class WebsiteNotSupportedError(FirecrawlError): | |
| """Raised when website is not supported (403).""" | |
| pass | |
| class RequestTimeoutError(FirecrawlError): | |
| """Raised when request times out (408).""" | |
| pass | |
| class RateLimitError(FirecrawlError): | |
| """Raised when the rate limit is exceeded (429).""" | |
| pass | |
| class InternalServerError(FirecrawlError): | |
| """Raised when there's an internal server error (500).""" | |
| pass | |
| def handle_response_error(response: requests.Response, action: str) -> None: | |
| """ | |
| Handle API response errors and raise appropriate exceptions. | |
| Args: | |
| response: The HTTP response object | |
| action: Description of the action being performed | |
| Raises: | |
| FirecrawlError: Appropriate error based on status code | |
| """ | |
| try: | |
| response_json = response.json() | |
| error_message = response_json.get('error', 'No error message provided.') | |
| error_details = response_json.get('details', 'No additional error details provided.') | |
| except: | |
| # If we can't parse JSON, provide a helpful error message | |
| try: | |
| response_text = response.text[:500] # Limit to first 500 chars | |
| if response_text.strip(): | |
| error_message = f"Server returned non-JSON response: {response_text}" | |
| error_details = f"Full response status: {response.status_code}" | |
| else: | |
| error_message = f"Server returned empty response with status {response.status_code}" | |
| error_details = "No additional details available" | |
| except: | |
| error_message = f"Server returned unreadable response with status {response.status_code}" | |
| error_details = "No additional details available" | |
| # Create appropriate error message | |
| if response.status_code == 400: | |
| message = f"Bad Request: Failed to {action}. {error_message} - {error_details}" | |
| raise BadRequestError(message, response.status_code, response) | |
| elif response.status_code == 401: | |
| message = f"Unauthorized: Failed to {action}. {error_message} - {error_details}" | |
| raise UnauthorizedError(message, response.status_code, response) | |
| elif response.status_code == 402: | |
| message = f"Payment Required: Failed to {action}. {error_message} - {error_details}" | |
| raise PaymentRequiredError(message, response.status_code, response) | |
| elif response.status_code == 403: | |
| message = f"Website Not Supported: Failed to {action}. {error_message} - {error_details}" | |
| raise WebsiteNotSupportedError(message, response.status_code, response) | |
| elif response.status_code == 408: | |
| message = f"Request Timeout: Failed to {action} as the request timed out. {error_message} - {error_details}" | |
| raise RequestTimeoutError(message, response.status_code, response) | |
| elif response.status_code == 429: | |
| message = f"Rate Limit Exceeded: Failed to {action}. {error_message} - {error_details}" | |
| raise RateLimitError(message, response.status_code, response) | |
| elif response.status_code == 500: | |
| message = f"Internal Server Error: Failed to {action}. {error_message} - {error_details}" | |
| raise InternalServerError(message, response.status_code, response) | |
| else: | |
| message = f"Unexpected error during {action}: Status code {response.status_code}. {error_message} - {error_details}" | |
| raise FirecrawlError(message, response.status_code, response) |