^ i_SrSSKJr SSKrSSKJrJr SSKJrJ r J r SSK J r SSK JrJr SS KJr SS KJrJrJr SS KJrJr \(aSS KJr \R6"\5rS rSrSr \!"S5Vs/sH nSU-S- PM snr"Sr#SSjr$SSjr%SSjr&SSjr'S Sjr("SS5r)"SS5r*gs snf)!zL Implements the HPACK header compression algorithm as detailed by RFC 7541. ) annotationsN) TYPE_CHECKINGAny)HPACKDecodingErrorInvalidTableSizeErrorOversizedHeaderListError)HuffmanEncoder) REQUEST_CODESREQUEST_CODES_LENGTH)decode_huffman) HeaderTupleHeaderWeaklyTypedNeverIndexedHeaderTuple) HeaderTabletable_entry_size)Iterable@ ic[US5n[US5nU(d0URURS5URS55$URX#5$)z^ Provides a header as a unicode string if raw is False, otherwise returns it as a bytestring. rrutf-8)bytes __class__decode)headerrawnamevalues E/home/james-whalen/.local/lib/python3.13/site-packages/hpack/hpack.py_unicode_if_neededr##sY  D &) E  G 4ell76KLL   D ((c`[RSX5 US:aSU3n[U5eUS:dUS:aSU3n[U5e[UnX:a [ U/5$U/nX-nUS:a$UR US-S-5 US -nUS:aM$UR U5 [ U5$) z] Encodes an integer according to the wacky integer encoding rules defined in the HPACK spec. zEncoding %d with %d bitsrz'Can only encode positive integers, got r)Prefix bits must be between 1 and 8, got )logdebug ValueError_PREFIX_BIT_MAX_NUMBERS bytearrayappend)integer prefix_bitsmsg max_numberelementss r"encode_integerr60s II('?{7yAoQ+/9+Go(5J'##|H G S.3#-.A  S. OOG X r$cNUS:dUS:aSU3n[U5e[UnSnSnSSU- - nUSU-nXs:Xa*XnUS- nUS:a XxS- U-- nOXxU-- nOUS- nM)[R S Xt5 Xt4$![an SU<3n[U5U eS n A ff=f) z Decodes an integer according to the wacky integer encoding rules defined in the HPACK spec. Returns a tuple of the decoded integer and the number of bytes that were consumed from ``data`` in order to get that integer. rr&r'rr(r*z3Unable to decode HPACK integer representation from NzDecoded %d, consumed %d bytes)r-r. IndexErrorrr+r,) datar2r3r4indexshiftmasknumber next_byteerrs r"decode_integerrAOsQ+/9+Go(5J E E Q_ %D/a4   K  #3588F500F II-v= = /CD8L %3./s/B#B B$ BB$c## [U[5(dS[U53n[U5e[ UR 5SS9nUH nX0U4v M g7f)z Converts a dictionary to an iterable of key-value tuples. This is a HPACK-specific function because it pulls "special-headers" out first and then emits them. zheader_dict not a dict, but c@[U5RS5(+$)N:) _to_bytes startswith)ks r"#_dict_to_iterable..s)A,11$77r$)keyN) isinstancedicttype TypeErrorsortedkeys) header_dictr3rPrJs r"_dict_to_iterablerRvsc k4 ( (,T+->,?@n  7 Ds###sAAcx[U5nU[LaU$U[La [U5nURS5$)z: Convert anything to bytes through a UTF-8 encoded string r)rMrstrencode)r!ts r"rErEs8 U AEz |E  <<  r$c\rSrSrSrSSjr\SSj5r\RSSj5rSSSjjr SSSjjr SSjr SSS jjr SSS jjr SS jrS rg )Encoderza An HPACK encoder object. This object takes HTTP headers and emits encoded HTTP/2 header blocks. cb[5Ul[[[5Ul/UlgN)r header_tabler r r huffman_codertable_size_changesselfs r"__init__Encoder.__init__s)'M+ / .0r$c.URR$z. Controls the size of the HPACK header table. r\maxsizer_s r"header_table_sizeEncoder.header_table_size   (((r$cXRlURR(aURR U5 ggr[)r\rfresizedr^r0r`r!s r"rgrhs6$)!    $ $  # # * *5 1 %r$cN/nURR(a0URUR55 SURl[ U[ 5(a [ U5nO [U5nUH}nSn[ U[5(aUR(+nO[U5S:aUSn[US5[US54nURURXvU55 M SRU5n[RSU5 U$)ah Takes a set of headers and encodes them into a HPACK-encoded header block. :param headers: The headers to encode. Must be either an iterable of tuples, an iterable of :class:`HeaderTuple `, or a ``dict``. If an iterable of tuples, the tuples may be either two-tuples or three-tuples. If they are two-tuples, the tuples must be of the format ``(name, value)``. If they are three-tuples, they must be of the format ``(name, value, sensitive)``, where ``sensitive`` is a boolean value indicating whether the header should be added to header tables anywhere. If not present, ``sensitive`` defaults to ``False``. If an iterable of :class:`HeaderTuple `, the tuples must always be two-tuples. Instead of using ``sensitive`` as a third tuple entry, use :class:`NeverIndexedHeaderTuple ` to request that the field never be indexed. .. warning:: HTTP/2 requires that all special headers (headers whose names begin with ``:`` characters) appear at the *start* of the header block. While this method will ensure that happens for ``dict`` subclasses, callers using any other iterable of tuples **must** ensure they place their special headers at the start of the iterable. For efficiency reasons users should prefer to use iterables of two-tuples: fixing the ordering of dictionary headers is an expensive operation that should be avoided if possible. :param huffman: (optional) Whether to Huffman-encode any header sent as a literal value. Except for use when debugging, it is recommended that this be left enabled. :returns: A bytestring containing the HPACK-encoded header block. Frrrr$zEncoded header block to %s)r\rkr0_encode_table_size_changerKrLrRiterr indexablelenrEaddjoinr+r,) r`headershuffman header_block hpack_headersr sensitive new_headerencodeds r"rUEncoder.encodesp     $ $    > > @ A(-D   % gt $ $.g6M &!MM$FI&+.. & 0 00 Vq"1I #F1I. &)0DEJ    H I$((<( .8r$c[RSUUU5 UupEU(d[O[nURR XE5nUc6UR XEXc5nU(dURRXE5 U$Uupn U (aURU 5nU$URXXc5nU(dURRXE5 U$)z& Serializes a header key-value tuple. z7Adding %s to the header table, sensitive:%s, huffman:%s) r+r,INDEX_INCREMENTAL INDEX_NEVERr\search_encode_literalrr_encode_indexed_encode_indexed_literal) r`to_addrxrur r!indexbitmatchrzr;perfects r"rr Encoder.adds E      -6$;!!((5 =**4JG!!%%d2N %W **51G 22hG!!%%d2r$cJ[US5nUS==S-ss'[U5$)z4 Encodes a header using the indexed representation. r*rr()r6r)r`r;fields r"rEncoder._encode_indexedMs(ua( aDU|r$cbU(a6URRU5nURRU5n[[U5S5n[[U5S5nU(aUS==S-ss'US==S-ss'SR U[ U5U[ U5U/5$)z Encodes a header with a literal name and literal value. If ``indexing`` is True, the header will be added to the header table: otherwise it will not. r*rr(r$)r]rUr6rqrsr)r`r r!rruname_len value_lens r"rEncoder._encode_literalUs %%,,T2D&&--e4E!#d)Q/"3u:q1  QK4 K aLD Lxx uXeI.> F  r$cVU[:wa [US5nO [US5nUS==[U5-ss'U(aURR U5n[[ U5S5nU(a US==S-ss'SR [U5[U5U/5$)z^ Encodes a header with an indexed name and a literal value and performs incremental indexing. rr*r(r$)r}r6ordr]rUrqrsr)r`r;r!rruprefixrs r"rEncoder._encode_indexed_literaljs ( (#E1-F#E1-Fq S]" &&--e4E"3u:q1  aLD Lxxvi(8%@AAr$cSnURH*n[US5nUS==S-ss'U[U5- nM, /UlU$)zL Produces the encoded form of all header table size change context updates. r$r )r^r6r)r`block size_bytesbs r"rn!Encoder._encode_table_size_changesO 11Jz1-A aDDLD U1X E2#% r$)r\r]r^NreturnNonerintr!rrr)T)rtzIterable[HeaderTuple | tuple[bytes | str, bytes | str] | tuple[bytes | str, bytes | str, bool | None]] | dict[bytes | str, bytes | str]ruboolrrF)rztuple[bytes, bytes]rxrrurrr)r;rrr) r rr!rrrrurrr) r;rr!rrrrurrr)rr)__name__ __module__ __qualname____firstlineno____doc__rapropertyrgsetterrUrrrrrrn__static_attributes__r$r"rXrXs 0)) 22 $ k2k  k ). kZ/b *B, r$rXc\rSrSrSr\4SSjjr\SSj5r\RSSj5rSSSjjr SSjr SSjr SS jr SS jrSS jrSS jrS rg)Decoderia An HPACK decoder object. .. versionchanged:: 2.3.0 Added ``max_header_list_size`` argument. :param max_header_list_size: The maximum decompressed size we will allow for any single header block. This is a protection against DoS attacks that attempt to force the application to expand a relatively small amount of data into a really large header list, allowing enormous amounts of memory to be allocated. If this amount of data is exceeded, a `OversizedHeaderListError ` exception will be raised. At this point the connection should be shut down, as the HPACK state will no longer be usable. Defaults to 64kB. :type max_header_list_size: ``int`` cd[5UlXlURRUlgr[)rr\max_header_list_sizerfmax_allowed_table_size)r`rs r"raDecoder.__init__s*'M %9!'+&7&7&?&?#r$c.URR$rdrer_s r"rgDecoder.header_table_sizerir$c$XRlgr[rerls r"rgrs$)!r$c8[RSU5 [U5n/n[U5nSnSnXu:GaXn[ US-5n [ US-5n [ US-5n U (aUR X7S5upOcU (aUR X7S5upOFU (a*U(a Sn[U5eURX7S5n Sn OURX7S5upU (aPURU 5 U[U SU S5- nX`R:aS URS 3n[U5eX}- nXu:aGMUR5 UVs/sHn[X5PM sn$s snf![ anS n[U5UeSnAff=f) a Takes an HPACK-encoded header block and decodes it into a header set. :param data: A bytestring representing a complete HPACK-encoded header block. :param raw: (optional) Whether to return the headers as tuples of raw byte strings or to decode them as UTF-8 before returning them. The default value is False, which returns tuples of Unicode strings :returns: A list of two-tuples of ``(name, value)`` representing the HPACK-encoded headers, in the order they were decoded. :raises HPACKDecodingError: If an error is encountered while decoding the header block. z Decoding %srr(@rNz/Table size update not at the start of the blockrzA header list larger than z has been receivedz!Unable to decode headers as UTF-8)r+r, memoryviewrqr_decode_indexed_decode_literal_indexr_update_encoding_context_decode_literal_no_indexr0rrr _assert_valid_table_sizer#UnicodeDecodeError)r`r:rdata_memrtdata_len inflated_size current_indexcurrentindexed literal_indexencoding_updaterconsumedr3hr@s r"rDecoder.decodes -&d#%'t9  &)G7T>*G!40M#7T>2O#'#7#7^,$ #'#=#=^,$ !KC,S1188^,$(#@#@^,$ v&!1&)VAY!GG  #<#<<6t7P7P6QQcdC2377  %M_&h %%' 38?@1&q.@ @@! 35C$S)s 2 3s*E<E74E<7E<< FFFcRURUR:a Sn[U5eg)z[ Check that the table size set by the encoder is lower than the maximum we expect to have. z3Encoder did not shrink table size to within the maxN)rgrr)r`r3s r"r Decoder._assert_valid_table_sizes.  ! !D$?$? ?GC', , @r$cf[US5up#X R:a Sn[U5eX lU$)z3 Handles a byte that updates the encoding context. rz)Encoder exceeded max allowable table size)rArrrg)r`r:new_sizerr3s r"r Decoder._update_encoding_context's: ,D!4 11 1=C', ,!)r$c[US5up#[URRU56n[R SXC5 XC4$)z@ Decodes a header represented using the indexed representation. r*zDecoded %s, consumed %d)rArr\ get_by_indexr+r,)r`r:r;rrs r"rDecoder._decode_indexed3sE)q1d//<r$c"URUSS9$)NF should_index_decode_literalr`r:s r"r Decoder._decode_literal_no_index<s##Du#==r$c"URUSS9$)NTrrrs r"rDecoder._decode_literal_index?s##Dt#<LH!MQI$t+LH T!12M ,T"5)E 8++ ,T9F -F     ! !$ . =     %%r$)r\rgrrN)rrrrrrr)r:rrrrzIterable[HeaderTuple]r)r:rrr)r:rrtuple[HeaderTuple, int])r:rrrrr)rrrrrDEFAULT_MAX_HEADER_LIST_SIZErarrgrrrrrrrrrrr$r"rrsg*4P@8)) **Q3f-  >=L&r$r)rrrrrr)r1rr2rrr/)r:rr2rrztuple[int, int])rQzdict[bytes | str, bytes | str]rz)Iterable[tuple[bytes | str, bytes | str]])r!zbytes | str | Anyrr)+r __future__rloggingtypingrr exceptionsrrr rur huffman_constantsr r huffman_tabler structrrrtablerrcollections.abcr getLoggerrr+ INDEX_NONEr~r}ranger.rr#r6rArRrErXr)is0r"rs#%[[#B)KK0( !    27q:AAFa<: ' )>$N$ 4$& !vvr@&@&e ;s4B;