51 lines
2.1 KiB
Markdown
51 lines
2.1 KiB
Markdown
---
|
|
title: "Error Reference"
|
|
---
|
|
|
|
## Error Reference
|
|
|
|
All error types thrown by the library across all languages.
|
|
|
|
### KreuzbergError
|
|
|
|
Main error type for all Kreuzberg operations.
|
|
|
|
All errors in Kreuzberg use this enum, which preserves error chains
|
|
and provides context for debugging.
|
|
|
|
## Variants
|
|
|
|
- `Io` - File system and I/O errors (always bubble up)
|
|
- `Parsing` - Document parsing errors (corrupt files, unsupported features)
|
|
- `Ocr` - OCR processing errors
|
|
- `Validation` - Input validation errors (invalid paths, config, parameters)
|
|
- `Cache` - Cache operation errors (non-fatal, can be ignored)
|
|
- `ImageProcessing` - Image manipulation errors
|
|
- `Serialization` - JSON/MessagePack serialization errors
|
|
- `MissingDependency` - Missing optional dependencies (tesseract, etc.)
|
|
- `Plugin` - Plugin-specific errors
|
|
- `LockPoisoned` - Mutex/RwLock poisoning (should not happen in normal operation)
|
|
- `UnsupportedFormat` - Unsupported MIME type or file format
|
|
- `Other` - Catch-all for uncommon errors
|
|
|
|
| Variant | Message | Description |
|
|
|---------|---------|-------------|
|
|
| `Io` | IO error: {0} | Io errors |
|
|
| `Parsing` | Parsing error: {message} | Parsing errors |
|
|
| `Ocr` | OCR error: {message} | Ocr errors |
|
|
| `Validation` | Validation error: {message} | Validation errors |
|
|
| `Cache` | Cache error: {message} | Cache errors |
|
|
| `ImageProcessing` | Image processing error: {message} | Image processing errors |
|
|
| `Serialization` | Serialization error: {message} | Serialization errors |
|
|
| `MissingDependency` | Missing dependency: {0} | Missing dependency errors |
|
|
| `Plugin` | Plugin error in '{plugin_name}': {message} | Plugin errors |
|
|
| `LockPoisoned` | Lock poisoned: {0} | Lock poisoned errors |
|
|
| `UnsupportedFormat` | Unsupported format: {0} | Unsupported format errors |
|
|
| `Embedding` | Embedding error: {message} | Embedding errors |
|
|
| `Timeout` | Extraction timed out after {elapsed_ms}ms (limit: {limit_ms}ms) | Timeout errors |
|
|
| `Cancelled` | Extraction cancelled | Cancelled errors |
|
|
| `Security` | Security violation: {message} | Security errors |
|
|
| `Other` | {0} | Other errors |
|
|
|
|
---
|