compression

class litestar.middleware.compression.CompressionFacade

Bases: Protocol

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

encoding: ClassVar[str]

The encoding of the compression.

__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.

write(body: bytes) → None

Write compressed bytes.

Parameters:

body – Message body to process

Returns:

None

close() → None

Close the compression stream.

Returns:

None

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] | 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.