4)di/WddlmZddlZddlZddlZddlmZddlmZm Z m Z m Z m Z ddl mZddlmZmZddlmZmZmZddlZ Gdd eZdS) ) annotationsN)abc)UnionListIterableAnyOptional)utils) CreationErrorError)BitsBitsTypeTBitscPeZdZUdZdZdZded< dIdJd ZdKdZdLfd Z dMdZ dNdZ dOdZ dPdZ dQdZdRdZdSd ZdSd!ZdSd"ZdTd#ZdTd$ZdTd%ZdUd.Z dVdWd/ZdXd1ZdXd2ZdYd3ZdYd4ZdYd5ZdYd6ZdZd[d7Zd\d]d:Zd\d^d<Z dZd_d>Z!dZd_d?Z"dZd_d@Z#dZd`dAZ$ dadbdGZ%dLdHZ&xZ'S)cBitArrayapA container holding a mutable sequence of bits. Subclass of the immutable Bits class. Inherits all of its methods (except __hash__) and adds mutating methods. Mutating methods: append() -- Append a bitstring. byteswap() -- Change byte endianness in-place. clear() -- Remove all bits from the bitstring. insert() -- Insert a bitstring. invert() -- Flip bit(s) between one and zero. overwrite() -- Overwrite a section with a new bitstring. prepend() -- Prepend a bitstring. replace() -- Replace occurrences of one bitstring with another. reverse() -- Reverse bits in-place. rol() -- Rotate bits to the left. ror() -- Rotate bits to the right. set() -- Set bit(s) to 1 or 0. 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. Special methods: Mutating operators are available: [], <<=, >>=, +=, *=, &=, |= and ^= in addition to the inherited [], ==, !=, +, *, ~, <<, >>, &, | and ^. Properties: [GENERATED_PROPERTY_DESCRIPTIONS] len -- Length of the bitstring in bits. NNone__hash__length Optional[int]offsetautoOptional[Union[BitsType, int]]returnc v|jjr,|j|_d|j_dSdS)a0Either 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'. FN) _bitstore immutable_copy)selfrrrkwargss Z/var/www/menimich/repos/protonApp/venv/lib/python3.11/site-packages/bitstring/bitarray_.py__init__zBitArray.__init__KsAP > # -!^1133DN',DN $ $ $ - -rrc*|S)zReturn a copy of the bitstring.)__copy__rs r!copyz BitArray.copyws}}r#c t||dS#t$rtj|}t t}|j x}td|d|||t||j kr(tdt|d|j d|j |_ YdSwxYw)NzCannot set attribute 'z' as it does not have a set_fn.z&Can't initialise with value of length z" bits, as attribute has length of z bits.)super __setattr__AttributeError bitstringdtypesDtypeobject__new__r set_fnlen bitlengthr r)r attributevaluedtypexr1 __class__s r!r*zBitArray.__setattr__{s   GG   5 1 1 1 1 1   $**955Et$$A,&/$%hi%h%h%hiii F1e   1vv((#%ZSQRVV%Z%ZBG/%Z%Z%Z[[[[DN FF s"'B//11)U2222 r#keyintr5Union[BitsType, int]ct|tjr5|dkr d|j|<dS|dvr d|j|<dSt d|d ||}n.#t $r!t dt|dwxYw|dkr|t|zn|}|dks|t|jkrtd|d|j|j||dz<dS) Nr)rEz%Cannot set a single bit with integer .+Bitstring, integer or string expected. Got Bit position  out of range.) isinstancenumbersIntegralr ValueError_create_from_bitstype TypeErrortyper2 IndexError)rrAr5 positive_keys r! _setitem_intzBitArray._setitem_ints4 eW- . . Ozz&'s#&'s#MUMMMNN N Z..u55EE Z Z ZX$u++XXXYY Y Z*-''sSYYs !  |s4>/B/BBB@S@@@AA A9>|\A%55666s A''+Bslicec t|tjrt|}|jdvrR|dvr?||t |t|dStd|j |j |j }t|}|dkr|||}n]|||}nE ||}n.#t $r!t!dt#|dwxYw|j ||j dS) N)NrFrE)rrEzCCan't assign an integer except 0 or 1 to a slice with a step value.r)uintr)rBrrHrG)rKrLrMrBstepsetrangeindicesr2rNrgetslicestartstopr8rOrPrQ __setitem__)rrAr5srs r!_setitem_slicezBitArray._setitem_slicesP eW- . . ^JJEx},,F??HHUE3;;s4yy+A+A$BCCCF$%jkkk'' 38<>> a = BitArray('0x001122') >>> del a[8:16] >>> print a 0x0022 N)r __delitem__)rrAs r!rfzBitArray.__delitem__s ""3'''r#nc|dkrtdt|std|s|St|t|}||S)zuShift bits by n to the left in place. Return self. n -- the number of bits to shift. Must be >= 0. r"Cannot shift by a negative amount. Cannot shift an empty bitstring.)rNr2min_ilshiftrrgs r! __ilshift__zBitArray.__ilshift__n q55ABB B4yy A?@@ @ K 3t99  }}Qr#c|dkrtdt|std|s|St|t|}||S)zvShift bits by n to the right in place. Return self. n -- the number of bits to shift. Must be >= 0. rrirj)rNr2rk_irshiftrms r! __irshift__zBitArray.__irshift__ror#cV|dkrtd||S)zConcatenate n copies of self in place. Return self. Called for expressions of the form 'a *= 3'. n -- The number of concatenations. Must be >= 0. rz&Cannot multiply by a negative integer.)rN_imulrms r!__imul__zBitArray.__imul__s, q55EFF Fzz!}}r#cZ||}|xj|jzc_|SrdrOrr=s r!__ior__zBitArray.__ior__,  ' ' + + ",& r#cZ||}|xj|jzc_|Srdrwr=s r!__iand__zBitArray.__iand__ryr#cZ||}|xj|jzc_|Srdrwr=s r!__ixor__zBitArray.__ixor__ ryr#oldr newr]endcount bytealignedOptional[bool]c  |tjj}g}|||||D]f}|s||n1||dt |zkr|||dkrt ||krng|sdS|jd|dg} tt |dz D]i} | |j| |j|| t |z|| dzj| |j| |j|dt |zdtjj r| |j | D]} |xj| z c_t |S)N)rrFrrE) r,optionsrfindallappendr2rr\rZlsb0reverseclear) rr~rr]rrrstarting_pointsr7replacement_listirs r!_replacezBitArray._replaces  #+7K%'c5#;GG  A" *&&q))))ob)CHH444&&q)))zzc/22e;; 1 N33Aq7IJJKs?++a/00 ` `A  # #CM 2 2 2  # #''(:SXX(EWX[\W\G]^^ ` ` ` `  ... 7 78KcRUhh8VX\ ] ]^^^   ! '  $ $ & & & !  A NNa NNN?###r#cH|dkrdS||}||}t|dkrtd|||\}}||urt j|}||||||dn||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.)rOr2rN_validate_slicer'r)rr~rr]rrrs r!replacezBitArray.replace.s* A::1((--((-- s88q==BCC C))%55 s $;;)D//C}}S#uc 115R]^^^r#posc<||}t|dkrdS||ur|}|dkr|t|z }d|cxkrt|ksntd|||dS)zInsert bs at bit position pos. bs -- The bitstring to insert. pos -- The bit position to insert at. Raises ValueError if pos < 0 or pos > len(self). rNzInvalid insert position.)rOr2rrN_insertrr9rs r!insertzBitArray.insertPs ' ' + + r77a<< F ::B 77 3t99 CC$$$$3t99$$$$788 8 Rr#c||}t|dkrdS|dkr|t|z }|dks|t|krtd|||dS)zOverwrite with bs at bit position pos. bs -- The bitstring to overwrite with. pos -- The bit position to begin overwriting from. Raises ValueError if pos < 0 or pos > len(self). rNz/Overwrite starts outside boundary of bitstring.)rOr2rN _overwriters r! overwritezBitArray.overwriteds ' ' + + r77a<< F 77 3t99 C 77cCIIooNOO O C     r#c0||dS)z^Append a bitstring to the current bitstring. bs -- The bitstring to append. Nr;r=s r!rzBitArray.appendvs Rr#c0||dS)z`Prepend a bitstring to the current bitstring. bs -- The bitstring to prepend. N)_prependr=s r!prependzBitArray.prepend~s br#cV|||dSrd) _addrightrOr=s r! _append_msb0zBitArray._append_msb0s( t11"5566666r#cZ||}||dSrd)rO_addleftr=s r! _append_lsb0zBitArray._append_lsb0s-  ' ' + + br#c |||\}}|dkr.|t|kr|jdS|||}|j||||<dS)aMReverse bits in-place. start -- Position of first bit to reverse. Defaults to 0. end -- One past the position of the last bit to reverse. Defaults to len(self). Using on an empty bitstring will have no effect. Raises ValueError if start < 0, end > len(self) or end < start. rN)rr2rr_slice)rr]rr`s r!rzBitArray.reverses))%55 s A::#T** N " " $ $ $ F KKs # # U3Yr#r#Optional[Union[int, Iterable[int]]]cD|||rdnddSt|tjs|f}|rdnd}t|tr;|jt|j|j |j |dS|D] }||j|< dS)aSet one or many bits to 1 or 0. value -- If bool(value) is True bits are set to 1, otherwise they are set to 0. pos -- Either a single bit position or an iterable of bit positions. Negative numbers are treated in the same way as slice indices. Defaults to the entire bitstring. Raises IndexError if pos < -len(self) or pos >= len(self). NrFrrE) _setintrKrrrZrr_rUr]r^rX)rr5rvps r!rYz BitArray.sets ; LLu+! , , , F#s|,, &C AAA c5 ! !  N & &uSY#('K'KQ O O O F " "A !DN1   " "r##Optional[Union[Iterable[int], int]]c||dSt|tjs|f}t |}|D]D}|dkr||z }d|cxkr|ksnt d|d||EdS)aInvert one or many bits from 0 to 1 or vice versa. pos -- Either a single bit position or an iterable of bit positions. Negative numbers are treated in the same way as slice indices. Raises IndexError if pos < -len(self) or pos >= len(self). NrrIrJ) _invert_allrKrrr2rR_invert)rrrrs r!invertzBitArray.inverts ;       F#s|,, &CT  A1uuV ????F???? !B!B!B!BCCC LLOOOO   r#bitsct|std|dkrtd||||dS)zRotate bits to the right in-place. bits -- The number of bits to rotate by. start -- Start of slice to rotate. Defaults to 0. end -- End of slice to rotate. Defaults to len(self). Raises ValueError if bits < 0. !Cannot rotate an empty bitstring.r!Cannot rotate by negative amount.N)r2r rN_rorrrr]rs r!rorz BitArray.rorU4yy =;<< < !88@AA A $s#####r#c|||\}}|||z z}|sdS|||z |}||||z |||dSrdrr_deleter)rrr]rrhss r! _ror_msb0zBitArray._ror_msb0s))%55 s u  Fkk#*c** T3:&&& S%     r#ct|std|dkrtd||||dS)zRotate bits to the left in-place. bits -- The number of bits to rotate by. start -- Start of slice to rotate. Defaults to 0. end -- End of slice to rotate. Defaults to len(self). Raises ValueError if bits < 0. rrrN)r2r rN_rolrs r!rolz BitArray.rolrr#c|||\}}|||z z}|dkrdS||||z}|||||||z dS)Nrr)rrr]rlhss r! _rol_msb0zBitArray._rol_msb0s))%55 s u 199 Fkk%.. T5!!! S#*%%%%%r#Tfmt(Optional[Union[int, Iterable[int], str]]repeatboolc x|||\}}||dkr ||z dzg}nt|tjr|dkrt d|d|g}ndt|t rt j|x}st d|dtj t j | d} g}| D]} t| dkr&|t j| ;|t j| d gt#| dd zndt|t$jr;|}|D]5} t| tjr| dkrt d| d6nt)d d} dt+|z} | sdS|r|}n|| z}t-|| z|dz| D]7}|| z }|D](} || dzz}||||| dzz })| dz } 8| S) aChange the endianness in-place. Return number of repeats of fmt done. fmt -- A compact structure string, an integer number of bytes or an iterable of integers. Defaults to 0, which byte reverses the whole bitstring. start -- Start bit position, defaults to 0. end -- End bit position, defaults to len(self). repeat -- If True (the default) the byte swapping pattern is repeated as much as possible. NrzImproper byte length rGzCannot parse format string rrErFz.Format must be an integer, string or iterable.)rrKrLrMrNstrr BYTESWAP_STRUCT_PACK_REmatchrerSTRUCT_SPLIT_REgroupr2rPACK_CODE_SIZEextendrBrrrPsumrZ _reversebytes)rrr]rrstart_vend_v bytesizesm formatlistfbytesizerepeats totalbitsizefinalbit patternend bytestartbyteends r!byteswapzBitArray.byteswaps--eS99 ;#(('/a/0II W- . . NQww !?!?!?!?@@@II S ! ! N6<>JJJI R Rq66Q;;$$U%9!%<====$$e&:1R5&A%BS3B3[[%PQQQQ  R S\ * * NI% J J!(G,<==JA$%HX%H%H%HIIIBN JLMM MI.  1  .HH-H, 61 lSS  J"\1I% * *#hl2""9g666X\) qLGGr#c.|dS)z&Remove all bits, reset to zero length.N)_clearr&s r!rzBitArray.clear>s r#)NNN)rrrrrrrr)rrrr)rr)r9rrr)rr)rArBr5rCrr)rArUr5rrr)rArbr5rrr)rArbrr)rrrgrBrr)rrr9rrr)r~r rr r]rBrrBrrBrrrrB)NNNN)r~rrrr]rrrrrrrrrB)r9rrrBrr)r9rrr)NN)r]rrrrrrd)r5rrrrr)rrrr)rrBr]rrrrr)rrBr]rrr)NNNT) rrr]rrrrrrrB)(__name__ __module__ __qualname____doc__ __slots__r__annotations__r"r'r*r>r%rTrar_rfrnrrrurxr{r}rrrrrrrrrrYrrrrrrr __classcell__)r8s@r!rrs(44lIH_c)-*-*-*-*-*-X IIII$99990,,,,                     $$$$>gkKO _ _ _ _ _D(!!!!$7777("""""0.$$$$$ !!!!!$$$$$ &&&&&ei;?:::::xr#r) __future__rr'rLr collectionsrtypingrrrrr r,r bitstring.exceptionsr r bitstring.bitsr rrbitstring.dtypesrrr#r!rs""""""  77777777777777555555550000000000qqqqqtqqqqqr#