+ hhcs^RIHt^RIHt^RIHt^RIHt^RIHt^RI H t H t H t H t HtHtHtRt!R R]4tR tR t!R R 4t!RR] 4t!RR] 4tR#))array) bisect_right)isfile)Struct)warn)ZstdDecompressReaderZstdFile _MODE_CLOSED _MODE_READ _MODE_WRITEPathLikeioSeekableFormatErrorSeekableZstdFilecs6aa]tRt^ toRtV3RltRtVtV;t#)r z.An error related to Zstandard Seekable Format.cs4<\SV`RV,4R#)z!Zstandard Seekable Format error: N)super__init__)selfmsg __class__s&&?/usr/lib64/python3.14/site-packages/pyzstd/seekable_zstdfile.pyrZSeekableFormatError.__init__s C%c* * A26..2G2G2O/ < : %KC &c* *  "   " "G()C&c* * ---R1 !M$>>  '%(GI I %%q)''"67++OQ? - "Z /=C%c* * !3 3;C%c* *  GGAJ'C!!!OO//H=!2H" OO//H3!2! !#(9Q(>-034*#..   o/@ A  5#??$'*+*#..3(8    < <%&NO O!5rcsvV^8d^p\VPV4pW P^,8wdV#R#r3)rr/r+)rposis&& r index_by_dposZSeekTable.index_by_dposs; 7C // 5 ""Q& &HrcsjVPV^, ,VPV^, ,3#)i)r.r/)rrEr'rget_frame_sizesZSeekTable.get_frame_sizess0&&qs+&&qs+- -rcVP#r#)r,r1r2rget_full_c_sizeZSeekTable.get_full_c_size   rcrHr#)r-r1r2rget_full_d_sizeZSeekTable.get_full_d_sizerJrcsVPV8:dR#VPp\VPV4wr4VP4^p\ V4FwpY6V8d^M^,^,p^p^p \ WUV,^4F(p WV ,, pWV ^,,, p K* VP W4WW, pKy R#r#)r+r0Zdivmodr%r>r7) rZ max_framesZarraZbrDrEZlengthZc_sizeZd_sizeZjs && r _merge_framesZSeekTable._merge_framess    + lld((*5  z"AA11-2FFF3F A.a& ac("/   f - MC#rc sVPR8d4\RVP,\^4VPR4^p^^VP,,p\ V4pVP P WBRV^, 4V^, p\^\VP4^4FRpVP P WBVPV,VPV^,,4V^, pKT VPP WBVP^R4VPV4R#)lzSeekableZstdFile's seek table has %d entries, which exceeds the maximal value allowed by Zstandard Seekable Format (0xFFFFFFFF). The entries will be merged into 0xFFFFFFFF entries, this may reduce seeking performance.r9r8N) r+rRuntimeWarningrMZ bytearrayr=Z pack_intor>Zlenr0r;write)rr@rBsizeZbarEs&& rwrite_seek_tableZSeekTable.write_seek_tables    * 9=A rcsR#)Trr1r2rrYZ!SeekableDecompressReader.seekableFsrcslV^8XdMdV^8XdVPPV,pM?V^8XdVPPV,pM\RP V44hVP P V4pVf|RVPnVPPVPnVPPVP P4VPP#VP P VPP4pVP PV4wrVW48Xd;WPP8d!VPP4V8dMVRVPnW`PnVPP4VPPV4WPP,pVPPV4VPP#)rzInvalid value for whence: {}TF)r_rDrPr4Zformatr^rFZeof_fpr:rSrGtellZ reset_sessionZforward)rrBZwhenceZ new_frameZ old_frameZc_posZd_poss&&& rr:ZSeekableDecompressReader.seekKs Q;  q[\\%%.F q[\\&&/F;BB6JK K$$226:  #DLL #||00DLL  HHMM$**44 5<<## #$$224<<3C3CD ''77 B   ! \\%% % 88==?e #  %DLL $LL  LL & & ( HHMM%  ,,""" V$||rcs6VPP4#r#)r^rUr1r2rget_seek_table_infoZ,SeekableDecompressReader.get_seek_table_infozs((**r)r^)r) rrrrrrYr:rdrrrrr!rrWrW(s?: - ^++rrWc saa]tRtRtoRtRtRt]tRRRRRRRRR R R/V3R lllt R t V3R lt Rt ] P3Rlt]R4t]R4tRtVtV;t#)rizThis class can only create/write/read Zstandard Seekable Format file, or read 0-size file. It provides relatively fast seeking ability in read mode. level_or_optionNr`rai write_sizeimax_frame_content_sizec  s<RVnRVnRVn\VnVR 9dVR8wd \ R4hEM$VR9Ed^Tu;8dVP 8:g!M\ RVP V3,4hWpnVP4\RR7Vn VR9d\V\\\34'g \R4h\!V4'dy\"P$!VR4;_uu_4p\'VR4'dVP)4'g \R 4hVPP+VRR 7RRR4\,S V`]WVVVVR 7VR9dVPP)4'dOVPP1VPP344VPP54M\VPP7VPP8^4\;R VPP8,\<^4VP\>8HVnR# +'giEL;i)a-Open a Zstandard Seekable Format file in binary mode. In read mode, the file can be 0-size file. filename can be either an actual file name (given as a str, bytes, or PathLike object), in which case the named file is opened, or it can be an existing file object to read from or write to. mode can be "r" for reading (default), "w" for (over)writing, "x" for creating exclusively, or "a" for appending. These can equivalently be given as "rb", "wb", "xb" and "ab" respectively. In append mode ("a" or "ab"), filename argument can't be a file object, please use file path. Parameters level_or_option: When it's an int object, it represents compression level. When it's a dict object, it contains advanced compression parameters. Note, in read mode (decompression), it can only be a dict object, that represents decompression option. It doesn't support int type compression level in this case. zstd_dict: A ZstdDict object, pre-trained dictionary for compression / decompression. read_size: In reading mode, this is bytes number that read from the underlying file object each time, default value is zstd's recommended value. If use with Network File System, increasing it may get better performance. write_size: In writing modes, this is output buffer's size, default value is zstd's recommended value. If use with Network File System, increasing it may get better performance. max_frame_content_size: In write/append modes (compression), when the uncompressed data size reaches max_frame_content_size, a frame is generated automatically. If the size is small, it will increase seeking speed, but reduce compression ratio. If the size is large, it will reduce seeking speed, but increase compression ratio. You can also manually generate a frame using f.flush(f.FLUSH_FRAME). FNrbzKmax_frame_content_size argument is only valid in write modes (compression).zPmax_frame_content_size argument should be 0 < value <= %d, provided value is %d.rZzIn append mode ('a', 'ab'), SeekableZstdFile.__init__() method can't accept file object as filename argument. Please use file path (str/bytes/PathLike).rYz^In SeekableZstdFile's append mode ('a', 'ab'), the opened 'rb' file object should be seekable.r[)rer`rarfa0SeekableZstdFile is opened in append mode ('a', 'ab'), but the underlying file object is not seekable. Therefore the seek table (a zstd skippable frame) at the end of the file can't be overwritten. Each time open such file in append mode, it will waste some storage space. %d bytes were wasted this time.)rrh@)ZwZwbrLabZxZxb)rLrk) _write_in_closerb_closefpr_moder4FRAME_MAX_D_SIZE_max_frame_content_size_reset_frame_sizesr"r^ isinstancestrbytesr r]rr openr\rYrCrrr:rIZtruncater7rRrrNr ) rfilenamemoderer`rarfrgZfrs &&&$$$$$ rrZSeekableZstdFile.__init__s6R % ! ; %7 #HJJ86 6.G$2G2GG >**,BCDEE ,B (  # # %(59D {"!(S%,BCC#JLL(##400A&q*55QZZ\\"+">#@@((88e8L 1 )8#,#,$.  0 ; xx  "" d..>>@A!!#  --((88!=?((889$Q(!% k 9I100s(I 1(I  I1 csD^Vn^VnVPVnR#r3)_current_c_size_current_d_sizerp _left_d_sizer1r2rrqZ#SeekableZstdFile._reset_frame_sizess    88rc s4<VP'dIVPVP4VPP VP 4RVnRVn\ SV`4R# RTni;i RTn\ ST`4i;i)zFlush and close the file. May be called more than once without error. Once the file is closed, any other operation on it will raise a ValueError. FN)rlflush FLUSH_FRAMEr^rQrbrclose)rrs&rr}ZSeekableZstdFile.closes ###1JJt//0$$55dhh?,1D( $D  GMO ,1D( $D  GMOs#BAA4B4 A==BBc  s\VP\8wdVP\4\V4;_uu_4q"P R4;_uu_4pVP p^pV^8d\ W@P4pVPPW5WV,4wrxV;PV, un WV, pWF,pV;PV, un V;PV, un V;PV,unVP^8XgVPVP8gKVPVP4EKVuuRRR4uuRRR4# +'giM;iRRR4R# +'giR#;i)zWrite a bytes-like object to the file. Returns the number of uncompressed bytes written, which is always the length of data in bytes. Note that due to buffering, the file on disk may not reflect the data written until .flush() or .close() is called. ZBN)rnr _check_modeZ memoryviewZcastnbytesZminrz_writerrOZ_posrxryFRAME_MAX_C_SIZEr{r|) rZdataZviewZ byte_viewrrDrf_ output_sizes && rrOZSeekableZstdFile.writes1 :: $   [ )  yy~~%%FC1* ):):; "&!3!3(1cn(E"G Z' !$$$ 3$$$ 2$!!Z/!$$)''4+@+@@JJt//0E(6~  ~~    s*FC-E= E= ( F= F F F+ c sVP\8wd(VP\8XdR#VP4VPP V4wr#V;P V, unWP8XdVVP ^8wdCVPPVP VP4VP4R#R#R#)aoFlush remaining data to the underlying stream. The mode argument can be ZstdFile.FLUSH_BLOCK, ZstdFile.FLUSH_FRAME. Abuse of this method will reduce compression ratio, use it only when necessary. If the program is interrupted afterwards, all data can be recovered. To ensure saving to disk, also need to use os.fsync(fd). This method does nothing in reading mode. N) rnr r r~rr{rxr|r^r7ryrq)rrwrrs&& rr{ZSeekableZstdFile.flushIs :: $zzZ'    ++D1  + ## #   1 $    ) )$*>*>*.*>*> @  # # % % $rc sVP\8XdVPP4#VP\8Xd%VP P P4#R#)aJA tuple: (frames_number, compressed_size, decompressed_size) 1, Frames_number and compressed_size don't count the seek table frame (a zstd skippable frame at the end of the file). 2, In write modes, the part of data that has not been flushed to frames is not counted. 3, If the SeekableZstdFile object is closed, it's None. N)rnr r^rUr Z_bufferZrawrdr1r2rseek_table_infoZ SeekableZstdFile.seek_table_infotsO :: $##,,. . ZZ: %<<##779 9rc s|\V\\\34'd\P !VR4pRpMp\ VR4'dTVP4'd>\ VR4'd,VP4'dTpRpVP4pM \R4h\RR7pVPVRR7RpV'dVP4V#VPX4V# \dRpL=i;i T'dTP4iTPX4i;i) aCheck if a file is Zstandard Seekable Format file or 0-size file. It parses the seek table at the end of the file, returns True if no format error. filename can be either a file path (str/bytes/PathLike), or can be an existing file object in reading mode. rhTrXrYFzhfilename argument should be a str/bytes/PathLike object, or a file object that is readable and seekable.rZr[)rrrsrtr r rur\rXrYrcr]r"rCr r}r:)rvr@Z is_file_pathZorig_posZtableZrets& ris_seekable_format_fileZ(SeekableZstdFile.is_seekable_format_files heX 6 7 74(BL Xz * *x/@/@/B/B Xz * *x/@/@/B/BB LwwyHCE E E* "  ! !" ! 6C  ! # C   !s*9C< D< D  D D  D,D;) rmrxryrbrzrprnr^rllrj)ri)rrrrrrrorWZ _READER_CLASSrrqr}rOrZ FLUSH_BLOCKr{rVrZ staticmethodrrrrrr!rrrs (',Mo;!%o;15o;!o;.4o;)7o;o;b9 (/b"--)&V &&&rN)r r)rZbisectrZos.pathrZstructrZwarningsrZpyzstd.zstdfilerrrr r r r Z__all__Z Exceptionr rr<r"rWrrrrrss))) 6D)D  E*}#}#~S+3S+rkxkr