chunklet.exceptions

Classes:

• CallbackError –

  Raised when a callback function provided to chunker

• ChunkletError –

  Base exception for chunking and splitting

• FileProcessingError –

  Raised when a file cannot be loaded, opened, or

• InvalidInputError –

  Raised when one or multiple invalid input(s) are

• MissingTokenCounterError –

  Raised when a token_counter is required but not

• TokenLimitError –

  Raised when max_tokens constraint is exceeded.

• UnsupportedFileTypeError –

  Raised when a file type is not supported for a given operation.

CallbackError

Bases: ChunkletError

Raised when a callback function provided to chunker or splitter fails during execution.

ChunkletError

Bases: Exception

Base exception for chunking and splitting operations.

FileProcessingError

Bases: ChunkletError

Raised when a file cannot be loaded, opened, or accessed.

InvalidInputError

Bases: ChunkletError

Raised when one or multiple invalid input(s) are encountered.

MissingTokenCounterError

MissingTokenCounterError(msg: str = '')

Bases: InvalidInputError

Raised when a token_counter is required but not provided.

Source code in src/chunklet/exceptions.py

def __init__(self, msg: str = ""):
    self.msg = msg or (
        "A token_counter is required for token-based chunking.\n"
        "💡 Hint: Pass a token counting function to the `chunk` method, like `chunker.chunk(..., token_counter=tk)`\n"
        "or configure it in the class initialization: `.*Chunker(token_counter=tk)`"
    )
    super().__init__(self.msg)

TokenLimitError

Bases: ChunkletError

Raised when max_tokens constraint is exceeded.

UnsupportedFileTypeError

Bases: FileProcessingError

Raised when a file type is not supported for a given operation.