+ Brh/ ^RIt^RIHt^RIHtHtHt^RIHtRt ^t ^t ^t Rt !RR]P4tRRRR RR RR RR RR R/RlltR#)N)PathLike)ZstdCompressorZstdDecompressorZSTD_DStreamOutSize)_streamsZstdFilec\V\\34'd \V4#\ V4;_uu_4pVP uuRRR4# +'giR#;iN) isinstancebytes bytearraylen memoryviewnbytes)datmvs" 7/usr/local/lib/python3.14/compression/zstd/_zstdfile.py_nbytesr s;#y)**3x CByy s A A# c.a]tRt^toRt]P t]PtRRRRRRR/RlltRt Rt ]3R lt RR lt RR lt R tR tRRlt]P$3RltRRltRtRtRt]R4t]R4t]R4tRtRtRtRtVt R#)raDA file-like object providing transparent Zstandard (de)compression. A ZstdFile can act as a wrapper for an existing file object, or refer directly to a named file on disk. ZstdFile provides a *binary* file interface. Data is read and returned as bytes, and may only be written to objects that support the Buffer Protocol. levelNoptions zstd_dictc RVnRVn\VnRVn\ V\ 4'g \R4hVe"\ V\4'g \R4hVPR4pVR8XdVe \R4h\VnM`VR9dKVe"\ V\4'g \R4h\Vn\W4VR 7Vn^VnM\R V: 24h\ V\ \"\$34'd'\&P(!W R24VnR VnMDVR8Xd\+VR 4'gVR8wd\+VR 4'dWnM \R4hVP\8XdF\,P.!VP\0VVR7p\&P2!V4VnR#R#)aOpen a Zstandard compressed file in binary mode. *file* can be either an file-like object, or a file name to open. *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. *level* is an optional int specifying the compression level to use, or COMPRESSION_LEVEL_DEFAULT if not given. *options* is an optional dict for advanced compression parameters. See CompressionParameter and DecompressionParameter for the possible options. *zstd_dict* is an optional ZstdDict object, a pre-trained Zstandard dictionary. See train_dict() to train ZstdDict on sample data. NFzmode must be a strzoptions must be a dict or Nonebrzlevel is illegal in read modezlevel must be int or NonerrrInvalid mode: TreadwritezCfile must be a file-like object or a str, bytes, or PathLike object)rr>awx)_fp _close_fp _MODE_CLOSED_mode_bufferr str ValueErrordict TypeError removesuffix _MODE_READint _MODE_WRITEr _compressor_posr rioopenhasattrrDecompressReaderrBufferedReader)selffilemoderrrraws""&$$$ r__init__ZstdFile.__init__!s(!  $$$12 2  z'4'@'@<= =  % 3;  ?@@#DJ _ $ E3)?)? ;<<$DJ-E8A CD DI~dX67 7 dS%2 3 3wwtvQZ0DH!DNs{wtV44CKGD'$:$:HBC C :: #++ # C ,,S1DL $c VPfR#VP\8Xd6\VRR4'd"VPP 4RVnM7VP\ 8Xd#VPVP4RVn \VnVP'dVPP 4RVnRVn R# RTnRTn i;i \TnTP'dTPP 4RTnRTn i RTnRTn i;i;i)zFlush and close the file. May be called multiple times. Once the file has been closed, any other operation on it will raise ValueError. Nr'F) r#r&r-getattrr'closer/flush FLUSH_FRAMEr0r%r$r7s&rr@ZstdFile.close`s 88   'zzZ'4D11LL&&(#'DL{* 4++,#' %DJ '>>>HHNN$!& !& &DJ '>>>HHNN$!& !&s0BC.,CC+. E ;,D6'E 6EE c VP4\V4pVPPV4pVPP V4V;P V, unV#)aWrite a bytes-like object *data* 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. )_check_can_writerr0compressr#rr1)r7datalength compresseds"" rrZstdFile.writeysR %%..t4  z" V  r=c VP\8XdR#VP4WPVP09d \ R4hVP PV8XdR#VP PV4pVPPV4\VPR4'dVPP4R#R#)a_Flush remaining data to the underlying stream. The mode argument can be FLUSH_BLOCK or 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. NzSInvalid mode argument, expected either ZstdFile.FLUSH_FRAME or ZstdFile.FLUSH_BLOCKrA) r&r-_check_not_closed FLUSH_BLOCKrBr)r0 last_moderAr#rr4)r7r9rHs&& rrAZstdFile.flushs :: #   (($*:*:; ;45 5    % % - %%d+ t 488W % % HHNN  &r=c dVfRpVP4VPPV4#)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. )_check_can_readr'rr7sizes&&rr ZstdFile.reads/ <D ||  &&r=c rVP4V^8d\pVPPV4#)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. )rSrr'read1rTs&&rrXZstdFile.read1s3  !8'D||!!$''r=c XVP4VPPV4#)zBRead bytes into b. Returns the number of bytes read (0 for EOF). )rSr'readintor7rs&&rr[ZstdFile.readintos% ||$$Q''r=c XVP4VPPV4#)zRead bytes into b, while trying to avoid making multiple reads from the underlying stream. Returns the number of bytes read (0 for EOF). )rSr' readinto1r\s&&rr_ZstdFile.readinto1s% ||%%a((r=c XVP4VPPV4#)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. )rSr'readlinerTs&&rrbZstdFile.readlines% ||$$T**r=c XVP4VPPW4#)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. )rSr'seek)r7offsetwhences&&&rre ZstdFile.seeks' ||  00r=c XVP4VPPV4#)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. )rSr'peekrTs&&rrj ZstdFile.peeks% ||  &&r=cVVPP4;p'dV#\hr )r'rb StopIteration)r7rets& r__next__ZstdFile.__next__s%,,'') )3 )Jr=c VP4VP\8XdVPP 4#VP\ 8Xd VP #R#)z!Return the current file position.N)rMr&r-r'tellr/r1rCs&rrr ZstdFile.tellsH  :: #<<$$& & ZZ; &99 'r=c VVP4VPP4#)z3Return the file descriptor for the underlying file.)rMr#filenorCs&rruZstdFile.filenos  xx  r=cNVP4VPP#r )rMr#namerCs&rrx ZstdFile.name s  xx}}r=c4VP\8XdR#R#)wbrb)r&r/rCs&rr9 ZstdFile.modeszz[0t:d:r=c (VP\8H#)zTrue if this file is closed.)r&r%rCs&rclosedZstdFile.closedszz\))r=c fVP4;'dVPP4#)z)Return whether the file supports seeking.)readabler'seekablerCs&rrZstdFile.seekables#}}::4<<#8#8#::r=c HVP4VP\8H#)z/Return whether the file was opened for reading.)rMr&r-rCs&rrZstdFile.readables  zzZ''r=c HVP4VP\8H#)z/Return whether the file was opened for writing.)rMr&r/rCs&rwritableZstdFile.writable!s  zz[((r=)r'r$r0r#r&r1)r)rR)!__name__ __module__ __qualname____firstlineno____doc__rrNrBr;r@rrArrXr[r_rbr2SEEK_SETrerjrorrrupropertyrxr9rrrr__static_attributes____classdictcell__) __classdict__s@rrrs!,,K ,,K=2=2%)=259=2~'2"%4 ' (()+#%++1( ' ! ;;**;( ))r=rrrencodingerrorsnewlinec&RV9pVPRR4pV'dRV9d\RV: 24hM-Ve \R4hVe \R4hVe \R4h\WW#VR7p V'd\P!WWg4#V #) aOpen a Zstandard compressed file in binary or text mode. file can be either a 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, options, and zstd_dict parameters specify the settings the same as ZstdFile. When using read mode (decompression), the options parameter is a dict representing advanced decompression options. The level parameter is not supported in this case. When using write mode (compression), only one of level, an int representing the compression level, or options, a dict representing advanced compression options, may be passed. In both modes, zstd_dict is a ZstdDict instance containing a trained Zstandard dictionary. 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). trrz0Argument "encoding" not supported in binary modez.Argument "errors" not supported in binary modez/Argument "newline" not supported in binary moder)replacer)rr2 TextIOWrapper) r8r9rrrrrr text_mode binary_files "&$$$$$$ rr3r3's<t I <<R D $;~dX67 7   OP P  MN N  NO O4U%.0K vGGr=)rr3)r|)r2osr_zstdrrrcompression._commonr__all__r%r-r/r BaseStreamrr3r=rrst GG(    P)x""P)f2d2D2D22#2-12r=