!xjeZddlmZddlmZddlmZmZmZmZm Z GddZ dZ dS))suppress)Lock) ZstdError _check_int_DictionaryType_ffi_libceZdZdZdddZdZdZedZedZ ed Z ed Z ed Z d Z d ZdZdS)ZstdDictaRepresents a Zstandard dictionary. dict_content The content of a Zstandard dictionary as a bytes-like object. is_raw If true, perform no checks on *dict_content*, useful for some advanced cases. Otherwise, check that the content represents a Zstandard dictionary created by the zstd library or CLI. The dictionary can be used for compression or decompression, and can be shared by multiple ZstdCompressor or ZstdDecompressor objects.F)is_rawct|dkrtdtj|_d|_t |_i|_t||_ tj tj |j t|j |_|s|jdkrtddSdS)NzGZstandard dictionary content too short (must have at least eight bytes)rzinvalid Zstandard dictionary)len ValueErrorrNULL_d_dict_dict_idr_lock_c_dictsbytes _dict_contentr ZSTD_getDictID_fromDict from_bufferdict_id)self dict_contentr s NC:\Projects\Historical\venv\Lib\site-packages\backports/zstd/_cffi/zstddict.py__init__zZstdDict.__init__s |  q 3  y  VV  "<004  T/ 0 0#d6H2I2I    =$,!++;<< < = =++c>d|jt|jfzS)Nz")rrrrs r__repr__zZstdDict.__repr__4s'3 M " # #7   rc*t|jSN)rrr!s r__len__zZstdDict.__len__:s4%&&&rc|jS)z9The content of a Zstandard dictionary, as a bytes object.)rr!s rrzZstdDict.dict_content=s !!rc|jS)aThe Zstandard dictionary, an int between 0 and 2**32. A non-zero value represents an ordinary Zstandard dictionary, conforming to the standardised format. A value of zero indicates a 'raw content' dictionary, without any restrictions on format or content.)rr!s rrzZstdDict.dict_idBs }rc|tjfS)aLoad as a digested dictionary to compressor. Pass this attribute as zstd_dict argument: compress(dat, zstd_dict=zd.as_digested_dict) 1. Some advanced compression parameters of compressor may be overridden by parameters of digested dictionary. 2. ZstdDict has a digested dictionaries cache for each compression level. It's faster when loading again a digested dictionary with the same compression level. 3. No need to use this for decompression.)rDICT_TYPE_DIGESTEDr!s ras_digested_dictzZstdDict.as_digested_dictMs_777rc|tjfS)aLoad as an undigested dictionary to compressor. Pass this attribute as zstd_dict argument: compress(dat, zstd_dict=zd.as_undigested_dict) 1. The advanced compression parameters of compressor will not be overridden. 2. Loading an undigested dictionary is costly. If load an undigested dictionary multiple times, consider reusing a compressor object. 3. No need to use this for decompression.)rDICT_TYPE_UNDIGESTEDr!s ras_undigested_dictzZstdDict.as_undigested_dict\s_999rc|tjfS)aLoad as a prefix to compressor/decompressor. Pass this attribute as zstd_dict argument: compress(dat, zstd_dict=zd.as_prefix) 1. Prefix is compatible with long distance matching, while dictionary is not. 2. It only works for the first frame, then the compressor/decompressor will return to no prefix state. 3. When decompressing, must use the same prefix as when compressing.)rDICT_TYPE_PREFIXr!s r as_prefixzZstdDict.as_prefixjs_555rc(|j5|j|}|Vtj|jt |j|}|tjkrtd||j|<dddn #1swxYwY|S)NzIFailed to create a ZSTD_CDict instance from Zstandard dictionary content.) rrgetr ZSTD_createCDictrrrrr)rcompression_levelcdicts r _get_cdictzZstdDict._get_cdictxs Z 9 9M%%&788E}-&D,>(?(?ARDI%%#849 /0 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 sA3BB B c&|j5|jtjkrUt j|jt|j|_|jtjkrtd|jcdddS#1swxYwYdS)NzIFailed to create a ZSTD_DDict instance from Zstandard dictionary content.) rrrrr ZSTD_createDDictrrrr!s r _get_ddictzZstdDict._get_ddicts Z |ty((#4&D,>(?(?   <49,,#8 < sA1BB  B ctt5|jD]-\}}t j|t j|j|<. dddn #1swxYwYtt5|jt jkr*t j |jt j|_ddddS#1swxYwYdSr$) rAttributeErrorritemsr ZSTD_freeCDictrrrZSTD_freeDDict)rlevelr5s r__del__zZstdDict.__del__sL n % % 1 1 $ 3 3 5 5 1 1 u#E***'+y e$$ 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 n % % ) )|ty((#DL111#y  ) ) ) ) ) ) ) ) ) ) ) ) ) ) ) ) ) )s%AA**A.1A. ACCCN)__name__ __module__ __qualname____doc__rr"r%propertyrrr*r-r0r6r9r@rrr r s B B05=====4   '''""X"X 8 8X 8 : :X : 6 6X 6     ) ) ) ) )rr cpt|tr||fSt|trzt|dkrg|\}}t|trMt|tr8t ||t jt jt j fvr||fStd)Nz/zstd_dict argument should be a ZstdDict object.) isinstancer tuplerintrrr)r,r/ TypeError)zd default_typetype_s r_Py_parse_zstd_dictrPs"h <"e !RA E b( # # ! 5#(>(> ! u   240 5y  E F FFrN) contextlibr threadingrbackports.zstd._cffi._commonrrrrr r rPrFrrrTsS)S)S)S)S)S)S)S)lGGGGGr