4)diYqddlmZddlZddlmZmZddlmZddlm Z m Z m Z m Z m Z mZmZddlZddlZeddZGd deZGd d eejZdS) ) annotationsN)BitsBitsType)Dtype)UnionListAnyOptionaloverloadTypeVarTupleTConstBitStreamConstBitStream)boundceZdZdZdZ dMdNdZdOdZdPdZdQdZdPdZ dRdZ dSdZ dTdZ dTdZ dTdZdTdZdUdZdVd ZdWdXd!Z dYdZfd' Z dYdZfd( Zed[d+Zed\d-Zd]d0Zd^d3ZdWd_d4Zed`d5Zedad7Zdbd9Zdcd<ZdPd=ZeddfdA ZededDZedfdFZdgfdI Zee edJKZ ee edJKZ!eeedLKZ"xZ#S)hraA container or stream holding an immutable sequence of bits. For a mutable container use the BitStream class instead. Methods inherited from Bits: all() -- Check if all specified bits are set to 1 or 0. any() -- Check if any of specified bits are set to 1 or 0. copy() -- Return a copy of the bitstring. count() -- Count the number of bits set to 1 or 0. cut() -- Create generator of constant sized chunks. endswith() -- Return whether the bitstring ends with a sub-string. find() -- Find a sub-bitstring in the current bitstring. findall() -- Find all occurrences of a sub-bitstring in the current bitstring. fromstring() -- Create a bitstring from a formatted string. join() -- Join bitstrings together using current bitstring. pp() -- Pretty print the bitstring. rfind() -- Seek backwards to find a sub-bitstring. split() -- Create generator of chunks split by a delimiter. startswith() -- Return whether the bitstring starts with a sub-bitstring. tobitarray() -- Return bitstring as a bitarray from the bitarray package. tobytes() -- Return bitstring as bytes, padding if needed. tofile() -- Write bitstring to file, padding if needed. unpack() -- Interpret bits using format string. Other methods: bytealign() -- Align to next byte boundary. peek() -- Peek at and interpret next bits as a single item. peeklist() -- Peek at and interpret next bits as a list of items. read() -- Read and interpret next bits as a single item. readlist() -- Read and interpret next bits as a list of items. readto() -- Read up to and including next occurrence of a bitstring. Special methods: Also available are the operators [], ==, !=, +, *, ~, <<, >>, &, |, ^. Properties: [GENERATED_PROPERTY_DESCRIPTIONS] len -- Length of the bitstring in bits. pos -- The current bit position in the bitstring. _posNrlength Optional[int]offsetposintautoOptional[Union[BitsType, int]]returnNonec |dkr|t|jz }|dks|t|jkr-tjd|dt|jd||_d|j_dS)akEither specify an 'auto' initialiser: A string of comma separated tokens, an integer, a file object, a bytearray, a boolean iterable or another bitstring. Or initialise via **kwargs with one (and only one) of: bin -- binary string representation, e.g. '0b001010'. hex -- hexadecimal string representation, e.g. '0x2ef' oct -- octal string representation, e.g. '0o777'. bytes -- raw data as a bytes object, for example read from a binary file. int -- a signed integer. uint -- an unsigned integer. float / floatbe -- a big-endian floating point number. bool -- a boolean (True or False). se -- a signed exponential-Golomb code. ue -- an unsigned exponential-Golomb code. sie -- a signed interleaved exponential-Golomb code. uie -- an unsigned interleaved exponential-Golomb code. floatle -- a little-endian floating point number. floatne -- a native-endian floating point number. bfloat / bfloatbe - a big-endian bfloat format 16-bit floating point number. bfloatle -- a little-endian bfloat format 16-bit floating point number. bfloatne -- a native-endian bfloat format 16-bit floating point number. intbe -- a signed big-endian whole byte integer. intle -- a signed little-endian whole byte integer. intne -- a signed native-endian whole byte integer. uintbe -- an unsigned big-endian whole byte integer. uintle -- an unsigned little-endian whole byte integer. uintne -- an unsigned native-endian whole byte integer. filename -- the path of a file which will be opened in binary read-only mode. Other keyword arguments: length -- length of the bitstring in bits, if needed and appropriate. It must be supplied for all integer and float initialisers. offset -- bit offset to the data. These offset bits are ignored and this is mainly intended for use when initialising using 'bytes' or 'filename'. pos -- Initial bit position, defaults to 0. rzCannot set pos to z when length is .TN)len _bitstore bitstring CreationErrorr immutableselfrrrrkwargss Z/var/www/menimich/repos/protonApp/venv/lib/python3.11/site-packages/bitstring/bitstream.py__init__zConstBitStream.__init__>sR 77 3t~&& &C 77cC////)*js*j*jTWX\XfTgTg*j*j*jkk k #'   byteposc6||dzdS)z1Move to absolute byte-aligned position in stream.N) _setbitpos)r%r*s r' _setbyteposzConstBitStream._setbyteposns ! $$$$$r)cR|jdzrtjd|jdzS)zIReturn the current position in the stream in bytes. Must be byte aligned.r,z-Not byte aligned when using bytepos property.)rr!ByteAlignErrorr%s r' _getbyteposzConstBitStream._getbyteposrs/ 9q= \*+Z[[ [yA~r)c|dkrtd|t|krtd||_dS)z+Move to absolute position bit in bitstream.rz Bit position cannot be negative.z%Cannot seek past the end of the data.N) ValueErrorrr)r%rs r'r-zConstBitStream._setbitposxsC 77?@@ @ T??DEE E r)c|jS)z2Return the current position in the stream in bits.rr1s r' _getbitposzConstBitStream._getbitposs yr)c<tj|d|_dSNr)r_clearrr1s r'r9zConstBitStream._clears D r)r%rcT|}|j|_d|_|S)ztj||}d|_|S)zBit-wise 'and' between two bitstrings. Returns new bitstring. bs -- The bitstring to '&' with. Raises ValueError if the two bitstrings have differing lengths. r)r__and__rr%r>r<s r'r@zConstBitStream.__and__! Lr " "r)c>tj||}d|_|S)zBit-wise 'or' between two bitstrings. Returns new bitstring. bs -- The bitstring to '|' with. Raises ValueError if the two bitstrings have differing lengths. r)r__or__rrAs r'rDzConstBitStream.__or__s! Kb ! !r)c>tj||}d|_|S)zBit-wise 'xor' between two bitstrings. Returns new bitstring. bs -- The bitstring to '^' with. Raises ValueError if the two bitstrings have differing lengths. r)r__xor__rrAs r'rFzConstBitStream.__xor__rBr)c>tj||}d|_|S)zbConcatenate bitstrings and return new bitstring. bs -- the bitstring to append. r)r__add__rrAs r'rHzConstBitStream.__add__s! Lr " "r)cX||t||_dS)zAppend a bitstring to the current bitstring. bs -- The bitstring to append. The current bit position will be moved to the end of the BitStream. N_appendrrr%r>s r'appendzConstBitStream.appends' RII r)strch||jjt||jS)zReturn representation that could be used to recreate the bitstring. If the returned string is too long it will be truncated. See __str__(). )_reprr;__name__rrr1s r'__repr__zConstBitStream.__repr__s' zz$.13t99diHHHr)cDtj|}t|dkrdS||j}|dkr|t|z }|dks|t|krt d||||t|z|_dS)a2Overwrite with bitstring at bit position pos. bs -- The bitstring to overwrite with. pos -- The bit position to begin overwriting from. The current bit position will be moved to the end of the overwritten section. Raises ValueError if pos < 0 or pos > len(self). rNz/Overwrite starts outside boundary of bitstring.)r_create_from_bitstyperrr4 _overwriter%r>rs r' overwritezConstBitStream.overwrites ' + + r77a<< F ;)C 77 3t99 C 77cCIIooNOO O C   #b''M r)startend bytealignedOptional[bool]Union[Tuple[int], Tuple[()]]cnt||||}|r |d|_|S)aFind first occurrence of substring bs. Returns a single item tuple with the bit position if found, or an empty tuple if not found. The bit position (pos property) will also be set to the start of the substring if it is found. bs -- The bitstring to find. start -- The bit position to start the search. Defaults to 0. end -- The bit position one past the last bit to search. Defaults to len(self). bytealigned -- If True the bitstring will only be found on byte boundaries. Raises ValueError if bs is empty, if start < 0, if end > len(self) or if end < start. >>> BitStream('0xc3e').find('0b1111') (6,) r)superfindrr%r>rXrYrZpr;s r'r_zConstBitStream.finds8. GGLLUC 5 5  !DIr)cnt||||}|r |d|_|S)aFind final occurrence of substring bs. Returns a single item tuple with the bit position if found, or an empty tuple if not found. The bit position (pos property) will also be set to the start of the substring if it is found. bs -- The bitstring to find. start -- The bit position to end the reverse search. Defaults to 0. end -- The bit position one past the first bit to reverse search. Defaults to len(self). bytealigned -- If True the bitstring will only be found on byte boundaries. Raises ValueError if bs is empty, if start < 0, if end > len(self) or if end < start. r)r^rfindrr`s r'rczConstBitStream.rfinds8& GGMM"eS+ 6 6  !DIr)fmtrcdSNr%rds r'readzConstBitStream.read r)r cdSrfrgrhs r'rizConstBitStream.read!rjr)Union[int, str, Dtype]/Union[int, float, str, Bits, bool, bytes, None]c |j}t|tjr|dkrt d|t ||jz kr0t jd|dt ||jz d||j|j|z}|xj|z c_|St j |}|j |j sxt ||jz }t||j\}}|dkr#t d|jd|jd |d t j ||}|j 1|||j}|xj|j z c_n#|||j\}|_|jt |kr2||_t jd |d t ||z d |S)aInterpret next bits according to the format string and return result. fmt -- Token string describing how to interpret the next bits. Token examples: 'int:12' : 12 bits as a signed integer 'uint:8' : 8 bits as an unsigned integer 'float:64' : 8 bytes as a big-endian float 'intbe:16' : 2 bytes as a big-endian signed integer 'uintbe:16' : 2 bytes as a big-endian unsigned integer 'intle:32' : 4 bytes as a little-endian signed integer 'uintle:32' : 4 bytes as a little-endian unsigned integer 'floatle:64': 8 bytes as a little-endian float 'intne:24' : 3 bytes as a native-endian signed integer 'uintne:24' : 3 bytes as a native-endian unsigned integer 'floatne:32': 4 bytes as a native-endian float 'hex:80' : 80 bits as a hex string 'oct:9' : 9 bits as an octal string 'bin:1' : single bit binary string 'ue' : next bits as unsigned exp-Golomb code 'se' : next bits as signed exp-Golomb code 'uie' : next bits as unsigned interleaved exp-Golomb code 'sie' : next bits as signed interleaved exp-Golomb code 'bits:5' : 5 bits as a bitstring 'bytes:10' : 10 bytes as a bytes object 'bool' : 1 bit as a bool 'pad:3' : 3 bits of padding to ignore - returns None fmt may also be an integer, which will be treated like the 'bits' token. The position in the bitstring is advanced to after the read items. Raises ReadError if not enough bits are available. Raises ValueError if the format is not understood. rzCannot read negative amount.z Cannot read z bits, only z available.NzThe 'z4' type must have a bit length that is a multiple of z so cannot be read from the z bits that are available.z'Reading off end of bitstring with fmt 'z'. Only z bits available.)r isinstancenumbersIntegralr4rr! ReadError_slicedtypesr bitlengthvariable_lengthdivmod bits_per_itemnameread_fn) r%rdrar>dtyperuitems remaindervals r'rizConstBitStream.read%sH I c7+ , , Qww !?@@@SYY***)*l*l*l#d))VZV_J_*l*l*lmmmTY C88B II III &&s++ ? "5+@ "D DI-I%i1DEE E9A~~ XEJXX\a\oXX3<XXXYYY$**366E ? &--di00C II (III"]]4;;NC 9s4yy DI%&|PS&|&|]`ae]f]fij]j&|&|&|}} } r)(Union[str, List[Union[int, str, Dtype]]]5List[Union[int, float, str, Bits, bool, bytes, None]]c >|j||jfi|\}|_|S)aInterpret next bits according to format string(s) and return list. fmt -- A single string or list of strings with comma separated tokens describing how to interpret the next bits in the bitstring. Items can also be integers, for reading new bitstring of the given length. kwargs -- A dictionary or keyword-value pairs - the keywords used in the format string will be replaced with their given value. The position in the bitstring is advanced to after the read items. Raises ReadError is not enough bits are available. Raises ValueError if the format is not understood. See the docstring for 'read' for token examples. 'pad' tokens are skipped and not added to the returned list. >>> h, b1, b2 = s.readlist('hex:20, bin:5, bin:3') >>> i, bs1, bs2 = s.readlist(['uint:12', 10, 10]) ) _readlistr)r%rdr&values r'readlistzConstBitStream.readlistgs-,*4>#tyCCFCCty r)c`t|tjrtdt j|}|j}|||j|}|stj d|xjt|z c_| ||jS)a4Read up to and including next occurrence of bs and return result. bs -- The bitstring to find. bytealigned -- If True the bitstring will only be found on byte boundaries. Raises ValueError if bs is empty. Raises ReadError if bs is not found. zIntegers cannot be searched for)rZzSubstring not found) rorprqr4rrTrr_r!rrrrs)r%r>rZoldposras r'readtozConstBitStream.readtos b'* + + @>?? ?  ' + + IIb$)I = = =%&;<< < SWW {{649---r)cdSrfrgrhs r'peekzConstBitStream.peekrjr):Union[int, float, str, TConstBitStream, bool, bytes, None]cdSrfrgrhs r'rzConstBitStream.peekrjr)Union[int, str]cL|j}||}||_|S)aInterpret next bits according to format string and return result. fmt -- Token string describing how to interpret the next bits. The position in the bitstring is not changed. If not enough bits are available then all bits to the end of the bitstring will be used. Raises ReadError if not enough bits are available. Raises ValueError if the format is not understood. See the docstring for 'read' for token examples. )rri)r%rd pos_beforers r'rzConstBitStream.peeks&Y  #  r)!Union[str, List[Union[int, str]]](List[Union[int, float, str, Bits, None]]c >|j}|j|fi|}||_|S)aInterpret next bits according to format string(s) and return list. fmt -- One or more integers or strings with comma separated tokens describing how to interpret the next bits in the bitstring. kwargs -- A dictionary or keyword-value pairs - the keywords used in the format string will be replaced with their given value. The position in the bitstring is not changed. If not enough bits are available then all bits to the end of the bitstring will be used. Raises ReadError if not enough bits are available. Raises ValueError if the format is not understood. See the docstring for 'read' for token examples. )rr)r%rdr&r return_valuess r'peeklistzConstBitStream.peeklists1$i% c44V44  r)cFd|jdzz dz}|xj|z c_|S)zAlign to next byte and return number of skipped bits. Raises ValueError if the end of the bitstring is reached before aligning to the next byte. r,)rr)r%skippeds r' bytealignzConstBitStream.bytealigns. A &!+ Gr)clsTBitsr<cpt|}d|_d|j_|S)NrT)r^ fromstringrr r#)rr<xr;s r'rzConstBitStream.fromstrings0 GG  q ! ! $ r)keyslicecdSrfrgr%rs r' __getitem__zConstBitStream.__getitem__rjr)boolcdSrfrgrs r'rzConstBitStream.__getitem__rjr)Union[slice, int]Union[TBits, bool]c"t|tjr't|j|St |j}|j ||_d|_ |S)zEReturn a new bitstring representing a slice of the current bitstring.r) rorprqrr getindexr^__new__r;getslice_withstepr)r%rr>r;s r'rzConstBitStream.__getitem__sp c7+ , , 6//4455 5 WW__T^ , ,~77<<  r)zMThe position in the bitstring in bits. Read and write. )doczNThe position in the bitstring in bytes. Read and write. NNNr rrrrrrrrrr)r*rrr)rr)rrrr)rr)r%rrr)r%rr>rrrr>rrr)rrNrfrrr>rrr)NNN) rXrrYrrZr[r>rrr\)rdrrr)rdrNrr )rdrlrrm)rdrrr)rZr[r%rr>rrr)r%rrdrrr)rdrNrr)r%rrdrrr)rdrrr)rrr<rNrr)r%rrrrr)r%rrrrr)r%rrrrr)$rQ __module__ __qualname____doc__ __slots__r(r.r2r-r6r9r=r@rDrFrHrMrRrWr_rcr rirrrrr classmethodrrpropertyrbitposr* __classcell__r;s@r'rr s,,\I_c:;.(.(.(.(.(`%%%%                 IIII""""",W[+/8X\,00   X    X @@@@D2.....*   X    X &.    [    X    X  (:z   CXj*Fh{KGGGGGr)creZdZdZdZ d"d#dZd$dZd%dZd&fd Zd'fd Z d(dZ d)d*dZ d+d,d!Z xZ S)- BitStreama A container or stream holding a mutable sequence of bits Subclass of the ConstBitStream and BitArray classes. Inherits all of their methods. Methods: all() -- Check if all specified bits are set to 1 or 0. any() -- Check if any of specified bits are set to 1 or 0. append() -- Append a bitstring. bytealign() -- Align to next byte boundary. byteswap() -- Change byte endianness in-place. clear() -- Remove all bits from the bitstring. copy() -- Return a copy of the bitstring. count() -- Count the number of bits set to 1 or 0. cut() -- Create generator of constant sized chunks. endswith() -- Return whether the bitstring ends with a sub-string. find() -- Find a sub-bitstring in the current bitstring. findall() -- Find all occurrences of a sub-bitstring in the current bitstring. fromstring() -- Create a bitstring from a formatted string. insert() -- Insert a bitstring. invert() -- Flip bit(s) between one and zero. join() -- Join bitstrings together using current bitstring. overwrite() -- Overwrite a section with a new bitstring. peek() -- Peek at and interpret next bits as a single item. peeklist() -- Peek at and interpret next bits as a list of items. pp() -- Pretty print the bitstring. prepend() -- Prepend a bitstring. read() -- Read and interpret next bits as a single item. readlist() -- Read and interpret next bits as a list of items. readto() -- Read up to and including next occurrence of a bitstring. replace() -- Replace occurrences of one bitstring with another. reverse() -- Reverse bits in-place. rfind() -- Seek backwards to find a sub-bitstring. rol() -- Rotate bits to the left. ror() -- Rotate bits to the right. set() -- Set bit(s) to 1 or 0. split() -- Create generator of chunks split by a delimiter. startswith() -- Return whether the bitstring starts with a sub-bitstring. tobitarray() -- Return bitstring as a bitarray from the bitarray package. tobytes() -- Return bitstring as bytes, padding if needed. tofile() -- Write bitstring to file, padding if needed. unpack() -- Interpret bits using format string. Special methods: Mutating operators are available: [], <<=, >>=, +=, *=, &=, |= and ^= in addition to [], ==, !=, +, *, ~, <<, >>, &, | and ^. Properties: [GENERATED_PROPERTY_DESCRIPTIONS] len -- Length of the bitstring in bits. pos -- The current bit position in the bitstring. rgNrrrrrrrrrrc tj|||||fi||jjr,|j|_d|j_dSdS)adEither specify an 'auto' initialiser: A string of comma separated tokens, an integer, a file object, a bytearray, a boolean iterable or another bitstring. Or initialise via **kwargs with one (and only one) of: bin -- binary string representation, e.g. '0b001010'. hex -- hexadecimal string representation, e.g. '0x2ef' oct -- octal string representation, e.g. '0o777'. bytes -- raw data as a bytes object, for example read from a binary file. int -- a signed integer. uint -- an unsigned integer. float / floatbe -- a big-endian floating point number. bool -- a boolean (True or False). se -- a signed exponential-Golomb code. ue -- an unsigned exponential-Golomb code. sie -- a signed interleaved exponential-Golomb code. uie -- an unsigned interleaved exponential-Golomb code. floatle -- a little-endian floating point number. floatne -- a native-endian floating point number. bfloat / bfloatbe - a big-endian bfloat format 16-bit floating point number. bfloatle -- a little-endian bfloat format 16-bit floating point number. bfloatne -- a native-endian bfloat format 16-bit floating point number. intbe -- a signed big-endian whole byte integer. intle -- a signed little-endian whole byte integer. intne -- a signed native-endian whole byte integer. uintbe -- an unsigned big-endian whole byte integer. uintle -- an unsigned little-endian whole byte integer. uintne -- an unsigned native-endian whole byte integer. filename -- the path of a file which will be opened in binary read-only mode. Other keyword arguments: length -- length of the bitstring in bits, if needed and appropriate. It must be supplied for all integer and float initialisers. offset -- bit offset to the data. These offset bits are ignored and this is intended for use when initialising using 'bytes' or 'filename'. pos -- Initial bit position, defaults to 0. FN)rr(r r#_copyr$s r'r(zBitStream.__init__1sbR dFFCJJ6JJJ > # -!^1133DN',DN $ $ $ - -r)ctt}d|_|j|_|S)z#Return a new copy of the BitStream.r)objectrrrr copy)r%s_copys r'r=zBitStream.__copy___s5 ** >..00 r)r>rcX||t||_|S)zAppend to current bitstring. Return self. bs -- the bitstring to append. The current bit position will be moved to the end of the BitStream. rJrLs r'__iadd__zBitStream.__iadd__fs( RII  r)ctj|}t|d|_dS)z`Prepend a bitstring to the current bitstring. bs -- The bitstring to prepend. rN)rrTr^prependr)r%r>r;s r'rzBitStream.prependqs6  ' + +  r)rrrct|}t||t||krd|_dSr8)rr^ __setitem__r)r%rr length_beforer;s r'rzBitStream.__setitem__{sED  C''' t99 % %DIr)ct|}|j|t||kr d|_dSdS)zDelete item or range. >>> a = BitStream('0x001122') >>> del a[8:16] >>> print a 0x0022 rN)rr __delitem__r)r%rrs r'rzBitStream.__delitem__sID  ""3''' t99 % %DIII & %r)cztj|}t|dkrdS||ur|}||j}|dkr|t|z }d|cxkrt|ksnt d||||t|z|_dS)aInsert bitstring at bit position pos. bs -- The bitstring to insert. pos -- The bit position to insert at. The current bit position will be moved to the end of the inserted section. Raises ValueError if pos < 0 or pos > len(self). rNzInvalid insert position.)rrTrrrr4_insertrVs r'insertzBitStream.inserts ' + + r77a<< F ::B ;)C 77 3t99 CC$$$$3t99$$$$788 8 R#b''M r)oldnewrXrYcountrZr[c|dkrdSttj|x}dkrtd|||\}}tj|}||urt j|}t|}||||||dn||}t||krd|_|S)aReplace all occurrences of old with new in place. Returns number of replacements made. old -- The bitstring to replace. new -- The replacement bitstring. start -- Any occurrences that start before this will not be replaced. Defaults to 0. end -- Any occurrences that finish after this will not be replaced. Defaults to len(self). count -- The maximum number of replacements to make. Defaults to replace all occurrences. bytealigned -- If True replacements will only be made on byte boundaries. Raises ValueError if old is empty or if start or end are out of range. rz#Empty bitstring cannot be replaced.)rrrTr4_validate_slicer_replacer) r%rrrXrYrrZrreplacement_counts r'replacezBitStream.replaces* A::1 d0555s 6 6! ; ;BCC C))%55 s(-- $;;)D//CD  MM#sE3U]X]_jkk t99 % %DI  r)rr)rr)r>rrrr)rrrrrr)rrrrrfr)NNNN)rrrrrXrrYrrrrZr[rr)rQrrrrr(r=rrrrrrrrs@r'rrs77rI_c:;,-,-,-,-,-\        """""0gkKO"!"!"!"!"!"!"!"!"!r)r) __future__rr!bitstring.bitsrrbitstring.dtypesrtypingrrr r r r r rrprrBitArrayrrgr)r'rs!""""""))))))))""""""GGGGGGGGGGGGGGGGGG '+3CDDDeeeeeTeeePU!U!U!U!U! 2U!U!U!U!U!r)