compression

class litestar.middleware.compression.CompressionFacade

Bases: Protocol

A unified facade offering a uniform interface for different compression libraries.

__init__(buffer: BytesIO, compression_encoding: CompressionEncoding | str, config: CompressionConfig) → None

Initialize CompressionFacade.

Parameters:

• buffer – A bytes IO buffer to write the compressed data into.

• compression_encoding – The compression encoding used.

• config – The app compression config.

close() → None

Close the compression stream.

Returns:

None

write(body: bytes | bytearray, final: bool = False) → None

Write compressed bytes to the buffer.

Parameters:

• body – The message body to process. Can be bytes or bytearray.

• final – Indicates whether this is the last chunk of data. If True, the compressor may flush any remaining internal buffers.

Returns:

None

encoding: ClassVar[str]

The encoding of the compression.

class litestar.middleware.compression.CompressionMiddleware

Bases: AbstractMiddleware

Compression Middleware Wrapper.

This is a wrapper allowing for generic compression configuration / handler middleware

__init__(app: ASGIApp, config: CompressionConfig) → None

Initialize CompressionMiddleware

Parameters:

• app – The next ASGI app to call.

• config – An instance of CompressionConfig.

create_compression_send_wrapper(send: Send, compression_encoding: Literal[CompressionEncoding.BROTLI, CompressionEncoding.GZIP, CompressionEncoding.ZSTD] | str, scope: Scope) → Send

Wrap send to handle brotli compression.

Parameters:

• send – The ASGI send function.

• compression_encoding – The compression encoding used.

• scope – The ASGI connection scope

Returns:

An ASGI send function.