+ hBc s^RIt^RIHt^RIHtHtHtHtRt !RR]P4t ]^,t ^t ^t^t!R R]P 4tRR RR RR RR RRR/RlltR# ]d!RR4tLmi;i)N)PathLikecs]tRt^tRtR#)rN)__name__ __module__ __qualname____firstlineno____static_attributes__r6/usr/lib64/python3.14/site-packages/pyzstd/zstdfile.pyrrs rr)ZstdCompressorZstdFileReaderZstdFileWriter_ZSTD_DStreamSizesZstdFilecsdaa]tRt^toRtRtV3RltRtRtRt Rt Rt R R lt R t VtV;t#) ZstdDecompressReaderz*Adapt decompressor to RawIOBase reader APIcs4Wn\WW44VnR#N)_fpr _decomp)selfZfp zstd_dictoption read_sizes&&&&&r __init__ZZstdDecompressReader.__init__s%bVG rcs.<RVn\SV` 4#r)rZsuperclose)r __class__s&r rZZstdDecompressReader.closes w}rcsR#)Trr&r readableZZstdDecompressReader.readablesrc6VPP4#r)rseekablerrr rZZstdDecompressReader.seekablesxx  ""rcs.VPP#r)rposrrr tellZZstdDecompressReader.tell s||rcs8VPPV4#r)rreadintorb&&r r!ZZstdDecompressReader.readinto#s||$$Q''rcrr)rreadallrrr r%ZZstdDecompressReader.readall&s||##%%rcsV^8XdMV^8XdVPPV,pMuV^8XdUVPP^8dVPPR4VPPV,pM\ RP V44hWPP8dYRVPn^VPnVPP4VPP^4MWPP,pVPPV4VPP#)rNzInvalid whence value: {}F) rrsizeZforward ValueErrorformatZeofZ reset_sessionrseekrZoffsetZwhence&&&r r)ZZstdDecompressReader.seek+s Q;  q[\\%%.F q[||  1$ $$T*\\&&/F7>>vFG G LL$$ $$DLL  DLL  LL & & ( HHMM!  ll&& &F V$||r)rr)r)rrrr__doc__rrrrr r!r%r)r__classdictcell__Z __classcell__)r __classdict__s@@r rrs64H# (&   rrc s&a]tRt^MtoRt]P t]Pt]t RRRRRRRRR/R llt R t RR lt R t ]3R ltR RltR RltRtRtR Rlt]P*3RltR RltRtRtRtRt]R4tRtRtRt Rt!Vt"R#)!raJA file object providing transparent zstd (de)compression. A ZstdFile can act as a wrapper for an existing file object, or refer directly to a named file on disk. Note that ZstdFile provides a *binary* file interface - data read is returned as bytes, and data to be written should be an object that supports the Buffer Protocol. level_or_optionNrr write_sizec sRVnRVn\VnVR9dF\ V\ R4\ 34'g \R4hVR8wd \R4h\pMkVR9dK\ V\ R4\\ 34'g \R4hVR8wd \R4h\pM\R PV44h\ V\\\34'd4R V9d VR , p\ P"!W4VnR VnM6\%VR 4'g\%VR 4'dWnM \R4hWpnV\8XdBVP'VPVVVR7p\ P(!V\*4VnR#V\8Xd(^Vn\1VPVVVR7VnR#R#)aOpen a zstd compressed file in binary mode. 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. 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. NFzIn read mode (decompression), level_or_option argument should be a dict object, that represents decompression option. It doesn't support int type compression level in this case.r2z1write_size argument is only valid in write modes.z6level_or_option argument should be int or dict object.r0z.read_size argument is only valid in read mode.zInvalid mode: {!r}r#Treadwritez6filename must be a str, bytes, file or PathLike object)rrr)r/rr1)rrb)ZwZwbZaZabZxZxb)r_closefp _MODE_CLOSED_modeZ isinstanceZtypeZdictZ TypeErrorr' _MODE_READZint _MODE_WRITEr(ZstrZbytesrioopenhasattr _READER_CLASSZBufferedReader_ZSTD_DStreamOutSize_buffer_posr _writer) rfilenamemoder/rrr1Z mode_codeZraws &&&$$$$ r rZZstdFile.__init__\s: !  ; oT D/ABB%'' V# GII"I 6 6oT C/FGG"ACCF" DFF#I188>? ? heX 6 7 7$ wwx.DH DM Xv & &'(G*D*DH79 9    "$$ HH&/#2&/ %1C ,,S2FGDL + %DI) HH,;&/'1 3DL&rc sVP\8XdR#\VR4'd$VPP 4RVnM5\VR4'd$VP VP 4RVnVP'dVPP 4RVn RVn\VnR# RTni;i RTni;i RTn RTn\Tni;i TP'dTPP 4RTn RTn\Tni RTn RTn\Tni;i;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. NrArCF) r9r8r>rArflush FLUSH_FRAMErCr7rrrr rZZstdFile.closes :: %  *tY''(LL&&($(DLy))(JJt//0$(DL *===HHNN$ % ) $(DL $(DL   % )  *===HHNN$ % )   % ) s^DC D!C<D,C# CD C  D#C>E',E /E' E$$E'cs VP\8Xd \R4hV\8Xd.VP\8wd\P !R4hhV\ 8Xd,VP\ 8wd\P !R4hh)zI/O operation on closed filezFile not open for readingzFile not open for writing)r9r8r'r:r<ZUnsupportedOperationr;)rZ expected_moder$r _check_modeZZstdFile._check_modesy :: %;< < J &zzZ'--.IJJ(  k )zz[(--.IJJ rc sVPPV4wr#V;P X, unV# \dTP\4L=i;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. )rCr4AttributeErrorrHr;rB)rZdataZ input_sizeZ_s&& r r4ZZstdFile.writesR * LL..t4MJ Z   *   [ ) *s: AAc sVP\8wd(VP\8XdR#VP4VPP V4R#)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)r9r;r:rHrCrF)rrEr$r rFZZstdFile.flushsA :: $zzZ'     4 rc VfRpVPPV4# \dTP\4R#i;i)zRead up to size uncompressed bytes from the file. If size is negative or omitted, read until EOF is reached. Returns b"" if the file is already at EOF. N)rAr3rIrHr:rr&r$r r3Z ZstdFile.readsE <D )<<$$T* * )   Z ( )# AAc sV^8d\pVPPV4# \dTP \ 4R#i;i)zRead up to size uncompressed bytes, while trying to avoid making multiple reads from the underlying stream. Reads up to a buffer's worth of data if size is negative. Returns b"" if the file is at EOF. N)r@rAread1rIrHr:rLr$r rNZZstdFile.read1sG !8'D )<<%%d+ + )   Z ( )s* A Ac VPPV4# \dTP\4R#i;i)zBRead bytes into b. Returns the number of bytes read (0 for EOF). N)rAr!rIrHr:r"r$r r!ZZstdFile.readinto-s9  )<<((+ + )   Z ( ) AAc rO)zRead bytes into b, while trying to avoid making multiple reads from the underlying stream. Returns the number of bytes read (0 for EOF). N)rA readinto1rIrHr:r"r$r rQZZstdFile.readinto17s9  )<<))!, , )   Z ( )rPc rJ)zRead a line of uncompressed bytes from the file. The terminating newline (if present) is retained. If size is non-negative, no more than size bytes will be read (in which case the line may be incomplete). Returns b'' if already at EOF. NrK)rAreadlinerIrHr:rLr$r rRZZstdFile.readlineBsE <D )<<((. . )   Z ( )rMc sVPPW4# \dTP\4R#i;i)aChange the file position. The new position is specified by offset, relative to the position indicated by whence. Possible values for whence are: 0: start of stream (default): offset must not be negative 1: current stream position 2: end of stream; offset must not be positive Returns the new file position. Note that seeking is emulated, so depending on the arguments, this operation may be extremely slow. N)rAr)rIrHr:r*r+r r)Z ZstdFile.seekPs9 )<<$$V4 4 )   Z ( )rPc rO)zReturn buffered data without advancing the file position. Always returns at least one byte of data, unless at EOF. The exact number of bytes returned is unspecified. N)rApeekrIrHr:rLr$r rSZ ZstdFile.peekes9 )<<$$T* * )   Z ( )rPcsnVPV# \dTP\4T#i;ir)rArIrHr:rrr __iter__ZZstdFile.__iter__rs9 ) LL  )   Z (  )s  44csVVPP4pV'dV#\hr)rArRZ StopIteration)rZrets& r __next__ZZstdFile.__next__ys"ll##% Jrc sVP\8XdVPP4#VP\8Xd VP #VP 4R#)z!Return the current file position.N)r9r:rAr r;rBrHrrr r Z ZstdFile.tellsE :: #<<$$& & ZZ; &99  rc s|VPP4# \dTP4R#i;i)z3Return the file descriptor for the underlying file.N)rfilenorIrHrrr rVZZstdFile.filenos3 88??$ $      s ;;c s(VP\8H#)zTrue if this file is closed.)r9r8rrr closedZZstdFile.closedszz\))rc VP\8XdR#VP\8XdR#VP4R#)z/Return whether the file was opened for writing.TFN)r9r;r:rHrrr writableZZstdFile.writables. :: $ ZZ: % rc rX)z/Return whether the file was opened for reading.TFN)r9r:r;rHrrr rZZstdFile.readables. :: # ZZ; & rc sVP\8XdVPP4#VP\8XdR#VP 4R#)z)Return whether the file supports seeking.FN)r9r:rArr;rHrrr rZZstdFile.seekables> :: #<<((* * ZZ; & r)rAr7rr9rBrC)r5r)rK)#rrrrr,r Z FLUSH_BLOCKrGrr?rrrHr4rFr3rNr!rQrRr<ZSEEK_SETr)rSrTrUr rVZpropertyrWrYrrrr-)r.s@r rrMs!,,K ,,K(MW3!%W315W3!W3.4W3r*D"$%!. ) )) ) )#%++)* ) **rr/rencodingerrorsnewlinecsRV9dRV9d\RV: 24hM-Ve \R4hVe \R4hVe \R4hVPRR4p\WW#R7pRV9d\P!WWV4#V#) aOpen a zstd compressed file in binary or text mode. 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. The mode parameter can be "r", "rb" (default), "w", "wb", "x", "xb", "a", "ab" for binary mode, or "rt", "wt", "xt", "at" for text mode. The level_or_option and zstd_dict parameters specify the settings, as for ZstdCompressor, ZstdDecompressor and ZstdFile. When using read mode (decompression), the level_or_option parameter can only be a dict object, that represents decompression option. It doesn't support int type compression level in this case. For binary mode, this function is equivalent to the ZstdFile constructor: ZstdFile(filename, mode, ...). In this case, the encoding, errors and newline parameters must not be provided. For text mode, an ZstdFile object is created, and wrapped in an io.TextIOWrapper instance with the specified encoding, error handling behavior, and line ending(s). Ztr#zInvalid mode: z0Argument 'encoding' not supported in binary modez.Argument 'errors' not supported in binary modez/Argument 'newline' not supported in binary modeZ)r/r)r'Zreplacerr<Z TextIOWrapper) rDrEr/rrZr[r\Z zstd_modeZ binary_files &&$$$$$ r r=r=s6 d{ $;49: :   OP P  MN N  NO O S"%I8+:QK d{ vGGr)rr=)r6)r<ZosrZ ImportErrorZpyzstdr r r r Z__all__Z RawIOBaserr@r8r:r;ZBufferedIOBaserr=rrr r]s   66 7 2<<7 r*!,   er  eR ----#--1-e     sA&&A:9A: