+ Brh7"RtRt^RIt^RIt^RIHtHtHtHtHtH t ^RI H t H t H t .]!]P^d,^d4O]P^d,N5t]P"t!RR4tR tR tR tRR ltRR lt!RR]P24t!RR]P24t!RR]P24t]P:!]]4R#)zGPython bindings to the Zstandard (zstd) compression library (RFC-8878).CompressionParameterDecompressionParameterStrategyN)ZstdCompressorZstdDecompressorZstdDict ZstdErrorget_frame_size zstd_version)ZstdFileopen_nbytescFaa]tRt^,toRtRtV3RltRtRtRt Vt V;t #) FrameInfoz$Information about a Zstandard frame.cH<\SV`RV4\SV`RV4R#)decompressed_size dictionary_idN)super __setattr__)selfrr __class__s&&&6/usr/local/lib/python3.14/compression/zstd/__init__.py__init__FrameInfo.__init__1s# /1BC O];c<RVP RVP R2#)zFrameInfo(decompressed_size=z, dictionary_id=)rrrs&r__repr__FrameInfo.__repr__5s..t/E/E.FG!!%!3!3 4A7 8rc \RV: 24h)zcan't set attribute )AttributeError)rname_s&&&rrFrameInfo.__setattr__9s3D8<==rr) __name__ __module__ __qualname____firstlineno____doc__ __slots__rrr__static_attributes____classdictcell__ __classcell__)r __classdict__s@@rrr,s!.4I<8>>rrc<\\P!V4!#)ayGet Zstandard frame information from a frame header. *frame_buffer* is a bytes-like object. It should start from the beginning of a frame, and needs to include at least the frame header (6 to 18 bytes). The returned FrameInfo object has two attributes. 'decompressed_size' is the size in bytes of the data in the frame when decompressed, or None when the decompressed size is unknown. 'dictionary_id' is an int in the range (0, 2**32). The special value 0 means that the dictionary ID was not recorded in the frame header, the frame may or may not need a dictionary to be decoded, and the ID of such a dictionary is not specified. )r_zstdget_frame_info) frame_buffers&rr3r3=s e**<8 99rcr\V\4'g&\V4Pp\ RV: R24h\ V4pRP V4p\ ;QJd.RV4FNK 5M !RV44pV'g \R4h\P!W4V4p\V4#)zReturn a ZstdDict representing a trained Zstandard dictionary. *samples* is an iterable of samples, where a sample is a bytes-like object representing a file. *dict_size* is the dictionary's maximum size, in bytes. z%dict_size must be an int object, not .rc38"TFp\V4xK R#5iNr .0samples& r train_dict..\>gFgz2samples contained no data; can't train dictionary.) isinstanceinttyper) TypeErrortuplejoin ValueErrorr2 train_dictr)samples dict_sizeds_clschunks chunk_sizes dict_contents&& rrHrHNs i % %i--?zKLLGnG XXg F%>g>%%>g>>K MNN##FCL L !!rc\V\4'g \R4h\V\4'g \R4h\V\4'g \R4h\ V4pRP V4p\;QJd.RV4FNK 5M !RV44pV'g \ R4h\P!VPVWRV4p\V4#)aReturn a ZstdDict representing a finalized Zstandard dictionary. Given a custom content as a basis for dictionary, and a set of samples, finalize *zstd_dict* by adding headers and statistics according to the Zstandard dictionary format. You may compose an effective dictionary content by hand, which is used as basis dictionary, and use some samples to finalize a dictionary. The basis dictionary may be a "raw content" dictionary. See *is_raw* in ZstdDict. *samples* is an iterable of samples, where a sample is a bytes-like object representing a file. *dict_size* is the dictionary's maximum size, in bytes. *level* is the expected compression level. The statistics for each compression level differ, so tuning the dictionary to the compression level can provide improvements. z/zstd_dict argument should be a ZstdDict object.z+dict_size argument should be an int object.z'level argument should be an int object.rc38"TFp\V4xK R#5ir8r9r:s& rr= finalize_dict..r?r@z=The samples are empty content, can't finalize the dictionary.) rArrDrBrErFrGr2 finalize_dictrN) zstd_dictrIrJlevelrLrMrNs"&&& rrRrRcs& i * *IJJ i % %EFF eS ! !ABBGnG XXg F%>g>%%>g>>K '( (&&y'='=v'2uFL L !!rc^\WVR7pVPV\PR7#)aReturn Zstandard compressed *data* as bytes. *level* is an int specifying the compression level to use, defaulting to COMPRESSION_LEVEL_DEFAULT ('3'). *options* is a dict object that contains advanced compression parameters. See CompressionParameter for more on options. *zstd_dict* is a ZstdDict object, a pre-trained Zstandard dictionary. See the function train_dict for how to train a ZstdDict on sample data. For incremental compression, use a ZstdCompressor instead. )rToptionsrS)mode)rcompress FLUSH_FRAME)datarTrVrScomps&&&& rrXrXs) ) LD ==N$>$>= ??rc.p\W!R7pVPVPV44VP'g \ R4hVP pV'dK`RP T4#)aDecompress one or more frames of Zstandard compressed *data*. *zstd_dict* is a ZstdDict object, a pre-trained Zstandard dictionary. See the function train_dict for how to train a ZstdDict on sample data. *options* is a dict object that contains advanced compression parameters. See DecompressionParameter for more on options. For incremental decompression, use a ZstdDecompressor instead. )rVrSzACompressed data ended before the end-of-stream marker was reachedr)rappend decompresseofr unused_datarF)rZrSrVresultsdecomps&&& rr^r^slG !'Gv((./zzz?@ @!!t  88G rca]tRt^toRt]P t]Pt ]Pt ]Pt ]Pt]P t]P$t]P(t]P,t]P0t]P4t]P8t]P<t]P@t!]PDt#]PHt%]PLt']PPt)]PTt+Rt,Rt-Vt.R#)rzCompression parameters.c F\P!VPRR7#)zqReturn the (lower, upper) int bounds of a compression parameter. Both the lower and upper bounds are inclusive. T is_compressr2get_param_boundsvaluers&rboundsCompressionParameter.boundss %%djjdCCrr&N)/r'r(r)r*r+r2ZSTD_c_compressionLevelcompression_levelZSTD_c_windowLog window_logZSTD_c_hashLoghash_logZSTD_c_chainLog chain_logZSTD_c_searchLog search_logZSTD_c_minMatch min_matchZSTD_c_targetLength target_lengthZSTD_c_strategystrategy!ZSTD_c_enableLongDistanceMatchingenable_long_distance_matchingZSTD_c_ldmHashLog ldm_hash_logZSTD_c_ldmMinMatch ldm_min_matchZSTD_c_ldmBucketSizeLogldm_bucket_size_logZSTD_c_ldmHashRateLogldm_hash_rate_logZSTD_c_contentSizeFlagcontent_size_flagZSTD_c_checksumFlag checksum_flagZSTD_c_dictIDFlag dict_id_flagZSTD_c_nbWorkers nb_workersZSTD_c_jobSizejob_sizeZSTD_c_overlapLog overlap_logrjr-r.r0s@rrrs!55''J##H%%I''J%%I--M$$H$)$K$K!**L,,M773344--M**L''J##H))KDDrcBa]tRt^toRt]P tRtRt Vt R#)rzDecompression parameters.c F\P!VPRR7#)zsReturn the (lower, upper) int bounds of a decompression parameter. Both the lower and upper bounds are inclusive. Frergrs&rrjDecompressionParameter.boundss %%djjeDDrr&N) r'r(r)r*r+r2ZSTD_d_windowLogMaxwindow_log_maxrjr-r.rs@rrrs#..NEErc]tRt^tRt]P t]Pt ]Pt ]Pt ]Pt]P t]P$t]P(t]P,tRtR#)rzCompression strategies, listed from fastest to strongest. Note that new strategies might be added in the future. Only the order (from fast to strong) is guaranteed, the numeric value might change. r&N)r'r(r)r*r+r2 ZSTD_fastfast ZSTD_dfastdfast ZSTD_greedygreedy ZSTD_lazylazy ZSTD_lazy2lazy2 ZSTD_btlazy2btlazy2 ZSTD_btoptbtopt ZSTD_btultrabtultra ZSTD_btultra2btultra2r-r&rrrrsh ??D   E   F ??D   E  G   E  G""Hr)COMPRESSION_LEVEL_DEFAULTrXrr^rrRr3rrHr r r r zstd_version_inforrrr)NNN)NN)r+__all__r2enumrrrrr r compression.zstd._zstdfiler r r divmodzstd_version_numberrZSTD_CLEVEL_DEFAULTrrr3rHrRrXr^IntEnumrrrset_parameter_typesr&rrrsM 4 11>>6fU66#=sC6..46H!55A>>":""*""J @ .D4<<DD ET\\ E#t||#(.0FGr