Python 3.14+compression.zstdпонятие

compression.zstd.ZstdDict

словари

Словарь Zstandard — общий для сжатия и распаковки набор типичных фрагментов; передаётся параметром zstd_dict.

Синтаксис

compression.zstd.ZstdDict(dict_content, /, *, is_raw=False)

ZstdDict(content) ждёт обученный словарь с заголовком; для произвольных байтов нужен is_raw=True, и тогда dict_id равен 0. Содержимое короче 8 байт — ValueError. Свойства as_digested_dict и as_prefix меняют способ загрузки: as_prefix действует на один кадр и обязан передаваться и распаковщику тоже — без него ZstdError. Сам объект подходит и для compress, и для decompress, его можно переиспользовать.

Примеры

# Python 3.14+
from compression import zstd  # → ? нужна сборка CPython с libzstd
raw = zstd.ZstdDict(b'hello zstd hello zstd ', is_raw=True)
print(raw.dict_id)  # → 0
packed = zstd.compress(b'hello zstd!', zstd_dict=raw.as_prefix)
print(zstd.decompress(packed, zstd_dict=raw.as_prefix))  # → b'hello zstd!'
zstd.ZstdDict(b'short')  # → ValueError: Zstandard dictionary content too short (must have at least eight bytes)

См. также

Частые ошибки

Открыть в полном глоссарииdocs.python.orgСообщить о неточности