o h>xd0s@s:ddlmZmZmZmZmZmZmZddlm Z e ddl m Z ddl Z ddl mZmZddlmZddlmZmZzdd lmZmZmZmZmZmZmZmZmZmZmZmZWn#e y|dZZZZZZZZZZZZZ!Ynwddl"Z"dd l#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)dd l*m+Z+m,Z,m-Z-ddl*Z*e.dZ/dZ0Gd d d e1Z2e2Z0ddZ3Gddde4Z5Gddde1Z6e+j7j68e6Gddde6Z9Gddde6Z:Gddde6Z;Gddde6ZGd d!d!e6Z?Gd"d#d#e6Z@Gd$d%d%e6ZAGd&d'd'e6ZBdS)() nested_scopes generatorsdivisionabsolute_importwith_statementprint_functionunicode_literals)backport) native_strN) b64decode b64encodedeepcopy)datedatetime) UnionOptionalSequenceMappingSetrCallableDictAnyHashable CollectionTuple) collectionscollections_abcqualified_nameproperties_valuesparameters_defaultscalling_function_qualified_name)abcerrorsmetac@sXeZdZdZddZddZddZdd Zd d Zd d Z ddZ ddZ ddZ dS)Nullz Instances of this class represent an *explicit* null value, rather than the absence of a property/attribute/element, as would be inferred from a value of `None`. cCstdur tdt|dS)Nz%s may only be defined once.)NULLr$ZDefinitionExistsErrorreprselfr+9D:\rfid_django\env\Lib\site-packages\serial/properties.py__init__/s  z Null.__init__cCdS)NFr+r)r+r+r,__bool__5z Null.__bool__cCst|t|kSN)id)r*otherr+r+r,__eq__9sz Null.__eq__cCr.)Nrr+r)r+r+r,__hash__=r0z Null.__hash__cCr.)Nnullr+r)r+r+r,__str__Ar0z Null.__str__cCsdSr1r+r)r+r+r,_marshalEr0z Null._marshalcCs|jdvrdSd|jS)N)__main__builtins __builtin__r'z%s.NULL) __module__r)r+r+r,__repr__Is z Null.__repr__cC|Sr1r+r)r+r+r,__copy__Qr0z Null.__copy__cCr>r1r+r*memor+r+r, __deepcopy__Ur0zNull.__deepcopy__N) __name__r< __qualname____doc__r-r/r4r5r7r8r=r?rBr+r+r+r,r&)s r&cCsjt|ttfs t||tus3t|tr*t|tjjt t t t j ttttjttjtf s3t|ts3t||Sr1) isinstancetypeProperty TypeErrorr& issubclassr#modelModelstrr bytesnumbersNumberrrrIterabledictr OrderedDictbool)Ztype_or_propertyr+r+r,_validate_type_or_property]s6rUcspeZdZdZ dfdd ZfddZfddZfd d Zdfd d ZddZ dddZ ddZ Z S)Typesz Instances of this class are lists which will only take values which are valid types for describing a property definition. NcsZt|ts tdtt||_t|ttfr|f}|dur%tdSt|dS)NzBThe parameter `property` must be a `type`, or an instance of `%s`.)rFrHrIr property_rGsuperr-)r*rWitems __class__r+r,r-s  zTypes.__init__csFt|t||turtturt|vr!ttdSdSdSdSr1)rX __setitem__rUrMr appendr*indexvaluerZr+r,r\s zTypes.__setitem__csDtt||turtturt|vr ttdSdSdSdSr1)rXr]rUrMr )r*r`rZr+r,r]s z Types.appendcs:||}t||turt|vr|tdSdSdSr1)rX __delitem__rMr remover^rZr+r,ras  zTypes.__delitem__cs*t|}|turt|vr|t|Sr1)rXpoprMr rbr^rZr+r,rds  z Types.popcCs||j|Sr1)r[rWr)r+r+r,r?zTypes.__copy__cs ||jtfdd|DS)Nc3s|] }t|dVqdS)rANr.0vrfr+r, s  z%Types.__deepcopy__..)r[rWtupler@r+rfr,rBs  zTypes.__deepcopy__cCstt|dg}|rh|dd7<|D]C}t|tr t|nt|}|d}t|dkrQ|dg}|ddD] }|d|q:d|}|d|g7}q|d|q|d dd |d <|d |d d 7<t|d kr{d|Sd |S)N(r[ r  z %sz %s,rc]))rrGrFr(splitlenr]join)r*representationrirvrvlsrvsrvlr+r+r,r=s4     zTypes.__repr__r1)rc) rCr<rDrEr-r\r]rardr?rBr= __classcell__r+r+rZr,rVs     rVc@s~eZdZdZ    dddZeddZejddZed d Zejd d Zd d Z ddZ ddZ ddZ ddZ dS)rHa5 This is the base class for defining a property. Properties - value_types ([type|Property]): One or more expected value_types or `Property` instances. Values are checked, sequentially, against each type or `Property` instance, and the first appropriate match is used. - required (bool|collections.Callable): If `True`--dumping the json_object will throw an error if this value is `None`. - versions ([str]|{str:Property}): The property should be one of the following: - A set/tuple/list of version numbers to which this property applies. - A mapping of version numbers to an instance of `Property` applicable to that version. Version numbers prefixed by "<" indicate any version less than the one specified, so "<3.0" indicates that this property is available in versions prior to 3.0. The inverse is true for version numbers prefixed by ">". ">=" and "<=" have similar meanings, but are inclusive. Versioning can be applied to an json_object by calling `serial.meta.set_version` in the `__init__` method of an `serial.model.Object` sub-class. For an example, see `oapi.model.OpenAPI.__init__`. - name (str): The name of the property when loaded from or dumped into a JSON/YAML/XML json_object. Specifying a `name` facilitates mapping of PEP8 compliant property to JSON or YAML attribute names, or XML element names, which are either camelCased, are python keywords, or otherwise not appropriate for usage in python code. NFcCs(d|_||_||_||_d|_||_dSr1)_typestypesnamerequired _versionsversions)r*r~rrrr+r+r,r-s  zProperty.__init__cC|jSr1)r}r)r+r+r,r~zProperty.typesc@|durt|rttur|fdd}nt|}|_dS)Nct|Sr1rVdZ_types_or_propertiesr*r+r,types_or_properties-rez+Property.types..types_or_properties)callabler rMrVr})r*rr+rr,r~!s  cCrr1)rr)r+r+r,r7zProperty.versionscCs|dur@t|tttjfr|f}t|tjr tdd|D}n t|}t dt dt tjd|vr:d|d|||_ dS)Ncss*|]}t|tjr |nt|VqdSr1)rFr%Versionrgr+r+r,rjHs  z$Property.versions..z/`%s` requires a sequence of version strings or z`%s` instances, notrnz: z `%s`.) rFrMrPr%rrrQrkr(rIr"rr)r*rZ repr_versionsr+r+r,r<s,     cCst|tjr9t|ttttfs9t|tjj s9t|t t j fr0| D] \}}|dur.t||<q"n tdd|D}tjj||jdS)Ncss |] }|dur tn|VqdSr1)r')rhir+r+r,rjwsz%Property.unmarshal..r~)rFrrQrMrN bytearrayr r#rKrLrRrrSrYr'rkserialmarshal unmarshalr~)r*datakrir+r+r,r`s,  zProperty.unmarshalcCstjj||jdS)Nr)rrr~r*rr+r+r,r{szProperty.marshalcCstt|dg}t|j}t|D]\}}||vs |||kr!q|dur|turt|tjrt|t t fsdg}|D]G}t|trFt|nt|t j rRdt |nt |}|d}t|dkr{|dg} |ddD] } | d| qld| }|d|q;t|dkr|ddd|d<|d d|} n>t|trt|nt|t j rdt |nt |} | d} t| d kr| dg}| ddD] } |d | qd|} |d || fq|d t|d krd|Sd|S)Nrlz'%s'rnr rz z %s,rcz )rrroz %s=%s,rqrs)rrGr!r-r r'rFrrrMrNr%rr(rtrur]rv)r*rwpdprirzrriZrilsZrisZrilrxryr{r+r+r,r=s\                   zProperty.__repr__cCsL|}t|D]}|ddkr#|dkr#t||}t|s#t|||q|S)Nr_r)r[dirgetattrrsetattr)r* new_instancearir+r+r,r?s   zProperty.__copy__cCs0|}t|D] \}}t||t||q|Sr1)r[r rr)r*rArrrir+r+r,rBszProperty.__deepcopy__NNFN)rCr<rDrEr-propertyr~setterrrrr=r?rBr+r+r+r,rHs(     #3 rHc(eZdZdZ   dfdd ZZS)String* See `serial.properties.Property` NFctjtf|||ddSN)r~rrr)rXr-rMr*rrrrZr+r,r-  zString.__init__NFNrCr<rDrEr-r|r+r+rZr,r rc@eZdZdZdddejejffdd ZddZ dd Z Z S) Datea See `serial.properties.Property` Additional Properties: - marshal (collections.Callable): A function, taking one argument (a python `date` json_object), and returning a date string in the desired format. The default is `date.isoformat`--returning an iso8601 compliant date string. - unmarshal (collections.Callable): A function, taking one argument (a date string), and returning a python `date` json_object. By default, this is `iso8601.parse_date`. NFcs&tjtf|||d||_||_dSr)rXr-rdate2strstr2date)r*rrrrrrZr+r,r-s z Date.__init__cC\|dur|St|tr|}nt|tr||}ntdt|t|tr(|Std|)N%s is not a `str`.z-"%s" is not a properly formatted date string.)rFrrMrrIr()r*rZdate_r+r+r,r     zDate.unmarshalcCsT|dur|S||}t|ts(t|trt|}|Stdt|jt|f|S)Nz;The date2str function should return a `str`, not a `%s`: %s)rrFrMr rIrGrCr()r*rZdsr+r+r,rs   z Date.marshal) rCr<rDrEr isoformatiso8601 parse_dater-rrr|r+r+rZr,rrcr) DateTimea See `serial.properties.Property` Additional Properties: - marshal (collections.Callable): A function, taking one argument (a python `datetime` json_object), and returning a date-time string in the desired format. The default is `datetime.isoformat`--returning an iso8601 compliant date-time string. - unmarshal (collections.Callable): A function, taking one argument (a datetime string), and returning a python `datetime` json_object. By default, this is `iso8601.parse_date`. NFcs&||_||_tjtf|||ddSr) datetime2str str2datetimerXr-r)r*rrrrrrZr+r,r-6s zDateTime.__init__cCr)Nrz2"%s" is not a properly formatted date-time string.)rFrrMrrIr()r*rZ datetime_r+r+r,rGrzDateTime.unmarshalcCsb|dur|S||}t|ts/t|trt|}|St|}tdd|vr)dnd||S)Nz5The datetime2str function should return a `str`, not:rn )rrFrMr r(striprI)r*rZdatetime_stringZrepr_datetime_stringr+r+r,r[s$    zDateTime.marshal) rCr<rDrErrrrr-rrr|r+r+rZr,r(rrcs8eZdZdZ   d fdd ZddZdd ZZS) BytesrNFcstjttf|||ddSr)rXr-rNrrrZr+r,r-us  zBytes.__init__cCs@|dur|St|trt|St|tr|Stdtt|)z@ Un-marshal a base-64 encoded string into bytes N:`data` must be a base64 encoded `str` or `bytes`--not `%s`)rFrMr rNrIrrGrr+r+r,rs  zBytes.unmarshalcCsB|dus t|tr |St|trtt|dStdtt|)z= Marshal bytes into a base-64 encoded string Nasciir)rFrMrNr rIrrGrr+r+r,rs z Bytes.marshalr)rCr<rDrEr-rrr|r+r+rZr,rps rcsNeZdZdZ     d fdd ZeddZejddZd d ZZ S) Enumeratedz See `serial.properties.Property`... + Properties: - values ([Any]): A list of possible values. If the parameter `types` is specified--typing is applied prior to validation. NFcs$d|_tj||||d||_dSr)_valuesrXr-values)r*r~rrrrrZr+r,r-s zEnumerated.__init__cCrr1)rr)r+r+r,rrzEnumerated.valuescsb|dus,t|s,|durt|tjtjfstdtt||dur,fdd|D}|_dS)Nz4`values` must be a finite set or sequence, not `%s`.csg|] }tjj|jdqS)r)rrrr~rgr)r+r, sz%Enumerated.values..) rrFrrrrIrrGr)r*rr+r)r,rs  cCsf|jdurtjj||jd}|dur1|jdur1||jvr1tdt|dddd|jD|S)Nrz.The value provided is not a valid option: %s zValid options include: %sz, css|]}t|VqdSr1)r()rhtr+r+r,rjsz'Enumerated.unmarshal..)r~rrrr ValueErrorr(rvrr+r+r,rs  zEnumerated.unmarshal)NNNFN) rCr<rDrEr-rrrrr|r+r+rZr,rs   rcr)rPrNFcstjtjf|||ddSr)rXr-rOrPrrZr+r,r-s  zNumber.__init__rrr+r+rZr,rPrrPcr)IntegerrNFcrr)rXr-intrrZr+r,r-rzInteger.__init__rrr+r+rZr,rrrcr)BooleanrNFcrr)rXr-rTrrZr+r,r-$s  zBoolean.__init__rrr+r+rZr,rrrcsTeZdZdZ    d fdd ZddZdd Zed d Zej d d ZZ S)Arraya' See `serial.properties.Property`... + Properties: - item_types (type|Property|[type|Property]): The type(s) of values/objects contained in the array. Similar to `serial.properties.Property().value_types`, but applied to items in the array, not the array itself. NFc*d|_||_tjtjjf|||ddSr) _item_types item_typesrXr-rrKr)r*rrrrrZr+r,r-= zArray.__init__cCtjj||j|jdSN)r~r)rrrr~rrr+r+r,rMzArray.unmarshalcCstjj||j|jdSr)rrr~rrr+r+r,rQrz Array.marshalcCrr1)rr)r+r+r,rUrzArray.item_typescr)Ncrr1rrrr*r+r,rarez$Array.item_types..item_types)rr rMrVr)r*rr+rr,rYs  r) rCr<rDrEr-rrrrrr|r+r+rZr,r3s  rcsLeZdZdZ    d fdd ZddZedd Zejd d ZZ S) DictionaryaD See `serial.properties.Property`... + Properties: - value_types (type|Property|[type|Property]): The type(s) of values/objects comprising the mapped values. Similar to `serial.properties.Property.types`, but applies to *values* in the dictionary object, not the dictionary itself. NFcrr) _value_types value_typesrXr-rrKr)r*rrrrrZr+r,r-trzDictionary.__init__cCr)N)r~r)rrrr~rrr+r+r,rrzDictionary.unmarshalcCrr1)rr)r+r+r,rrzDictionary.value_typescs@|durt|rttur|fdd}nt|}|_dS)a The `types` can be either: - A sequence of types and/or `serial.properties.Property` instances. - A function which accepts exactly one argument (a dictionary), and which returns a sequence of types and/or `serial.properties.Property` instances. If more than one type or property definition is provided, un-marshalling is attempted using each `value_type`, in sequential order. If a value could be cast into more than one of the `types` without throwing a `ValueError`, `TypeError`, or `serial.errors.ValidationError`, the value type occuring *first* in the sequence will be used. Ncrr1r)rZoriginal_value_types_r*r+r, value_types_rez,Dictionary.value_types..value_types_)rr rMrVr)r*rr+rr,rs  r) rCr<rDrEr-rrrrr|r+r+rZr,ris  r)C __future__rrrrrrrZutilities.compatibilityr Z future.utilsr rObase64r r copyrrrtypingrrrrrrrrrrr ImportErrorrQrZ utilitiesrrrr r!r"rr#r$r%rGNoneTyper'objectr&rUlistrVrH propertiesregisterrrrrrrPrrrrr+r+r+r,sL$   < 0 1#q\FH1I!6