"fdZddlmZddlmZmZddlmZddlmZGdde Z de d d d d d d d d e de de dee dee dedededee defdZd S)zBit fields data store type.)EnumMeta)AnyOptional)EnumX)FlagXcFeZdZdZdedededeedeededed ed eefd Z e d efd Z e d eefdZ e d efdZ e d efdZe d efdZe d efdZe d efdZe d efdZe d efdZe d efdZe d efdZe d efdZe d efdZe d efdZe d efdZdefdZded dfdZd Zd!Zd"Zd#ZdS)$BitFieldaBit field definition. :param doc: one line description :param size: size in bits :param typ: bit field type, default uses type annotation :param lsb: bit offset of least significant bit :param default: initial value when unspecified :param signed: interpret as signed integer :param ignore: do not include field in comparisons :param readonly: block setting member attribute :param argrepr: format to represent member argument in structure repr docsizetyplsbdefaultsignedignorereadonlyargreprc t||$t|}|dkrtdt|}t |}|r|dkrt dd|dz z} n|dkrt dd} | rd|dz z } d| z } n d} d|zdz } |3t|}| |cxkr| ksnt d| d| ||_||_||_d|zdz |_ | |_ | |_ d|_ ||_ | |_||_d|_||_| |_||dS) Nrz8bit field position must be greater than or equal to zerorz0'size' must be 2 or greater for signed bit fieldz2'size' must be 1 or greater for unsigned bit fieldzbit field requires z <= default <= )property__init__int TypeErrorbool ValueError_doc_default_ignore_mask _minvalue _maxvalue_name_lsb_signbit_size _make_type _readonly_argrepr_set_typ) selfr r r rrrrrrsignbitminvaluemaxvalues [/mounts/lovelace/software/anaconda3/lib/python3.11/site-packages/plum/bitfields/bitfield.pyrzBitField.__init__!s $ ?c((CQwwN4yyf  axx !STTTD1HoGGaxx !UVVVG  'tax)HXHHHT QH  'llGw2222(2222 M(MM8MM   4i1_ !!$(    !  creturnct|jtr|j}nFt|jtt fr|jd|jd}n|jd|jd}|S)zAFormat string to represent bit field argument in bit fields repr.z ={repr(self.z).split(':')[0].lstrip('<')}z={self.z!r}) isinstancer(str_typrrname)r* repr_formats r.rzBitField.argrepr_s} dmS ) ) @-KK  He#4 5 5 @9SS49SSS K "Y?? ???Kr/c|jS)z,Initializer default value for this bitfield.)rr*s r.rzBitField.defaulto }r/c|jS)zOne line bit field description.)rr8s r.r z BitField.docts yr/c|jS)z4Ignore when compared against bitfields of same type.)rr8s r.rzBitField.ignoreys |r/c<|jtd|jS)z$Bit offset of least significant bit.Ninternal error)r# RuntimeErrorr8s r.rz BitField.lsb~s# 9 /00 0yr/c|jS)z>Bit zero aligned bit mask covering the width of the bit field.)rr8s r.maskz BitField.mask zr/c|jS)z"Minimum allowable bit field value.)r r8s r.r,zBitField.minvalue ~r/c|jS)z"Maximum allowable bit field value.)r!r8s r.r-zBitField.maxvaluerCr/c<|jtd|jS)zBit field name.Nr=)r"r>r8s r.r5z BitField.names# : /00 0zr/c|jS)z"Block setting bit field attribute.)r'r8s r.rzBitField.readonlyrCr/c|jS)zBMask when anded with bit field value reveals if value is negative.)r$r8s r.r+zBitField.signbitr9r/c*t|jS)z&Interpret bit field as signed integer.)rr$r8s r.rzBitField.signedsDM"""r/c|jS)zBit field size in bits.)r%r8s r.r z BitField.sizerAr/cL|j}t|tr|j}|S)zType hint expression.)r4r2renum)r*r s r. type_hintzBitField.type_hints)i c5 ! ! (C r/c|jS)zPBit field type. :returns: bit field type :rtype: type )r4r8s r.r z BitField.typs yr/cbt|tot|t}t|tt fs|rn^t |dr?t|ds.|jr |j dnd}td|d|j dntd||_ dS)Nnested zbit field typ z(must be declared as nested (e.g. 'class z(BitFields, nested=True):')zbit field type must be int-like) r2type issubclassrrrhasattrgetattrr"r5r__name__r4)r*r is_int_subclassr5s r.r)zBitField._set_typs$S$//HJsC4H4H cE5> * * ?o ?  S( # # ?3)) ,0J>$)((((BHTHH!lHHH =>> > r/r5Ncr|j ||_dStd|dt|jd)zMComplete instance initialization. :param name: member name Nzinvalid bit field z definition, z8() instance can not be shared between bit fields classes)r"rrRrV)r*r5s r.finish_initializationzBitField.finish_initializationsU : DJJJ.T..::&... r/cd|jdS)NzBitField(name=))r"r8s r.__repr__zBitField.__repr__s/ ////r/cTt|||j|j|S)N)rrfsetfdel)r*fgets r.getterzBitField.getters%$di;;; r/c|jrtdt||j||j|S)Nz6'setter' not allowed on read-only bit field properties)rrrrr`r_)r*r^s r.setterzBitField.setters? = VTUU U$ 4;;; r/c td)Nz-bit field properties do not support 'deleter')r)r*r_s r.deleterzBitField.deletersGHHHr/) rV __module__ __qualname____doc__r3rrRrrrrrrr rrr@r,r-r5rr+rr rLr r)rYr\rarcrer/r.r r sb   < << < c] < # <<<<#<<<<|    X #XSXXSX cX#X#XcX $XX####X#cX4XTXD& # $    000IIIIIr/r rQNF)r rrrrrrr r r rrrrrrr0c 0t||||||||| S)aDefine bit field. :param doc: one line description :param size: size in bits :param typ: bit field type :param lsb: bit offset of least significant bit :param default: initial value when unspecified :param signed: interpret as signed integer :param ignore: do not include field in comparisons :param readonly: block setting member attribute :param argrepr: format to represent member argument in structure repr )r ) r r r rrrrrrs r.bitfieldrks"2 CsC&&(G T TTr/)rQ)rhrKrtypingrrrflagrrr rr3rRrrkrir/r.rnsb"! eIeIeIeIeIxeIeIeIRU!!UUU U U  U # U c] U U UUc]U UUUUUUr/