T,3ikL^SSKrSSKrSSKJrJr "SS\5r\r"SS\R5r \ "\R5r \ Rr \ Rr\ R rSr\ \R&\R(S4S jrS rS rS rS rSr"SS\5r"SS\5rg)N)ffilibc\rSrSrSrSrg)errorz{ Raised whenever an error is encountered with compressing or decompressing data using brotlicffi. .. versionadded:: 0.5.1 N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r /lib/python3.13/site-packages/brotlicffi/_api.pyrrs   rrc`\rSrSrSr\R r\Rr \Rr Sr g)BrotliEncoderModezD Compression modes for the Brotli encoder. .. versionadded:: 0.5.0 r N) r r r r rrBROTLI_MODE_GENERICGENERICBROTLI_MODE_TEXTTEXTBROTLI_MODE_FONTFONTrr rrrrs.%%G   D   Drrc\[5nURU5nUR5 U$)zo Decompress a complete Brotli-compressed string. :param data: A bytestring containing Brotli-compressed data. ) Decompressor decompressfinish)datads rrrRs' A << DHHJ Krc.[UUUUS9nURU[R5n[R"UR 5[R :Xde[R"UR 5[R:XdeU$)a| Compress a string using Brotli. .. versionchanged:: 0.5.0 Added ``mode``, ``quality``, `lgwin``, ``lgblock``, and ``dictionary`` parameters. :param data: A bytestring containing the data to compress. :type data: ``bytes`` :param mode: The encoder mode. :type mode: :class:`BrotliEncoderMode` or ``int`` :param quality: Controls the compression-speed vs compression-density tradeoffs. The higher the quality, the slower the compression. The range of this value is 0 to 11. :type quality: ``int`` :param lgwin: The base-2 logarithm of the sliding window size. The range of this value is 10 to 24. :type lgwin: ``int`` :param lgblock: The base-2 logarithm of the maximum input block size. The range of this value is 16 to 24. If set to 0, the value will be set based on ``quality``. :type lgblock: ``int`` :returns: The compressed bytestring. :rtype: ``bytes`` )modequalitylgwinlgblock) Compressor _compressrBROTLI_OPERATION_FINISHBrotliEncoderIsFinished_encoder BROTLI_TRUEBrotliEncoderHasMoreOutput BROTLI_FALSE)rr"r#r$r% compressorcompressed_datas rcompressr0^sP  J !**41L1LMO  & &z':': ;s NN N &&z':':;s?O?OOO rcT[U5ng![a [SU-5ef=f)z" Validate that the mode is valid. z%s is not a valid encoder modeN)r ValueErrorrvals r_validate_moder5s1<$ <4s:;;SUs=::aS::dO [SU-5eg)z- Validate that the quality setting is valid. r z3%d is not a valid quality, must be between 0 and 11Nrr3s r_validate_qualityr9s) NN AC G   rc>SUs=::aS::dO [SU-5eg)z+ Validate that the lgwin setting is valid. z2%d is not a valid lgwin, must be between 10 and 24Nr8r3s r_validate_lgwinr=s% #OOH3NOO rcLUS:waSUs=::aS::dO [SU-5egg)z- Validate that the lgblock setting is valid. rr<z@%d is not a valid lgblock, must be either 0 or between 16 and 24Nr8r3s r_validate_lgblockr@s4 q2?? N   +rc[R"XU5nU[R:Xa [U5 OkU[R:Xa [ U5 OKU[R :Xa [U5 O+U[R:Xa [U5 O [S5eU[R:wa[SX#4-5eg)z This helper function sets a specific Brotli encoder parameter, checking the return code and raising :class:`Error ` if it is invalid. zUnexpected parameter!zError setting parameter %s: %dN) rBrotliEncoderSetParameterBROTLI_PARAM_MODEr5BROTLI_PARAM_QUALITYr9BROTLI_PARAM_LGWINr=BROTLI_PARAM_LGBLOCKr@ RuntimeErrorr+r)encoder parameterparameter_namer4rcs r_set_parameterrLs & &w3 ?BC)))s c.. .# c,, , c.. .#233  S__ ,/D D  rcv\rSrSrSrSrSr\\R\RS4Sjr Sr Sr \ rSrS rS rg) r&a An object that allows for streaming compression of data using the Brotli compression algorithm. .. versionadded:: 0.5.0 :param mode: The encoder mode. :type mode: :class:`BrotliEncoderMode` or ``int`` :param quality: Controls the compression-speed vs compression-density tradeoffs. The higher the quality, the slower the compression. The range of this value is 0 to 11. :type quality: ``int`` :param lgwin: The base-2 logarithm of the sliding window size. The range of this value is 10 to 24. :type lgwin: ``int`` :param lgblock: The base-2 logarithm of the maximum input block size. The range of this value is 16 to 24. If set to 0, the value will be set based on ``quality``. :type lgblock: ``int`` :param dictionary: A pre-set dictionary for LZ77. Please use this with caution: if a dictionary is used for compression, the same dictionary **must** be used for decompression! :type dictionary: ``bytes`` Nrc[R"[R[R[R5nU(d [ S5e[R "U[R 5n[U[RSU5 [U[RSU5 [U[RSU5 [U[RSU5 XPl g)Nz"Unable to allocate Brotli encoder!r"r#r$r%) rBrotliEncoderCreateInstancerNULLrGgcBrotliEncoderDestroyInstancerLrCrDrErFr*)selfr"r#r$r%encs r__init__Compressor.__init__s -- HHchh CD DffS#::; sC1164@sC44iIsC22GUCsC44iI rc [[R"[U5[U5S- -S-55n[R "S5nX4S'[R "SUS5n[R "SU5n[R "S[U55n[R "SU5n[R "SU5n [ R"URUUU UU[R5n U [ R:wa [S5eUS(aeX4S- n [R"X[5SS$) z This private method compresses some data in a given mode. This is used because almost all of the code uses the exact same setup. It wouldn't have to, but it doesn't hurt at all. i(size_t *r uint8_t [] uint8_t **z#Error encountered compressing data.N) intmathceillenrnewrBrotliEncoderCompressStreamr*rQr+rbuffer) rTr operationoriginal_output_size available_out output_bufferptr_to_output_buffer input_size input_bufferptr_to_input_bufferrKsize_of_outputs rr'Compressor._compress s # IIc$i3t9>2U: ;  + /a mA.>? "ww|]CWWZT3 ww|T2 !gglLA  , , MM     HH   => >a=  -a0@@zz-8;;rcBURU[R5$)a Incrementally compress more data. :param data: A bytestring containing data to compress. :returns: A bytestring containing some compressed data. May return the empty bytestring if not enough data has been inserted into the compressor to create the output yet. )r'rBROTLI_OPERATION_PROCESS)rTrs rr0Compressor.compress0s~~dC$@$@AArcURS[R5/n[R"UR5[R :XacUR URS[R55 [R"UR5[R :XaMcSRU5$)z Flush the compressor. This will emit the remaining output data, but will not destroy the compressor. It can be used, for example, to ensure that given chunks of content will decompress immediately. r)r'rBROTLI_OPERATION_FLUSHr,r*r+appendjoinrTchunkss rflushCompressor.flush=s ..c&@&@AB,,T]];sN MM$..c.H.HI J,,T]];sNxxrcR/n[R"UR5[R:XacUR UR S[R 55 [R"UR5[R:XaMcSRU5$)z Finish the compressor. This will emit the remaining output data and transition the compressor to a completed state. The compressor cannot be used again after this point, and must be replaced. r)rr)r*r-rsr'r(rtrus rrCompressor.finishJss ))$--8Crs ! I     (!!8!89 !((   " "   " "  //,, 3l< P  8} } @V6Vr