wBfxdZddlmZmZddlmZddlmZddlmZddl m Z m Z m ZddlmZddlmZdd lmZd d lmZd d lmZmZd d lmZd dlmZmZd dlm Z d dl!m"Z"d dl#m$Z$ ddl%m&Z&m%Z%ddl%m'Z(ddl%m)Z*ee(vr e*ed[([*ee/Z0gdZ1dZ2dZ3GddZ4Gdde4Z5e5Z6Gd d!e4Z7e7Z8Gd"d#e4Z9Gd$d%e4Z:Gd&d'e4Z;Gd(d)e4Z<Gd*d+e4Z=Gd,d-e=Z>Gd.d/e4Z?Gd0d1e4Z@Gd2d3eAZBGd4d5eB6ZCGd7d8eCZDGd9d:ZEGd;da This module provides serializable, validatable, type-enforcing domain objects and data transfer objects. It has many of the same motivations as the python `Marshmallow `_ package. It is most similar to `Schematics `_. ======== Tutorial ======== Chapter 1: Entity and Field Basics ---------------------------------- >>> class Color(Enum): ... blue = 0 ... black = 1 ... red = 2 >>> class Car(Entity): ... weight = NumberField(required=False) ... wheels = IntField(default=4, validation=lambda x: 3 <= x <= 4) ... color = EnumField(Color) >>> # create a new car object >>> car = Car(color=Color.blue, weight=4242.46) >>> car Car(weight=4242.46, color=0) >>> # it has 4 wheels, all by default >>> car.wheels 4 >>> # but a car can't have 5 wheels! >>> # the `validation=` field is a simple callable that returns a >>> # boolean based on validity >>> car.wheels = 5 Traceback (most recent call last): ValidationError: Invalid value 5 for wheels >>> # we can call .dump() on car, and just get back a standard >>> # python dict actually, it's an ordereddict to match attribute >>> # declaration order >>> type(car.dump()) >>> car.dump() OrderedDict([('weight', 4242.46), ('wheels', 4), ('color', 0)]) >>> # and json too (note the order!) >>> car.json() '{"weight": 4242.46, "wheels": 4, "color": 0}' >>> # green cars aren't allowed >>> car.color = "green" Traceback (most recent call last): ValidationError: 'green' is not a valid Color >>> # but black cars are! >>> car.color = "black" >>> car.color >>> # car.color really is an enum, promise >>> type(car.color) >>> # enum assignment can be with any of (and preferentially) >>> # (1) an enum literal, >>> # (2) a valid enum value, or >>> # (3) a valid enum name >>> car.color = Color.blue; car.color.value 0 >>> car.color = 1; car.color.name 'black' >>> # let's do a round-trip marshalling of this thing >>> same_car = Car.from_json(car.json()) # or equally Car.from_json(json.dumps(car.dump())) >>> same_car == car True >>> # actually, they're two different instances >>> same_car is not car True >>> # this works too >>> cloned_car = Car(**car.dump()) >>> cloned_car == car True >>> # while we're at it, these are all equivalent too >>> car == Car.from_objects(car) True >>> car == Car.from_objects({"weight": 4242.46, "wheels": 4, "color": 1}) True >>> car == Car.from_json('{"weight": 4242.46, "color": 1}') True >>> # .from_objects() even lets you stack and combine objects >>> class DumbClass: ... color = 0 ... wheels = 3 >>> Car.from_objects(DumbClass(), dict(weight=2222, color=1)) Car(weight=2222, wheels=3, color=0) >>> # and also pass kwargs that override properties pulled >>> # off any objects >>> Car.from_objects(DumbClass(), {'weight': 2222, 'color': 1}, color=2, weight=33) Car(weight=33, wheels=3, color=2) Chapter 2: Entity and Field Composition --------------------------------------- >>> # now let's get fancy >>> # a ComposableField "nests" another valid Entity >>> # a ListField's first argument is a "generic" type, >>> # which can be a valid Entity, any python primitive >>> # type, or a list of Entities/types >>> class Fleet(Entity): ... boss_car = ComposableField(Car) ... cars = ListField(Car) >>> # here's our fleet of company cars >>> company_fleet = Fleet(boss_car=Car(color='red'), cars=[car, same_car, cloned_car]) >>> company_fleet.pretty_json() #doctest: +SKIP { "boss_car": { "wheels": 4 "color": 2, }, "cars": [ { "weight": 4242.46, "wheels": 4 "color": 1, }, { "weight": 4242.46, "wheels": 4 "color": 1, }, { "weight": 4242.46, "wheels": 4 "color": 1, } ] } >>> # the boss' car is red of course (and it's still an Enum) >>> company_fleet.boss_car.color.name 'red' >>> # and there are three cars left for the employees >>> len(company_fleet.cars) 3 Chapter 3: Immutability ----------------------- >>> class ImmutableCar(ImmutableEntity): ... wheels = IntField(default=4, validation=lambda x: 3 <= x <= 4) ... color = EnumField(Color) >>> icar = ImmutableCar.from_objects({'wheels': 3, 'color': 'blue'}) >>> icar ImmutableCar(wheels=3, color=0) >>> icar.wheels = 4 Traceback (most recent call last): AttributeError: Assignment not allowed. ImmutableCar is immutable. >>> class FixedWheelCar(Entity): ... wheels = IntField(default=4, immutable=True) ... color = EnumField(Color) >>> fwcar = FixedWheelCar.from_objects(icar) >>> fwcar.json() '{"wheels": 3, "color": 0}' >>> # repainting the car is easy >>> fwcar.color = Color.red >>> fwcar.color.name 'red' >>> # can't really change the number of wheels though >>> fwcar.wheels = 18 Traceback (most recent call last): AttributeError: The wheels field is immutable. Chapter X: The del and null Weeds --------------------------------- >>> old_date = lambda: isoparse('1982-02-17') >>> class CarBattery(Entity): ... # NOTE: default value can be a callable! ... first_charge = DateField(required=False) # default=None, nullable=False ... latest_charge = DateField(default=old_date, nullable=True) # required=True ... expiration = DateField(default=old_date, required=False, nullable=False) >>> # starting point >>> battery = CarBattery() >>> battery CarBattery() >>> battery.json() '{"latest_charge": "1982-02-17T00:00:00", "expiration": "1982-02-17T00:00:00"}' >>> # first_charge is not assigned a default value. Once one is assigned, it can be deleted, >>> # but it can't be made null. >>> battery.first_charge = isoparse('2016-03-23') >>> battery CarBattery(first_charge=datetime.datetime(2016, 3, 23, 0, 0)) >>> battery.first_charge = None Traceback (most recent call last): ValidationError: Value for first_charge not given or invalid. >>> del battery.first_charge >>> battery CarBattery() >>> # latest_charge can be null, but it can't be deleted. The default value is a callable. >>> del battery.latest_charge Traceback (most recent call last): AttributeError: The latest_charge field is required and cannot be deleted. >>> battery.latest_charge = None >>> battery.json() '{"latest_charge": null, "expiration": "1982-02-17T00:00:00"}' >>> # expiration is assigned by default, can't be made null, but can be deleted. >>> battery.expiration datetime.datetime(1982, 2, 17, 0, 0) >>> battery.expiration = None Traceback (most recent call last): ValidationError: Value for expiration not given or invalid. >>> del battery.expiration >>> battery.json() '{"latest_charge": null}' )MappingSequence)datetime)Enum)reduce) JSONEncoderdumpsloads) getLogger)Path)isoparse)NULL) isiterableodict)AttrDict)RaiseValidationError) find_or_raise) DumpEncoder) maybecall) deepfreeze frozendict)getFreezeConversionMap)registerc|SNxs 3lib/python3.12/site-packages/conda/auxlib/entity.pyr"s1)r)make_immutable)EntityImmutableEntityField BooleanField BoolField IntegerFieldIntField NumberField StringField DateField EnumField ListFieldMapFieldComposableField__key_overrides__a Current deficiencies to schematics: - no get_mock_object method - no context-dependent serialization or MultilingualStringType - name = StringType(serialized_name='person_name', alternate_names=['human_name']) - name = StringType(serialize_when_none=False) - more flexible validation error messages - field validation can depend on other fields - 'roles' containing denylists for .dump() and .json() __roles__ = { EntityRole.registered_name: Denylist('field1', 'field2'), EntityRole.another_registered_name: Allowlist('field3', 'field4'), } TODO: - alternate field names - add dump_if_null field option - add help/description parameter to Field - consider leveraging slots - collect all validation errors before raising - Allow returning string error message for validation instead of False - profile and optimize - use boltons instead of dateutil - correctly implement copy and deepcopy on fields and Entity, DictSafeMixin http://stackoverflow.com/questions/1500718/what-is-the-right-way-to-override-the-copy-deepcopy-operations-on-an-object-in-p Optional Field Properties: - validation = None - default = None - required = True - in_dump = True - nullable = False Behaviors: - Nullable is a "hard" setting, in that the value is either always or never allowed to be None. - What happens then if required=False and nullable=False? - The object can be init'd without a value (though not with a None value). getattr throws AttributeError - Any assignment must be not None. - Setting a value to None doesn't "unset" a value. (That's what del is for.) And you can't del a value if required=True, nullable=False, default=None. - If a field is not required, del does *not* "unmask" the default value. Instead, del removes the value from the object entirely. To get back the default value, need to recreate the object. Entity.from_objects(old_object) - Disabling in_dump is a "hard" setting, in that with it disabled the field will never get dumped. With it enabled, the field may or may not be dumped depending on its value and other settings. - Required is a "hard" setting, in that if True, a valid value or default must be provided. None is only a valid value or default if nullable is True. - In general, nullable means that None is a valid value. - getattr returns None instead of raising Attribute error - If in_dump, field is given with null value. - If default is not None, assigning None clears a previous assignment. Future getattrs return the default value. - What does nullable mean with default=None and required=True? Does instantiation raise an error if assignment not made on init? Can IntField(nullable=True) be init'd? - If required=False and nullable=False, field will only be in dump if field!=None. Also, getattr raises AttributeError. - If required=False and nullable=True, field will be in dump if field==None. - If in_dump is True, does default value get dumped: - if no assignment, default exists - if nullable, and assigned None - How does optional validation work with nullable and assigning None? - When does gettattr throw AttributeError, and when does it return None? ceZdZdZdZedddddddfdZedZd Z d Z d Z d Z d Z dZdZdZedZedZedZedZedZedZedZedZy)r(a Fields are doing something very similar to boxing and unboxing of c#/java primitives. __set__ should take a "primitive" or "raw" value and create a "boxed" or "programmatically usable" value of it. While __get__ should return the boxed value, dump in turn should unbox the value into a primitive or raw value. Arguments: types_ (primitive literal or type or sequence of types): default (any, callable, optional): If default is callable, it's guaranteed to return a valid value at the time of Entity creation. required (boolean, optional): validation (callable, optional): dump (boolean, optional): rTNFrc ||_||_||_||_||_||_||_|tur t|_nQt|r|n|jdd||_|jd|jddt|tj|_txjdz c_yNr) _required _validation_in_dump_default_in_dump _nullable _immutable_aliasesr_defaultcallableboxvalidaterr( _order_helper) selfdefaultrequired validationin_dumpdefault_in_dumpnullable immutablealiasess r!__init__zField.__init__s!% /!# d? DM'/'8GdhhtTSZ>[DM MM$tYw5G H I"00 q r#cb |jS#t$rtjdwxYw)NzYThe name attribute has not been set for this field. Call set_name at class creation time.)_nameAttributeErrorlogerrorrDs r!namez Field.names4 ::   II> ?  s  .c||_|Sr)rO)rDrTs r!set_namezField.set_names  r#c |t|t|j}n|j|j}|%|jst d|jd|j|||S#t$r!t j dt dt$rC|jturt d|jdt|j}YwxYw)Nz3The name attribute has not been set for this field.z A value for z has not been setThe z field has been deleted.) getattrKEY_OVERRIDES_MAPrT__dict__rPrQrRKeyErrorrErrrJunboxrDinstance instance_typevals r!__get__z Field.__get__s .m->? J'' 2 ;t}} 4 {2J!KL Lzz(M377 X IIK L !VW W .||t#$|DII;>O%PQQ -  .s9A55A1C)(C)c|jr%|jrtd|jd|j ||j ||j ||j|j<y)NrX field is immutable.)rK_initdrPrTrBrA __class__r[rDr_ras r!__set__z Field.__set__s` >>hoo 4 {2F!GH H(,}}  HHXx113 7( $))$r#cH|jr%|jrtd|jd|jrtd|jd|j sd|j |j<y|j j|jdy)NrXrdz) field is required and cannot be deleted.)rKrerPrTrFrJr[pop)rDr_s r! __delete__zField.__delete__s >>hoo 4 {2F!GH H ]] 4 {2[!\] ] ,0H  dii (    ! !$))T 2r#c|Srrr^s r!rAz Field.box r#c|Srrr^s r!r]z Field.unboxrmr#c|Srrr^s r!dumpz Field.dumprmr#ct||jr|j|j|r|S|tur|js|S||j r|St t|dd|)zj Returns: True: if val is valid Raises: ValidationError rTzundefined name) isinstance_typer9rrFrJrrYrgs r!rBzField.validatesi c4:: &D,<,<,DHXHXY\H]J D[J [T]]J!'$8H"I3O Or#c|jSr)r8rSs r!rFzField.required ~~r#c|jSr)rsrSs r!typez Field.types zzr#c|jSr)r?rSs r!rEz Field.default }}r#c|jSr)r:rSs r!rHz Field.in_dumpryr#c|jSr)r;rSs r!rIzField.default_in_dumps$$$r#c|jSr) is_nullablerSs r!rJzField.nullablesr#c|jSr)r<rSs r!r}zField.is_nullablerur#c|jSr)r=rSs r!rKzField.immutables r#)__name__ __module__ __qualname____doc__rCrrMpropertyrTrVrbrhrkrAr]rprBrFrwrErHrIrJr}rKrr#r!r(r(ns "M#dtteu^`!$8&  3P&%%  r#r(ceZdZeZdZy)r)c |dSt|Sr)boolr^s r!rAzBooleanField.box s{t1S 1r#N)rrrrrsrArr#r!r)r) s E2r#r)ceZdZeZy)r+N)rrrintrsrr#r!r+r+s Er#r+ceZdZeeefZy)r-N)rrrrfloatcomplexrsrr#r!r-r-s % !Er#r-ceZdZeZdZy)r.cPt|tjr t|S|Sr)rrr-rsstrr^s r!rAzStringField.box!s %c;+<+<=s3xF3Fr#N)rrrrrsrArr#r!r.r.s EGr#r.ceZdZeZdZdZy)r/cz t|tr t|S|S#t$r}t ||d}~wwxYwNmsg)rrrr ValueErrorr)rDr_r`raes r!rAz DateField.box(s< .$.sC$88C= Ac A .!#1- - .s : 5:c*|dS|jSr) isoformatr^s r!rpzDateField.dump.s{t7 7r#N)rrrrrsrArprr#r!r/r/%s E. 8r#r/c<eZdZedddddddffd ZdZdZxZS)r0TNFrc zt|ts tdd||_t ||||||||| y)Nz&enum_class must be an instance of Enumr) issubclassrrrssuperrM) rD enum_classrErFrGrHrIrJrKrLrfs r!rMzEnumField.__init__4sA*d+!$,TU U   Xz7OXyZa r#c|y |j|S#t$r4} |j|cYd}~S#t$rt||wxYwd}~wwxYwr)rsrr\r)rDr_r`rae1s r!rAz EnumField.box=s[ ; 3::c? " 3 3zz#& 3%cr22 3  3s# A4AA  AAc2|dtfvrdS|jSr)rvaluer^s r!rpzEnumField.dumpKstTl*t9 9r#rrrrrMrArp __classcell__rfs@r!r0r02s%+/$4teu^`  3:r#r0cPeZdZeZedddddddffd ZdZdZdZ fd Z xZ S) r1TNFrc @||_t | |||||||| yr) _element_typerrM) rD element_typerErFrGrHrIrJrKrLrfs r!rMzListField.__init__Rs*)  Xz7OXyZa r#c|yt|trtd|jt |rn|j tt r*ttr|jfd|DS|jr t|S|j|St|d|j)Nz*Attempted to assign a string to ListField c3JK|]}t|r|ndi|ywNr)rr).0vets r! z ListField.box..cs%!S!z!R'8!bg1g"E!S #&Cannot assign a non-iterable value to r) rrrrrTrrrwrr&rsrKr)rDr_r`rars @r!rAz ListField.boxYs ; S !!zz!Ss!SSS*...z#MdjjoM!A$))M r#cB||js|jS|Sr)rJrsr^s r!r]zListField.unboxks"{4==tzz|IcIr#ct|jtr2t|jtr|j d|DS|S)Nc3<K|]}|jywrrp)rrs r!rz!ListField.dump..ps41affh4s)rrrrwrr&rsr^s r!rpzListField.dumpns< d(($ /Jt?Q?QSY4Z::444 4Jr#c~t||}|r'jjfd|D|S)Nc3vK|]0}t|s"ttj|2ywr)rrrrrT)relrrDs r!rz%ListField.validate..xs42R(R0_TYYB?@2s69)rrBrrs)rDr_rarrfs` @r!rBzListField.validatets?gx- ##B JJ232 2 r#) rrrtuplersrrMrAr]rprBrrs@r!r1r1Os: E-1DTteu^` $J r#r1ceZdZeZy)MutableListFieldN)rrrlistrsrr#r!rr}s Er#rc:eZdZeZedddddddffd ZdZxZS)r2TNFrc 2t |||||||||yr)rrM) rDrErFrGrHrIrJrKrLrfs r!rMzMapField.__init__s$  Xz7OXyZa r#c||jSt|r7t|}t|tst |d|j |St |d|j )Nrr)rsrrrrrrrTr^s r!rAz MapField.boxsp ;::<  _S/Cc7+%Edii[QJ!A$))M r#) rrrrrsrrMrArrs@r!r2r2s, E  r#r2c<eZdZedddddddffd ZdZdZxZS)r3TNFrc @||_t | |||||||| yr)rsrrM) rD field_classrErFrGrHrIrJrKrLrfs r!rMzComposableField.__init__s)    Xz7OXyZa r#c|yt||jr|S t|dr|jd|d<t||jr*t||jr|S|jdi|St|t r|jdi|St|t rt|ts|j|S|j|S#t$rYwxYw)NrjrDslfr)rrrshasattrrjr\rrrr^s r!rAzComposableField.boxs ; c4:: &J 3&!$CJ#tzz*(djj9sPztzz?PC?PPC)!tzz(C((C*:c33G!tzz3''zz#&  s C C+*C+c*|dS|jSrrr^s r!rpzComposableField.dumps{t2 2r#rrs@r!r3r3s%,04Dteu^` ',3r#r3cReZdZedZfdZfdZfdZedZ xZ S) EntityTypec |Dcgc]}t|ts|tus| c}Scc}w#t$rYywxYwr)rr& NameError)basesbases r!__get_entity_subclassesz"EntityType.__get_entity_subclassess> %*^Tjv.F4W]K]D^ ^^  s 1,,,11 ==cDd|jD}tj|}|rL|Dcgc]tfd|Dr}}|Dcic]}||j |c}|t <n i|t <t |||||Scc}wcc}w)Nc3hK|]*\}}t|ts|jds|,yw)__N)rrr( startswith)rkeyrs r!rz%EntityType.__new__..s1 UeU+CNN44H  02c3pK|]-}t|jjt/ywr)rrr[getr()rrrs r!rz%EntityType.__new__..s1'F+/(2$--2C2CC2H%'P'Fs36)itemsr"_EntityType__get_entity_subclassesanyrjrZr__new__) mcsrTrdctnon_field_keysentity_subclassesrkeys_to_overriderfs ` r!rzEntityType.__new__s !iik  '>>uE /= G#&'F3D'F$F!$ G  GDT%TCc3773<&7%TC! "%'C! "wsD%55 G&Us BBc\t||||t}d}ttj |D]?}d|j jD}|jt||At||_ t|dr|jyy)Nc |djSr7)rCrs r!r"z%EntityType.__init__..sAaD$6$6r#c3hK|]*\}}t|tr||j|f,ywr)rrr(rVrrTfields r!rz&EntityType.__init__..s4D%eU+u~~d+,rr __register__)rrMrreversedrwmror[rupdatesortedr __fields__rr) clsrTrattrfields_field_sort_keyclz clz_fieldsrfs r!rMzEntityType.__init__s ud+6DHHSM* CC#&<<#5#5#7J MM&A B  C$F+ 3 '     (r#c\t||i|}t|d|jdd|S)N___initdT)r__call__setattrr)rargskwargsr_rfs r!rzEntityType.__call__s57#T4V4Acll^73T:r#c6|jjSr)rkeysrs r!rzEntityType.fieldss~~""$$r#) rrr staticmethodrrrMrrrrrs@r!rrs86&" %%r#rceZdZeZdZdZedZedZ edZ dZ dZ edZ dd Zdd Zd Zed ZdZdZedZy )r&Fc d|jjD]\}} t||||js|j!yy#t$rt fd|j Dd}|t|||n|t |tvrt||t |t|nP|jrD|jtur2t|dj|jj|Yt$r| |jrYwxYw)Nc3,K|] }|vs| ywrr)rlsrs r!rz"Entity.__init__..sJRR6\bJs z,{} requires a {} field. Instantiated with {}r)rrrr\nextr>rYrZrFrErrformatrfr_lazy_validaterB)rDrrraliass ` r!rMzEntity.__init__s////1 JC c6#;/ &"" MMO#! J5>>JDQ$D#ve}5GD*;<<D#wt5F'G'LM^^ (=)#VDNN$;$;S&I # #;*enn/= sAB.s,E !,6a+>HQKAEEs')r)rrrrr>rP)robjectsoverride_fields init_vars search_mapsrrs r! from_objectszEntity.from_objectss E'6&87&BEE ....0 JC !.sK!P #  Y"  sA A*)A*c$|dit|Sr) json_loads)rjson_strs r! from_jsonzEntity.from_json's*Z)**r#c|di|Srr)r data_dicts r!loadz Entity.load+sYr#c tfddjjDy#t$r}t |dk(rYd}~yYd}~yd}~wt $r}t d|d}~wwxYw)Nct|SrrY)rrTrDs r!r"z!Entity.validate..3sd 3r#c3@K|]\}}|js|ywr)rFrs r!rz"Entity.validate..4sS+$ENNSz0reduce() of empty sequence with no initial valuer)rrr TypeErrorrrPr)rDrs` r!rBzEntity.validate/sf / 3S)>)>)@S  1vKKL /!$A. . /s .2 A1A A1 A,,A1cfdfdfd}djfdtj|D}jjd|dS) NcHd|vry t|y#t$rYywxYw)NrFT)rYrP)rrDs r!_validzEntity.__repr__.._valid=s3s{ c"!  s  !!c|t|}t|trt|jSt|Sr)rYrrrreprr)rrarDs r!_valzEntity.__repr__.._valIs/$$C&0d&;4 ? Jc Jr#cZjj|}| |jSdS)N)rrrC)rrrDs r! _sort_helperz%Entity.__repr__.._sort_helperMs-OO'',E*/*;5&& C Cr#z, c3JK|]}|s |d|yw)=Nr)rrrrs r!rz"Entity.__repr__..Qs. %(W]^aWbse1T#YK  s ##r())joinrr[rfr)rDr" kwarg_strrrs` @@r!__repr__zEntity.__repr__<s\  K DII ,24==l,S  ..))*!I;a88r#cyrrrs r!rzEntity.__register__Vs r#Nc *t|f||td|S)N)indent separatorsr) json_dumpsrrDr,r-rs r!jsonz Entity.jsonZs$`v*+`Y_``r#c ,|jd||d|S)N)r,r-r)r0r/s r! pretty_jsonzEntity.pretty_json]styyH:HHHr#cZtfdfdjDDS)Nc3K|]R\}}|turE||jur |jr+|j|j j |fTywr)rrErIrTrprf)rrrrDs r!rzEntity.dump..asUS%T)5EMM3I;@;P;P jj%**T4>>5"IJSsAAc3XK|]!}|t|jtf#ywr)rYrTrrrrDs r!rzEntity.dump..bs-*M.3,1'$ D2Q*R*Ms'*)r_Entity__dump_fieldsrSs`r!rpz Entity.dump`s6S*M7;7I7I7K*MSS Sr#cd|jvr/td|jjD|_|jS)N__dump_fields_cachec3:K|]}|js|ywr)rH)rrs r!rz'Entity.__dump_fields..js,emm,s)r[rrvalues_Entity__dump_fields_cachers r! __dump_fieldszEntity.__dump_fieldsgsC  4&+,#&>>#8#8#:,'C #&&&r#cjjk7rydtfdjDS)NFl"jyc3TK|]}t|t|k(!ywrr)rrother rando_defaultrDs r!rz Entity.__eq__..ss114 6'%P]:^^1s%()rfallr)rDr@rAs``@r!__eq__z Entity.__eq__os9 >>U__ ,# 1 $11 1r#c@tfdjDS)Nc3JK|]}tt|dywr)hashrYr6s r!rz"Entity.__hash__..wsQ4eT23Qr)sumrrSs`r!__hash__zEntity.__hash__vsQQQQr#cLt|d|jjddS)Nrr)rYrfrrSs r!rez Entity._initdys%tq!8!8 9A4HHr#)NN)r$),z: )rrrrrrrM classmethodr rrrBr)rr0r2rpr7rCrHrrerr#r!r&r&sJN.    ++   /94  aIS''1RIIr#r&) metaclassc(eZdZfdZfdZxZS)r'c|jr#td|jjdt|||y)NzAssignment not allowed.  is immutable.)rerPrfrr __setattr__)rD attributerrfs r!rPzImmutableEntity.__setattr__s? ;; *4>>+B+B*C>R  Iu-r#c|jr#td|jjdt||y)NzDeletion not allowed. rO)rerPrfrr __delattr__)rDitemrfs r!rSzImmutableEntity.__delattr__s8 ;; #9$..:Q:Q9RR`!ab b D!r#)rrrrPrSrrs@r!r'r'~s.""r#r'cLeZdZdZdZdZd dZdZdZdZ d Z d Z d d Z y) DictSafeMixinct||Srr)rDrTs r! __getitem__zDictSafeMixin.__getitem__stT""r#ct|||yrr)rDrrs r! __setitem__zDictSafeMixin.__setitem__sc5!r#ct||yr)delattrrDrs r! __delitem__zDictSafeMixin.__delitem__s cr#Nct|||Srr)rDrTrEs r!rzDictSafeMixin.getstT7++r#ct||d}|y|j|}t|ttfrt |dkDSy)NFrT)rYrrrr2r1len)rDrTrrs r! __contains__zDictSafeMixin.__contains__sFdD) =% eh 2 3u:> !r#c#@K|jD] }||vs| ywr)rr^s r!__iter__zDictSafeMixin.__iter__s%?? Cd{  rc#XK|jD]}||vs|t||fywr)rrYr^s r!rzDictSafeMixin.itemss2?? .Cd{74--- .s**cB|jdi|jSr)rfrprSs r!copyzDictSafeMixin.copyst~~, ,,r#c(||vrt|||yyrrZ)rDr default_values r! setdefaultzDictSafeMixin.setdefaults d? D#} - r#c | |jD] \}}|||<  |D] }||||< y#t$r|D] \}}|||< Y*wxYwr)rrP)rDEFkrs r!rzDictSafeMixin.updates{ = GGI DAqDG  AdDG "  DAqDG  s2A  A r) rrrrXr[r_rrcrerrhrkrrr#r!rVrVs4#", . -. r#rVceZdZdZy) EntityEncoderc|t|dr|jSt|dr|jSt|dr|jSt|dr|j St |t r |jSt |tr t|Stj||S)Nrp__json__to_jsonas_json) rrprsrtrurrrrr rrrE)rDobjs r!rEzEntityEncoder.defaults 3 88:  S* %<<> ! S) $;;= S) $;;= T "99  T "s8O""4--r#N)rrrrErr#r!rqrqs .r#rqN)Grcollections.abcrrrenumr functoolsrr0rr r.r rloggingr pathlibr boltons.timeutilsr rcompatrr collectionr exceptionsrrishrlogzr type_coercionrrrr_getFreezeConversionMapr _register ImportError_vendor.frozendictauxlib.collectionr%rrQ__all__rZNOTESr(r)r*r+r,r-r.r/r0r1rr2r3rwrr&r'rVrqrr#r!rskZ.FF&% .$A1L0 *,, $ %  (O dXXv252  5 "%"G%G 8 8:::++\y u F 3e 3F5%5%p|Iz|I~ "f "55p.K.sA/@As()EE)(E)