3 =^@s<ddlmZddlZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl mZddl mZddlmZmZmZmZddlmZdd lmZdd lmZmZdd lmZm Z m!Z!m"Z"dd l#m$Z$dd l%m&Z&m'Z'ddl(m)Z)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0ddl1m2Z3ddl4m5Z5ddl6m7Z7ddl8m9Z9m:Z:m;Z;mZ>m?Z?m@Z@ddlAmBZBmZddlCmDZDddlEmFZFmGZGmHZHmIZIGdddZJejKrddZLnddZLddZMd d!ZNd"d#ZOd$d%ZPdtd&d'ZQd(d)ZRGd*d+d+eSZTGd,d-d-eSZUGd.d/d/eVZWeXejYd0ZZd1Z[d2Z\d3Z]d4Z^d5Z_Gd6d7d7eSZ`Gd8d9d9e`ZaGd:d;d;e`ZbGdd?d?ecZdGd@dAdAecZeGdBdCdCecZfGdDdEdEecZgGdFdGdGe`ZhGdHdIdIecZiGdJdKdKe`ZjGdLdMdMe`ZkGdNdOdOe`ZlGdPdQdQe`ZmGdRdSdSe`ZnGdTdUdUe`ZoGdVdWdWe`ZpGdXdYdYe`ZqGdZd[d[eqZrGd\d]d]eqZGd^d_d_e`ZsGd`dadaesZGdbdcdce`ZtGdddedee`ZuGdfdgdge`ZvGdhdidievZwGdjdkdke`ZxGdldmdme`ZyGdndodoe`ZzGdpdqdqe`Z{Gdrdsdse`Z|dS)u)unicode_literalsN) OrderedDict)settings)ObjectDoesNotExist)ValidationError)EmailValidatorRegexValidator URLValidatorip_address_validators) FilePathField) ImageField)sixtimezone) parse_dateparse_datetimeparse_duration parse_time)duration_string)is_protected_type smart_text)localize_inputsanitize_separators)lazy)clean_ipv6_address)utc) ugettext_lazy)InvalidTimeError)ISO_8601)MappingMaxLengthValidatorMaxValueValidatorMinLengthValidatorMinValueValidatorProhibitNullCharactersValidator unicode_reprunicode_to_repr) ErrorDetailr) api_settings)htmlhumanize_datetimejsonrepresentationc@seZdZdZdS)emptyz This class is used to represent no data being provided for a given input or output value. It is required because `None` may be a valid input or output value. N)__name__ __module__ __qualname____doc__r1r1D/tmp/pip-build-8app2_gc/djangorestframework/rest_framework/fields.pyr,,sr,cCsJtj|ptj|pt|tjs$dStj|}|jj}t dd|DS)zK True if the object is a callable that takes no arguments. Fcss2|]*}|j|jkp(|j|jkp(|j|jkVqdS)N)kindVAR_POSITIONAL VAR_KEYWORDdefaultr,).0paramr1r1r2 Asz%is_simple_callable..) inspect isfunctionismethod isinstance functoolspartial signature parametersvaluesall)objsigparamsr1r1r2is_simple_callable7s   rGc Csttj|}tj|}|p|s dS|r.|jdk}tj|\}}}}|sH|rPt|n t|d}|rht|nd}||kS)NFr)r:r;r<Zim_self getargspeclen) rDfunctionmethodZ is_unboundargs_defaultsZlen_argsZ len_defaultsr1r1r2rGHs   cCsx|D]}y"t|tr ||}n t||}Wntk r@dSXt|ry |}Wqttfk r}ztdj||WYdd}~XqXqW|S)z Similar to Python's built in `getattr(instance, attr)`, but takes a list of nested attributes, instead of a single attribute. Also accepts either attribute lookup on objects or dictionary lookups. NzIException raised in callable attribute "{0}"; original exception was: {1}) r=rgetattrrrGAttributeErrorKeyError ValueErrorformat)instanceattrsattrexcr1r1r2 get_attributeYs    &rYcCsP|s|j|dSx,|ddD]}||kr4i||<||}q W|||d<dS)a1 Similar to Python's built in `dictionary[key] = value`, but takes a list of nested keys instead of a single key. set_value({'a': 1}, [], {'b': 2}) -> {'a': 1, 'b': 2} set_value({'a': 1}, ['x'], 2) -> {'a': 1, 'x': 2} set_value({'a': 1}, ['x', 'y'], 2) -> {'a': 1, 'x': {'y': 2}} NrHrZ)update) dictionarykeysvaluekeyr1r1r2 set_valuets   r`cCs\t}xP|D]H}t|ttfs(|||<q |\}}t|ttfrLt|||<q |||<q W|S)z Convert choices into key/value dicts. to_choices_dict([1]) -> {1: 1} to_choices_dict([(1, '1st'), (2, '2nd')]) -> {1: '1st', 2: '2nd'} to_choices_dict([('Group', ((1, '1st'), 2))]) -> {'Group': {1: '1st', 2: '2'}} )rr=listtupleto_choices_dict)choicesretchoicer_r^r1r1r2rcs    rccCsRt}xF|jD]:\}}t|trBx&|jD]\}}|||<q,Wq|||<qW|S)z Convert a group choices dict into a flat dict of choices. flatten_choices_dict({1: '1st', 2: '2nd'}) -> {1: '1st', 2: '2nd'} flatten_choices_dict({'Group': {1: '1st', 2: '2nd'}}) -> {1: '1st', 2: '2nd'} )ritemsr=dict)rdrer_r^sub_key sub_valuer1r1r2flatten_choices_dicts  rkc csGdddt}Gdddt}Gdddt}d}x|jD]\}}|rT||krTPt|tr||dVx8|jD],\} } |r||krP|| | d V|d 7}qtW|Vq>|||d V|d 7}q>W|r||kr|r|j|d }|d |d dVdS)zE Helper function for options and option groups in templates. c@seZdZdZdZddZdS)z&iter_options..StartOptionGroupTFcSs ||_dS)N)label)selfrlr1r1r2__init__sz/iter_options..StartOptionGroup.__init__N)r-r.r/start_option_groupend_option_grouprnr1r1r1r2StartOptionGroupsrqc@seZdZdZdZdS)z$iter_options..EndOptionGroupFTN)r-r.r/rorpr1r1r1r2EndOptionGroupsrrc@seZdZdZdZdddZdS)ziter_options..OptionFcSs||_||_||_dS)N)r^ display_textdisabled)rmr^rsrtr1r1r2rnsz%iter_options..Option.__init__N)F)r-r.r/rorprnr1r1r1r2Optionsrur)rl)r^rsrH)countzn/aT)r^rsrtN)objectrgr=rhrT) grouped_choicescutoff cutoff_textrqrrrurvr_r^rirjr1r1r2 iter_optionss(         r{c sVt|ddpdy |j}Wn$tk r>fdd|jDSXfdd|jDS)zf Given a Django ValidationError, return a list of ErrorDetail, with the `code` populated. codeNinvalidcs0g|](}t|j|jpf|jr$|jndqS))r|)r&messagerFr|)r7error)r|r1r2 sz$get_error_detail..cs$i|]\}}fdd|D|qS)cs0g|](}t|j|jpf|jr$|jndqS))r|)r&r~rFr|)r7r)r|r1r2rsz/get_error_detail...r1)r7kerrors)r|r1r2 sz$get_error_detail..)rP error_dictrQZ error_listrg)exc_inforr1)r|r2get_error_details    rc@s0eZdZdZddZddZddZdd Zd S) CreateOnlyDefaultz This class may be used to provide default values that are only used for create operations, but that do not return any value for update operations. cCs ||_dS)N)r6)rmr6r1r1r2rnszCreateOnlyDefault.__init__cCs<|jjdk |_t|jr8t|jdr8|j r8|jj|dS)N set_context)parentrU is_updatecallabler6hasattrr)rmserializer_fieldr1r1r2rszCreateOnlyDefault.set_contextcCs$|jr tt|jr|jS|jS)N)r SkipFieldrr6)rmr1r1r2__call__ s  zCreateOnlyDefault.__call__cCstd|jjt|jfS)Nz%s(%s))r% __class__r-r$r6)rmr1r1r2__repr__szCreateOnlyDefault.__repr__N)r-r.r/r0rnrrrr1r1r1r2rs rc@s$eZdZddZddZddZdS)CurrentUserDefaultcCs|jdj|_dS)Nrequest)contextuser)rmrr1r1r2rszCurrentUserDefault.set_contextcCs|jS)N)r)rmr1r1r2rszCurrentUserDefault.__call__cCstd|jjS)Nz%s())r%rr-)rmr1r1r2r szCurrentUserDefault.__repr__N)r-r.r/rrrr1r1r1r2rsrc@s eZdZdS)rN)r-r.r/r1r1r1r2r$srz-May not set both `read_only` and `write_only`z+May not set both `read_only` and `required`z)May not set both `required` and `default`z-Field(read_only=True) should be ReadOnlyFieldzrValidationError raised by `{class_name}`, but error key `{key}` does not exist in the `error_messages` dictionary.c seZdZdZededdZgZeZdZ dddeedddddddf ddZ d d Z e d d Z e jd d Z ddZddZddZddZddZddZefddZddZddZd d!Zd"d#Ze d$d%Ze d&d'Zfd(d)Zd*d+Zd,d-ZZS).FieldrzThis field is required.zThis field may not be null.)requirednullNFc CsRtj|_tjd7_|dkr,|tko*| }|o2| s>tt|oD| sPtt|oZ|tk sftt|or|jtk s~tt||_ ||_ ||_ ||_ ||_ |tkr|jn||_||_||_| dkrin| |_| |_|jtk r|tk r||_| dk rt| |_d|_d|_i} x(t|jjD]}| jt|diqW| j| pDi| |_dS)NrHdefault_error_messages)r_creation_counterr,AssertionErrorNOT_READ_ONLY_WRITE_ONLYNOT_READ_ONLY_REQUIREDNOT_REQUIRED_DEFAULTrUSE_READONLYFIELD read_only write_onlyrr6sourceinitialrl help_textstyle allow_nulldefault_empty_htmlra validators field_namerreversed__mro__r[rPerror_messages)rmrrrr6rrrlrrrrrmessagesclsr1r1r2rn?s<  zField.__init__cCs|j|ks$td||jj|jjf||_||_|jdkrL|jddj|_|jdkr\||_|jdkrng|_ n|jj d|_ dS)z Initializes the field name and parent for the field instance. Called when a field is added to the parent serializer instance. zIt is redundant to specify `source='%s'` on field '%s' in serializer '%s', because it is the same as the field name. Remove the `source` keyword argument.NrN *.) rrrr-rrrlreplace capitalize source_attrssplit)rmrrr1r1r2bindms    z Field.bindcCst|ds|j|_|jS)N _validators)rget_validatorsr)rmr1r1r2rs  zField.validatorscCs ||_dS)N)r)rmrr1r1r2rscCs t|jS)N)radefault_validators)rmr1r1r2rszField.get_validatorscCst|jr|jS|jS)z Return a value to use when the field is being returned as a primitive value, without any object instance. )rr)rmr1r1r2 get_initials zField.get_initialcCstj|r|j|kr,t|jddr&tS|jS||j}|dkrX|jrXt|ddrTdSdS|dkr||j r|t|ddrxdStS|S|j |jtS)z Given the *incoming* primitive data, return the value for this field that should be validated and transformed to a native value. r?Fr allow_blankN) r( is_html_inputrrProotr,rrrget)rmr\rer1r1r2 get_values   zField.get_valuecCsy t||jSttfk r}z`|jtk r4|jS|jr>dS|jsJt dj t |j |j |jjj |jj |d}t ||WYdd}~XnXdS)z~ Given the *outgoing* object instance, return the primitive value that should be used for this field. NzGot {exc_type} when attempting to get a value for field `{field}` on serializer `{serializer}`. The serializer field might be named incorrectly and not match any attribute or key on the `{instance}` instance. Original exception text was: {exc}.)exc_typefield serializerrUrX)rYrrRrQr6r, get_defaultrrrrTtyper-rrr)rmrUrXmsgr1r1r2rYs   zField.get_attributecCsN|jtkst|jddrtt|jrHt|jdr@|jj||jS|jS)a2 Return the default value to use when validating data if no input is provided for this field. If a default has not been set for this field then this will simply raise `SkipField`, indicating that no value should be set in the validated data for this field. r?Fr)r6r,rPrrrrr)rmr1r1r2rs    zField.get_defaultcCsn|jrd|jfS|tkrJt|jddr.t|jr>|jdd|jfS|dkrf|jsb|jddSd|fS)a Validate empty values, and either: * Raise `ValidationError`, indicating invalid data. * Raise `SkipField`, indicating that the field should be ignored. * Return (True, data), indicating an empty value that should be returned without any further validation being applied. * Return (False, data), indicating a non-empty value, that should have validation applied as normal. Tr?FrNr)TN) rrr,rPrrrfailr)rmdatar1r1r2validate_empty_valuess     zField.validate_empty_valuescCs.|j|\}}|r|S|j|}|j||S)a Validate a simple representation and return the internal value. The provided data may be `empty` if no representation was included in the input. May raise `SkipField` if the field should not be included in the validated data. )rto_internal_valuerun_validators)rmrZis_empty_valuer^r1r1r2run_validation s   zField.run_validationcCsg}x|jD]}t|dr$|j|y ||Wq tk rl}z t|jtrP|j|jWYdd}~Xq tk r}z|jt |WYdd}~Xq Xq W|rt|dS)z Test the given value against all the validators on the field, and either raise a `ValidationError` or simply return. rN) rrrrr=detailrhextendDjangoValidationErrorr)rmr^r validatorrXr1r1r2rs     $zField.run_validatorscCstdj|jjddS)zN Transform the *incoming* primitive data into a native value. z.{cls}.to_internal_value() must be implemented.)rN)NotImplementedErrorrTrr-)rmrr1r1r2r3szField.to_internal_valuecCstdj|jj|jddS)zL Transform the *outgoing* native value into primitive data. z{cls}.to_representation() must be implemented for field {field_name}. If you do not need to support write operations you probably want to subclass `ReadOnlyField` instead.)rrN)rrTrr-r)rmr^r1r1r2to_representation=szField.to_representationc Ks^y|j|}Wn2tk r@|jj}tj||d}t|YnX|jf|}t||ddS)zH A helper method that simply raises a validation error. ) class_namer_)r|N)rrRrr-MISSING_ERROR_MESSAGErTrr)rmr_kwargsrrZmessage_stringr1r1r2rJs z Field.failcCs|}x|jdk r|j}qW|S)zB Returns the top-level serializer for this field. N)r)rmrr1r1r2rWs  z Field.rootcCst|jdiS)zY Returns the context as passed to the root serializer on initialization. _context)rPr)rmr1r1r2rasz Field.contextcs tt|j|}||_||_|S)z When a field is instantiated, we store the arguments that were used, so that we can present a helpful representation of the object. )superr__new___args_kwargs)rrMrrU)rr1r2rhsz Field.__new__cCs0dd|jD}dd|jjD}|j||S)z When cloning fields we instantiate using the arguments it was originally created with, rather than copying the complete state. cSs$g|]}t|tstj|n|qSr1)r= REGEX_TYPEcopydeepcopy)r7itemr1r1r2r{sz&Field.__deepcopy__..cSs(i|] \}}|dkrtj|n||qS)rregex)rr)rr)r7r_r^r1r1r2r~sz&Field.__deepcopy__..)rrrgr)rmmemorMrr1r1r2 __deepcopy__rs  zField.__deepcopy__cCsttj|S)z Fields are represented using their initial calling arguments. This allows us to create descriptive representations for serializer instances that show all the declared fields on the serializer. )r%r+Z field_repr)rmr1r1r2rszField.__repr__) r-r.r/rrNrrr,rrrnrpropertyrsetterrrrrYrrrrrrrrrrrr __classcell__r1r1)rr2r4s: +$       rc@seZdZdediZdZdZdddddd d d d d dddddhZdddddddddddddd d!dhZd"d#d$d%d&hZ d'd(Z d)d*Z d&S)+ BooleanFieldr}zMust be a valid boolean.FtTyYyesYEStrueTrueTRUEonOnON1rHTfFnNnoNOfalseFalseFALSEoffOffOFF0rgrNullNULLrNc Cs\y4||jkrdS||jkrdS||jkr2|jr2dSWntk rHYnX|jd|ddS)NTFr})input) TRUE_VALUES FALSE_VALUES NULL_VALUESr TypeErrorr)rmrr1r1r2rs  zBooleanField.to_internal_valuecCs8||jkrdS||jkrdS||jkr0|jr0dSt|S)NTF)rrrrbool)rmr^r1r1r2rs  zBooleanField.to_representation) r-r.r/rNrrrrrrrrr1r1r1r2rs$  rcseZdZdediZdZdddddd d d d d dddddhZdddddddddddddd d!d"hZd#d$d%d&dhZfd'd(Z d)d*Z d+d,Z Z S)-NullBooleanFieldr}zMust be a valid boolean.NrrrrrrrrrrrrrrHTrrrrrrrrrrrrrrgFrrrrc s.d|kstdd|d<tt|jf|dS)Nrz#`allow_null` is not a valid option.T)rrrrn)rmr)rr1r2rnszNullBooleanField.__init__c CsVy.||jkrdS||jkrdS||jkr,dSWntk rBYnX|jd|ddS)NTFr})r)rrrrr)rmrr1r1r2rs   z"NullBooleanField.to_internal_valuecCs2||jkrdS||jkrdS||jkr*dSt|S)NTF)rrrr)rmr^r1r1r2rs   z"NullBooleanField.to_representation) r-r.r/rNrrrrrrnrrrr1r1)rr2rs$   rcs^eZdZededededdZdZfddZeffd d Zd d Z d dZ Z S) CharFieldzNot a valid string.zThis field may not be blank.z;Ensure this field has no more than {max_length} characters.z7Ensure this field has at least {min_length} characters.)r}blank max_length min_lengthrc s|jdd|_|jdd|_|jdd|_|jdd|_tt|jf||jdk rt|j dj t j |jd}|j jt|j|d|jdk rt|j dj t j |jd }|j jt|j|dtdk r|j jtdS) NrFtrim_whitespaceTr r )r )r~)r )poprr r r rr rnrrrTr text_typerappendrr!r#)rmrr~)rr1r2rns&    zCharField.__init__csD|dks |jr4tj|jdkr4|js0|jddStt|j|S)Nrr ) r r rstriprrrr r)rmr)rr1r2rs   zCharField.run_validationcCsJt|ts$t|tjtjtf r.|jdtj|}|jrF|j S|S)Nr}) r=rr string_types integer_typesfloatrrr r)rmrr^r1r1r2rs$  zCharField.to_internal_valuecCs tj|S)N)r r)rmr^r1r1r2r$szCharField.to_representation) r-r.r/rNrrrnr,rrrrr1r1)rr2r s    r cs(eZdZdediZfddZZS) EmailFieldr}zEnter a valid email address.c s2tt|jf|t|jdd}|jj|dS)Nr})r~)rrrnrrrr)rmrr)rr1r2rn-szEmailField.__init__)r-r.r/rNrrnrr1r1)rr2r(s rcs(eZdZdediZfddZZS) RegexFieldr}z/This value does not match the required pattern.c s4tt|jf|t||jdd}|jj|dS)Nr})r~)rrrnrrrr)rmrrr)rr1r2rn8szRegexField.__init__)r-r.r/rNrrnrr1r1)rr2r3s rcs0eZdZededdZdfdd ZZS) SlugFieldzLEnter a valid "slug" consisting of letters, numbers, underscores or hyphens.zUEnter a valid "slug" consisting of Unicode letters, numbers, underscores, or hyphens.)r}invalid_unicodeFc sdtt|jf|||_|jrs rcs(eZdZdediZfddZZS)URLFieldr}zEnter a valid URL.c s2tt|jf|t|jdd}|jj|dS)Nr})r~)rrrnr rrr)rmrr)rr1r2rnSszURLField.__init__)r-r.r/rNrrnrr1r1)rr2rNs rcs<eZdZd ZdediZfddZd d Zd d ZZ S) UUIDField hex_verbosehexinturnr}zMust be a valid UUID.c sF|jdd|_|j|jkr0tdjdj|jtt|jf|dS)NrTrztj|dS|jd|dWn"tk rp|jd|dYnX|S)N)r!)r r})r^)r=uuidUUIDr rrrrS)rmrr1r1r2ris     zUUIDField.to_internal_valuecCs"|jdkrt|St||jSdS)Nr)r#strrP)rmr^r1r1r2rvs zUUIDField.to_representation)rr r!r") r-r.r/r$rNrrnrrrr1r1)rr2rYs    rcs:eZdZdZdediZd fdd ZfddZZS) IPAddressFieldz5Support both IPAddressField and GenericIPAddressFieldr}z#Enter a valid IPv4 or IPv6 address.bothc sH|j|_|jdk|_tt|jf|t||j\}}|jj|dS)Nr*) lowerprotocol unpack_ipv4rr)rnr rr)rmr,rr error_message)rr1r2rns   zIPAddressField.__init__c spt|tjs|jd|dd|kr`y|jdkr:t||jSWn"tk r^|jd|dYnXtt |j |S)Nr})r^:r*ipv6)r*r0) r=r rrr,rr-rrr)r)rmr)rr1r2rs  z IPAddressField.to_internal_value)r*) r-r.r/r0rNrrnrrr1r1)rr2r)}s r)csXeZdZededededdZdZejdZfdd Z d d Z d d Z Z S) IntegerFieldzA valid integer is required.z7Ensure this value is less than or equal to {max_value}.z:Ensure this value is greater than or equal to {min_value}.zString value too large.)r} max_value min_valuemax_string_lengthiz\.0*\s*$c s|jdd|_|jdd|_tt|jf||jdk rjt|jdjt j |jd}|j j t |j|d|jdk rt|jdjt j |jd}|j j t|j|ddS)Nr2r3)r2)r~)r3)rr2r3rr1rnrrrTr rrrr r")rmrr~)rr1r2rns    zIntegerField.__init__c Csft|tjr$t||jkr$|jdyt|jjdt |}Wn"t t fk r`|jdYnX|S)Nr4rr}) r=r rrJMAX_STRING_LENGTHrr! re_decimalsubr(rSr)rmrr1r1r2rs zIntegerField.to_internal_valuecCst|S)N)r!)rmr^r1r1r2rszIntegerField.to_representation) r-r.r/rNrr5rrr6rnrrrr1r1)rr2r1s    r1csNeZdZededededdZdZfddZd d Zd d ZZ S) FloatFieldzA valid number is required.z7Ensure this value is less than or equal to {max_value}.z:Ensure this value is greater than or equal to {min_value}.zString value too large.)r}r2r3r4ic s|jdd|_|jdd|_tt|jf||jdk rjt|jdjt j |jd}|j j t |j|d|jdk rt|jdjt j |jd}|j j t|j|ddS)Nr2r3)r2)r~)r3)rr2r3rr8rnrrrTr rrrr r")rmrr~)rr1r2rns    zFloatField.__init__c CsTt|tjr$t||jkr$|jdyt|Sttfk rN|jdYnXdS)Nr4r}) r=r rrJr5rrrrS)rmrr1r1r2rs  zFloatField.to_internal_valuecCst|S)N)r)rmr^r1r1r2rszFloatField.to_representation) r-r.r/rNrr5rnrrrr1r1)rr2r8s   r8csreZdZedededededededdZd Zdfd d ZddZddZddZ ddZ Z S) DecimalFieldzA valid number is required.z7Ensure this value is less than or equal to {max_value}.z:Ensure this value is greater than or equal to {min_value}.z@Ensure that there are no more than {max_digits} digits in total.zGEnsure that there are no more than {max_decimal_places} decimal places.zVEnsure that there are no more than {max_whole_digits} digits before the decimal point.zString value too large.)r}r2r3 max_digitsmax_decimal_placesmax_whole_digitsr4iNFc  s0||_||_||_|dk r ||_|jr,d|_||_||_|jdk r\|jdk r\|j|j|_nd|_tt|j f||jdk rt |j dj t j|jd} |jjt|j| d|jdk rt |j dj t j|jd} |jjt|j| d|dk r&ddttjD} || ks&td || f||_dS) NTr2)r2)r~r3)r3cSsg|]\}}|jdr|qS)ZROUND_) startswith)r7rvr1r1r2rsz)DecimalField.__init__..z=Invalid rounding option %s. Valid values for rounding are: %s)r:decimal_placeslocalizecoerce_to_stringr2r3r<rr9rnrrrTr rrrr r"varsdecimalrgrrounding) rmr:r?rAr2r3r@rDrr~Zvalid_roundings)rr1r2rns<      zDecimalField.__init__c Cst|j}|jrt|}t||jkr2|jdytj|}Wn tj k r`|jdYnX||krt|jd|tjdtjdfkr|jd|j |j |S)zd Validate that the input is a decimal number and return a Decimal instance. r4r}ZInfz-Inf) rrr@rrJr5rrCDecimalDecimalExceptionquantizevalidate_precision)rmrr^r1r1r2rs    zDecimalField.to_internal_valuecCs|j\}}}|dkr,t||}|}d}n>t|t|krZt|}|t|}t|}nt|}d}|}|jdk r||jkr|jd|jd|jdk r||jkr|jd|jd|jdk r||jkr|jd|jd|S) a Ensure that there are no more than max_digits in the number, and no more than decimal_places digits after the decimal point. Override this method to disable the precision validation for input values or to enhance it in any way you need to. rNr:)r:r;)r;r<)r<)as_tuplerJabsr:rr?r<)rmr^signZ digittupleexponentZ total_digitsZ whole_digitsr?r1r1r2rH=s&   zDecimalField.validate_precisioncCsXt|dtj}t|tjs.tjtj|j}|j |}|s@|S|j rNt |Sdj |S)NrAz{0:f}) rPr'ZCOERCE_DECIMAL_TO_STRINGr=rCrEr rrrGr@rrT)rmr^rAZ quantizedr1r1r2r`s  zDecimalField.to_representationcCsJ|jdkr|Stjj}|jdk r,|j|_|jtjd|j|j|dS)zI Quantize the decimal value to the configured precision. Nz.1)rDr) r?rC getcontextrr:precrGrErD)rmr^rr1r1r2rGos   zDecimalField.quantize)NNNFN) r-r.r/rNrr5rnrrHrrGrr1r1)rr2r9s &#r9csjeZdZededededdZejjZeddffdd Z d d Z d d Z d dZ ddZ ZS) DateTimeFieldzFDatetime has wrong format. Use one of these formats instead: {format}.z#Expected a datetime but got a date.z/Invalid datetime for the timezone "{timezone}".zDatetime value out of range.)r}date make_awareoverflowNcs@|tk r||_|dk r||_|dk r*||_tt|j||dS)N)r,rT input_formatsrrrOrn)rmrTrSdefault_timezonerMr)rr1r2rnszDateTimeField.__init__cCst|d|j}|dk r~tj|rLy |j|Stk rJ|jdYnXy tj||Stk rz|jd|dYqXn|dkrtj|rtj |t S|S)z When `self.default_timezone` is `None`, always return naive datetimes. When `self.default_timezone` is not `None`, always return aware datetimes. rNrRrQ)r) rPrTrZis_aware astimezone OverflowErrorrrQrZ make_naiver)rmr^Zfield_timezoner1r1r2enforce_timezones    zDateTimeField.enforce_timezonecCstjrtjSdS)N)rZUSE_TZrZget_current_timezone)rmr1r1r2rTszDateTimeField.default_timezonec Cst|dtj}t|tjr2t|tj r2|jdt|tjrH|j|Sx|D]z}|jt kryt |}|dk rz|j|SWqt t fk rYqXqNy|j ||}|j|St t fk rYqNXqNWtj|}|jd|ddS)NrSrPr})rT)rPr'ZDATETIME_INPUT_FORMATSr=datetimerPrrWr+rrrSrdatetime_parserr)Zdatetime_formats)rmr^rS input_formatparsedhumanized_formatr1r1r2rs(         zDateTimeField.to_internal_valuecCst|sdSt|dtj}|dks*t|tjr.|S|j|}|jtkrj|j }|j drf|ddd}|S|j |S)NrTz+00:00Zi) rPr'ZDATETIME_FORMATr=r rrWr+r isoformatendswithstrftime)rmr^ output_formatr1r1r2rs   zDateTimeField.to_representation)r-r.r/rNrrXstrptimerYr,rnrWrTrrrr1r1)rr2rOs  rOcsLeZdZededdZejjZedffdd Z ddZ d d Z Z S) DateFieldzBDate has wrong format. Use one of these formats instead: {format}.z#Expected a date but got a datetime.)r}rXNcs2|tk r||_|dk r||_tt|j||dS)N)r,rTrSrrdrn)rmrTrSrMr)rr1r2rns zDateField.__init__c Cst|dtj}t|tjr$|jdt|tjr4|Sx~|D]v}|jtkr~y t |}Wnt t fk rnYqX|dk r|Sq:y|j ||}Wnt t fk rYq:X|jSq:Wt j|}|jd|ddS)NrSrXr})rT)rPr'ZDATE_INPUT_FORMATSr=rXrrPr+rrrSrrYr)Z date_formats)rmr^rSrZr[r\r1r1r2rs(        zDateField.to_internal_valuecCsb|sdSt|dtj}|dks*t|tjr.|St|tj sDtd|jt krX|j S|j |S)NrTzExpected a `date`, but got a `datetime`. Refusing to coerce, as this may mean losing timezone information. Use a custom read-only field and deal with timezone issues explicitly.) rPr'Z DATE_FORMATr=r rrXrr+rr_ra)rmr^rbr1r1r2rs zDateField.to_representation) r-r.r/rNrrXrcrYr,rnrrrr1r1)rr2rds  rdcsFeZdZdediZejjZedffdd Z ddZ dd Z Z S) TimeFieldr}zBTime has wrong format. Use one of these formats instead: {format}.Ncs2|tk r||_|dk r||_tt|j||dS)N)r,rTrSrrern)rmrTrSrMr)rr1r2rn#s zTimeField.__init__c Cst|dtj}t|tjr|Sx~|D]v}|jtkrhy t|}Wnt t fk rXYqX|dk r|Sq$y|j ||}Wnt t fk rYq$X|jSq$Wt j |}|jd|ddS)NrSr})rT)rPr'ZTIME_INPUT_FORMATSr=rXtimer+rrrSrrYr)Z time_formatsr)rmr^rSrZr[r\r1r1r2r*s$      zTimeField.to_internal_valuecCsf|dkr dSt|dtj}|dks.t|tjr2|St|tj sHtd|jt kr\|j S|j |S)NrrTzExpected a `time`, but got a `datetime`. Refusing to coerce, as this may mean losing timezone information. Use a custom read-only field and deal with timezone issues explicitly.)Nr) rPr'Z TIME_FORMATr=r rrXrr+rr_ra)rmr^rbr1r1r2rDs zTimeField.to_representation) r-r.r/rNrrXrcrYr,rnrrrr1r1)rr2res  recsDeZdZedededdZfddZddZd d ZZS) DurationFieldzFDuration has wrong format. Use one of these formats instead: {format}.z7Ensure this value is less than or equal to {max_value}.z:Ensure this value is greater than or equal to {min_value}.)r}r2r3c s|jdd|_|jdd|_tt|jf||jdk rjt|jdjt j |jd}|j j t |j|d|jdk rt|jdjt j |jd}|j j t|j|ddS)Nr2r3)r2)r~)r3)rr2r3rrgrnrrrTr rrrr r")rmrr~)rr1r2rnbs    zDurationField.__init__cCs<t|tjr|Sttj|}|dk r*|S|jddddS)Nr}z[DD] [HH:[MM:]]ss[.uuuuuu])rT)r=rX timedeltarr rr)rmr^r[r1r1r2rss  zDurationField.to_internal_valuecCst|S)N)r)rmr^r1r1r2r{szDurationField.to_representation) r-r.r/rNrrnrrrr1r1)rr2rg[s   rgcsfeZdZdediZdZedZfddZddZd d Z d d Z d dZ ddZ e e e ZZS) ChoiceFieldinvalid_choicez "{input}" is not a valid choice.NzMore than {count} items...c sJ||_|jd|j|_|jd|j|_|jdd|_tt|jf|dS)N html_cutoffhtml_cutoff_textrF)rdrrkrlrrrirn)rmrdr)rr1r2rns zChoiceField.__init__c CsJ|dkr|jrdSy|jtj|Stk rD|jd|dYnXdS)Nrrj)r)rchoice_strings_to_valuesr rrRr)rmrr1r1r2rs zChoiceField.to_internal_valuecCs |dkr |S|jjtj||S)Nr)rN)rmrr r)rmr^r1r1r2rszChoiceField.to_representationcCst|j|j|jdS)zP Helper method for use with templates rendering select widgets. )ryrz)r{rxrkrl)rmr1r1r2r{szChoiceField.iter_optionscCs|jS)N)_choices)rmr1r1r2 _get_choicesszChoiceField._get_choicescCs,t||_t|j|_dd|jD|_dS)NcSsi|]}|tj|qSr1)r r)r7r_r1r1r2rsz,ChoiceField._set_choices..)rcrxrkrnrdrm)rmrdr1r1r2 _set_choicess  zChoiceField._set_choices)r-r.r/rNrrkrlrnrrr{rorprrdrr1r1)rr2ris     ricsTeZdZedededdZgZfddZddZfd d Zd d Z Z S) MultipleChoiceFieldz "{input}" is not a valid choice.z5Expected a list of items but got type "{input_type}".z This selection may not be empty.)rj not_a_listr,cs$|jdd|_tt|j||dS)N allow_emptyT)rrsrrqrn)rmrMr)rr1r2rnszMultipleChoiceField.__init__cCs@|j|krt|jddrtStj|r2|j|jS|j|jtS)Nr?F)rrPrr,r(rgetlistr)rmr\r1r1r2rs    zMultipleChoiceField.get_valuecs^t|tjst|d r,jdt|jdj rJt|dkrJjdfdd|DS)N__iter__rr) input_typerr,csh|]}ttj|qSr1)rrqr)r7r)rrmr1r2 sz8MultipleChoiceField.to_internal_value..) r=r rrrrr-rsrJ)rmr)r)rmr2rs   z%MultipleChoiceField.to_internal_valuecsfdd|DS)Ncs h|]}jjtj||qSr1)rmrr r)r7r)rmr1r2rwsz8MultipleChoiceField.to_representation..r1)rmr^r1)rmr2rs z%MultipleChoiceField.to_representation) r-r.r/rNrrrnrrrrr1r1)rr2rqs   rqcs*eZdZdediZdfdd ZZS) r rjz%"{input}" is not a valid path choice.NFTc  s4t||||||d}|j|d<tt|jf|dS)N)match recursive allow_files allow_foldersrrd)DjangoFilePathFieldrdrr rn) rmpathrxryrzr{rrr)rr1r2rns   zFilePathField.__init__)NFTFN)r-r.r/rNrrnrr1r1)rr2r s r csPeZdZedededededdZfddZd d Zd d ZZS) FileFieldzNo file was submitted.zGThe submitted data was not a file. Check the encoding type on the form.z No filename could be determined.zThe submitted file is empty.zKEnsure this filename has at most {max_length} characters (it has {length}).)rr}no_namer,r csF|jdd|_|jdd|_d|kr0|jd|_tt|j||dS)Nr allow_empty_fileFuse_url)rr rrrr~rn)rmrMr)rr1r2rns  zFileField.__init__c Csy|j}|j}Wntk r.|jdYnX|s>|jd|j rV| rV|jd|jrt||jkr|jd|jt|d|S)Nr}rr,r )r length)namesizerQrrr rJ)rmr file_name file_sizer1r1r2rs   zFileField.to_internal_valuecCsZ|sdSt|dtj}|rTt|dds*dS|j}|jjdd}|dk rP|j|S|S|jS)Nrurlr)rPr'ZUPLOADED_FILES_USE_URLrrrZbuild_absolute_urir)rmr^rrrr1r1r2rs  zFileField.to_representation) r-r.r/rNrrnrrrr1r1)rr2r~s  r~cs4eZdZdediZfddZfddZZS)r Z invalid_imagezYUpload a valid image. The file you uploaded was either not an image or a corrupted image.cs$|jdt|_tt|j||dS)N_DjangoImageField)rDjangoImageFieldrrr rn)rmrMr)rr1r2rn.szImageField.__init__cs*tt|j|}|j}|j|_|j|S)N)rr rrrclean)rmrZ file_objectZ django_field)rr1r2r2szImageField.to_internal_value)r-r.r/rNrrnrrr1r1)rr2r 's r cs,eZdZfddZddZddZZS)_UnvalidatedFieldcs"tt|j||d|_d|_dS)NT)rrrnrr)rmrMr)rr1r2rn?sz_UnvalidatedField.__init__cCs|S)Nr1)rmrr1r1r2rDsz#_UnvalidatedField.to_internal_valuecCs|S)Nr1)rmr^r1r1r2rGsz#_UnvalidatedField.to_representation)r-r.r/rnrrrr1r1)rr2r>s rcsdeZdZeZgZededededdZfddZdd Z d d Z d d Z ddZ Z S) ListFieldz5Expected a list of items but got type "{input_type}".zThis list may not be empty.z5Ensure this field has at least {min_length} elements.z9Ensure this field has no more than {max_length} elements.)rrr,r r cs|jdtj|j|_|jdd|_|jdd|_|jdd|_tj|j sVt d|jj dksjt dt t |j |||jjd|d |jdk r|jdj|jd }|jjt|j|d |jdk r|jdj|jd }|jjt|j|d dS) NchildrsTr r z"`child` has not been instantiated.zvThe `source` argument is not meaningful when applied to a `child=` field. Remove `source=` from the field declaration.r)rr)r )r~)r )rrrrrsr r r:isclassrrrrrnrrrTrrrr!)rmrMrr~)rr1r2rnUs  zListField.__init__cCsd|j|krt|jddrtStj|rV|j|jg}t|dkrD|Stj||jtdS|j |jtS)Nr?Fr)prefixr6) rrPrr,r(rrtrJparse_html_listr)rmr\valr1r1r2rjs   zListField.get_valuecCsptj|rtj|gd}t|tjtfs4t|d rH|jdt |j d|j rft |dkrf|jd|j |S)zY List of dicts of native values <- List of dicts of primitive datatypes. )r6rurr)rvrr,)r(rrr=r rrrrrr-rsrJrun_child_validation)rmrr1r1r2rys  zListField.to_internal_valuecsfdd|DS)zS List of object instances -> List of dicts of primitive datatypes. cs$g|]}|dk rjj|ndqS)N)rr)r7r)rmr1r2rsz/ListField.to_representation..r1)rmrr1)rmr2rszListField.to_representationcCsxg}t}xXt|D]L\}}y|j|jj|Wqtk r^}z|j||<WYdd}~XqXqW|sl|St|dS)N)r enumeraterrrrr)rmrresultridxrer1r1r2rs zListField.run_child_validation)r-r.r/rrrrNrrnrrrrrr1r1)rr2rKs   rcsReZdZeZiZdediZfddZddZ ddZ d d Z d d Z Z S) DictField not_a_dictz;Expected a dictionary of items but got type "{input_type}".csf|jdtj|j|_tj|j s,td|jjdks@tdtt |j |||jj d|ddS)Nrz"`child` has not been instantiated.zvThe `source` argument is not meaningful when applied to a `child=` field. Remove `source=` from the field declaration.r)rr) rrrrr:rrrrrrnr)rmrMr)rr1r2rns zDictField.__init__cCs(tj|rtj||jdS|j|jtS)N)r)r(rparse_html_dictrrr,)rmr\r1r1r2rs zDictField.get_valuecCs<tj|rtj|}t|ts2|jdt|jd|j|S)zI Dicts of native values <- Dicts of primitive datatypes. r)rv) r(rrr=rhrrr-r)rmrr1r1r2rs    zDictField.to_internal_valuecsfdd|jDS)Ncs0i|](\}}|dk r jj|ndtj|qS)N)rrr r)r7r_r)rmr1r2rsz/DictField.to_representation..)rg)rmr^r1)rmr2rs zDictField.to_representationcCsi}t}x`|jD]T\}}tj|}y|jj|||<Wqtk rf}z|j||<WYdd}~XqXqW|st|St|dS)N)rrgr rrrrr)rmrrrr_r^rr1r1r2rs  zDictField.run_child_validation)r-r.r/rrrrNrrnrrrrrr1r1)rr2rs   rcs(eZdZedddZfddZZS) HStoreFieldT)rrcs*tt|j||t|jts&tddS)NzjThe `child` argument must be an instance of `CharField`, as the hstore extension stores values as strings.)rrrnr=rr r)rmrMr)rr1r2rnszHStoreField.__init__)r-r.r/r rrnrr1r1)rr2rs rcs@eZdZdediZfddZddZddZd d ZZ S) JSONFieldr}zValue must be valid JSON.cs$|jdd|_tt|j||dS)NbinaryF)rrrrrn)rmrMr)rr1r2rnszJSONField.__init__cCsBtj|r4|j|kr4Gdddtj}|||jS|j|jtS)Nc@seZdZddZdS)z'JSONField.get_value..JSONStringcSstjj||}d|_|S)NT)r rris_json_string)rmr^rer1r1r2rsz/JSONField.get_value..JSONString.__new__N)r-r.r/rr1r1r1r2 JSONStringsr)r(rrr rrr,)rmr\rr1r1r2rszJSONField.get_valuec Csfy>|jst|ddr2t|tr(|jd}tj|Stj|Wn"tt fk r`|j dYnX|S)NrFzutf-8r}) rrPr=bytesdecoder*loadsdumpsrrSr)rmrr1r1r2rs   zJSONField.to_internal_valuecCs.|jr*tj|}t|tjr*t|jd}|S)Nzutf-8)rr*rr=r rrencode)rmr^r1r1r2rs   zJSONField.to_representation) r-r.r/rNrrnrrrrr1r1)rr2rs     rcs(eZdZdZfddZddZZS) ReadOnlyFieldaw A read-only field that simply returns the field value. If the field is a method with no parameters, the method will be called and its return value used as the representation. For example, the following would call `get_expiry_date()` on the object: class ExampleSerializer(Serializer): expiry_date = ReadOnlyField(source='get_expiry_date') c sd|d<tt|jf|dS)NTr)rrrn)rmr)rr1r2rnszReadOnlyField.__init__cCs|S)Nr1)rmr^r1r1r2rszReadOnlyField.to_representation)r-r.r/r0rnrrr1r1)rr2r s  rcs0eZdZdZfddZddZddZZS) HiddenFieldaL A hidden field does not take input from the user, or present any output, but it does populate a field in `validated_data`, based on its default value. This is particularly useful when we have a `unique_for_date` constraint on a pair of fields, as we need some way to include the date in the validated data. c s.d|kstdd|d<tt|jf|dS)Nr6zdefault is a required argument.Tr)rrrrn)rmr)rr1r2rn*szHiddenField.__init__cCstS)N)r,)rmr\r1r1r2r/szHiddenField.get_valuecCs|S)Nr1)rmrr1r1r2r4szHiddenField.to_internal_value)r-r.r/r0rnrrrr1r1)rr2r"s rcs6eZdZdZd fdd ZfddZddZZS) SerializerMethodFielda A read-only field that get its representation from calling a method on the parent serializer class. The method called will be of the form "get_{field_name}", and should take a single argument, which is the object being serialized. For example: class ExampleSerializer(self): extra_info = SerializerMethodField() def get_extra_info(self, obj): return ... # Calculate some data to return. Nc s,||_d|d<d|d<tt|jf|dS)NrrTr) method_namerrrn)rmrr)rr1r2rnGszSerializerMethodField.__init__csTdj|d}|j|ks.td|j||jjf|jdkr>||_tt|j||dS)Nzget_{field_name})rzIt is redundant to specify `%s` on SerializerMethodField '%s' in serializer '%s', because it is the same as the default method name. Remove the `method_name` argument.)rTrrrr-rrr)rmrrZdefault_method_name)rr1r2rMs   zSerializerMethodField.bindcCst|j|j}||S)N)rPrr)rmr^rLr1r1r2r_sz'SerializerMethodField.to_representation)N)r-r.r/r0rnrrrr1r1)rr2r8s rcsDeZdZdZdediZfddZddZdd Zd d Z Z S) ModelFieldz A generic field that can be used against an arbitrary model field. This is used by `ModelSerializer` when dealing with custom model fields, that do not have a serializer field to be mapped to. r z;Ensure this field has no more than {max_length} characters.c sb||_|jdd}tt|jf||dk r^t|jdjtj |j d}|j j t |j |ddS)Nr )r )r~) model_fieldrrrrnrrrTr rr rrr)rmrrr r~)rr1r2rnos  zModelField.__init__cCs2|jj}|dk r&|jjj|jj|S|jj|S)N)rZ remote_fieldmodelZ_meta get_fieldrZ to_python)rmrrelr1r1r2r|szModelField.to_internal_valuecCs|S)Nr1)rmrDr1r1r2rYszModelField.get_attributecCs$|jj|}t|r|S|jj|S)N)rZvalue_from_objectrZvalue_to_string)rmrDr^r1r1r2rs zModelField.to_representation) r-r.r/r0rNrrnrrYrrr1r1)rr2rds   r)NN)} __future__rrrXrCr>r:rr& collectionsrZ django.confrZdjango.core.exceptionsrrrZdjango.core.validatorsrrr r Z django.formsr r|r rZ django.utilsr rZdjango.utils.dateparserrrrZdjango.utils.durationrZdjango.utils.encodingrrZdjango.utils.formatsrrZdjango.utils.functionalrZdjango.utils.ipv6rZdjango.utils.timezonerZdjango.utils.translationrrNZpytz.exceptionsrZrest_frameworkrZrest_framework.compatrrr r!r"r#r$r%Zrest_framework.exceptionsr&Zrest_framework.settingsr'Zrest_framework.utilsr(r)r*r+r,PY3rGrYr`rcrkr{rrwrr Exceptionrrrrrrrrrrrrr rrrrrr)r1r8r9rOrdrergrirqr~rrrrrrrrrr1r1r1r2s              (    / ].47   $)(XC>&9'3 O; -,