U ƽbV@s8ddlZddlZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z ddl m Z ddlmZddlmZddlmZmZmZmZmZmZmZmZmZddlmZdd lmZ dd l!m"Z"dd l#m$Z$m%Z%m&Z&m'Z'dd l(m)Z)dd l*m+Z+m,Z,ddl-m.Z.m/Z/ddl0m1Z1ddl2m3Z3ddl4m5Z6ddl7m8Z8ddl9m:Z:m;Z;mZ>mZddl?m@Z@ddlAmBZBmCZCmDZDmEZEddlFmGZGddlHmIZIGdddZJGdddeKZLddZMdd ZNd!d"ZOd#d$ZPd%d&ZQdud'd(ZRd)d*ZSGd+d,d,ZTGd-d.d.ZUGd/d0d0eKZVeWeXd1ZYd2ZZd3Z[d4Z\d5Z]d6Z^Gd7d8d8Z_Gd9d:d:e_Z`Gd;d<dd>e_ZbGd?d@d@ebZcGdAdBdBebZdGdCdDdDebZeGdEdFdFebZfGdGdHdHe_ZgGdIdJdJebZhGdKdLdLe_ZiGdMdNdNe_ZjGdOdPdPe_ZkGdQdRdRe_ZlGdSdTdTe_ZmGdUdVdVe_ZnGdWdXdXe_ZoGdYdZdZe_ZpGd[d\d\epZqGd]d^d^epZGd_d`d`e_ZrGdadbdberZGdcdddde_ZsGdedfdfe_ZtGdgdhdhe_ZuGdidjdjeuZvGdkdldle_ZwGdmdndne_ZxGdodpdpe_ZyGdqdrdre_ZzGdsdtdte_Z{dS)vN) OrderedDict)Mapping)settings)ObjectDoesNotExist)ValidationError) EmailValidatorMaxLengthValidatorMaxValueValidatorMinLengthValidatorMinValueValidatorProhibitNullCharactersValidatorRegexValidator URLValidatorip_address_validators) FilePathField) ImageFieldtimezone) parse_dateparse_datetimeparse_duration parse_timeduration_string)is_protected_type smart_str)localize_inputsanitize_separators)clean_ipv6_address)utc) gettext_lazy)InvalidTimeError)ISO_8601RemovedInDRF313WarningRemovedInDRF314Warning) ErrorDetailr) api_settings)htmlhumanize_datetimejsonrepresentation) lazy_format)$ProhibitSurrogateCharactersValidatorc@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__r3r39/tmp/pip-unpacked-wheel-iohwuy7z/rest_framework/fields.pyr-,sr-c@seZdZdZdS)BuiltinSignatureErrorz Built-in function signatures are not inspectable. This exception is raised so the serializer can raise a helpful error message. Nr.r3r3r3r4r56sr5cCs\t|rtdt|s6t|s6t|tjs6dSt|}|j }t dd|DS)zC True if the object is a callable that takes no arguments. zkBuilt-in function signatures are not inspectable. Wrap the function call in a simple, pure Python function.Fcss2|]*}|j|jkp(|j|jkp(|j|jkVqdSN)kindVAR_POSITIONAL VAR_KEYWORDdefaultr-).0paramr3r3r4 Ms   z%is_simple_callable..) inspect isbuiltinr5 isfunctionismethod isinstance functoolspartial signature parametersvaluesall)objsigparamsr3r3r4is_simple_callable>s    rLc Cs|D]}z"t|tr||}n t||}Wntk rBYdSXt|rz |}Wqttfk r}ztd||W5d}~XYqXq|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. NzGException raised in callable attribute "{}"; original exception was: {}) rBrgetattrrrLAttributeErrorKeyError ValueErrorformat)instanceattrsattrexcr3r3r4 get_attributeUs    $rVcCsL|s||dS|ddD]}||kr2i||<||}q|||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}} N)update) dictionarykeysvaluekeyr3r3r4 set_valueps   r]cCsXt}|D]H}t|ttfs&|||<q |\}}t|ttfrJt|||<q |||<q |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'}} )rrBlisttupleto_choices_dict)choicesretchoicer\r[r3r3r4r`s   r`cCsJt}|D]6\}}t|tr<|D]\}}|||<q(q|||<q|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'} )ritemsrBdict)rarbr\r[sub_key sub_valuer3r3r4flatten_choices_dicts   rhc csGddd}Gddd}Gddd}d}|D]\}}|rN||krNqt|tr||dV|D].\} } |r||krq|| | d V|d 7}ql|Vq6|||d V|d 7}q6|r||kr|r|j|d }|d |d dVdS)zE Helper function for options and option groups in templates. c@seZdZdZdZddZdS)z&iter_options..StartOptionGroupTFcSs ||_dSr6label)selfrjr3r3r4__init__sz/iter_options..StartOptionGroup.__init__Nr/r0r1start_option_groupend_option_grouprlr3r3r3r4StartOptionGroupsrpc@seZdZdZdZdS)z$iter_options..EndOptionGroupFTN)r/r0r1rnror3r3r3r4EndOptionGroupsrqc@seZdZdZdZdddZdS)ziter_options..OptionFcSs||_||_||_dSr6r[ display_textdisabled)rkr[rsrtr3r3r4rlsz%iter_options..Option.__init__N)Frmr3r3r3r4Optionsrurri)r[rs)countzn/aTrrN)rdrBrerQ) grouped_choicescutoff cutoff_textrprqrurwr\r[rfrgr3r3r4 iter_optionss(         r{csZt|ddpdz |j}Wn(tk rBfdd|jDYSXfdd|DS)zf Given a Django ValidationError, return a list of ErrorDetail, with the `code` populated. codeNinvalidcs8g|]0}t|jr|j|jn|j|jr,|jndqSr|r%rKmessager|r;errorrr3r4 sz$get_error_detail..cs$i|]\}}|fdd|DqS)cs8g|]0}t|jr|j|jn|j|jr,|jndqSr~rrrr3r4rsz/get_error_detail...r3)r;kerrorsrr3r4 s  z$get_error_detail..)rM error_dictrNZ error_listrd)exc_inforr3rr4get_error_details    rc@s,eZdZdZdZddZddZddZd 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. TcCs ||_dSr6r:)rkr:r3r3r4rlszCreateOnlyDefault.__init__cCsn|jjdk }|rtt|jrht|jdrHtjdtdd|j |t |jddr`||S|S|jS)N set_contextMethod `set_context` on defaults is deprecated and will no longer be called starting with 3.13. Instead set `requires_context = True` on the class, and accept the context as an additional argument. stacklevelrequires_contextF) parentrR SkipFieldcallabler:hasattrwarningswarnr#rrM)rkserializer_fieldZ is_updater3r3r4__call__s     zCreateOnlyDefault.__call__cCsd|jjt|jfS)Nz%s(%s)) __class__r/reprr:rkr3r3r4__repr__szCreateOnlyDefault.__repr__N)r/r0r1r2rrlrrr3r3r3r4rs rc@s eZdZdZddZddZdS)CurrentUserDefaultTcCs |jdjS)Nrequest)contextuser)rkrr3r3r4r!szCurrentUserDefault.__call__cCs d|jjS)Nz%s())rr/rr3r3r4r$szCurrentUserDefault.__repr__N)r/r0r1rrrr3r3r3r4rsrc@s eZdZdS)rN)r/r0r1r3r3r3r4r(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 dddeedddddddd dd Z d d Z e d d Z e jdd Z ddZddZddZddZddZddZefddZddZdd Zd!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.)requirednullNF) read_only write_onlyrr:initialsourcerj help_textstyleerror_messages validators allow_nullc CsFtj|_tjd7_|dkr,|tko*| }|r<|r|dd|fS|dkrv|jsd|dn|j dkrrdSd Sd|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. TrDFrNrr)FNTN) rrr-rMrrrfailrrrkdatar3r3r4validate_empty_values s      zField.validate_empty_valuescCs.||\}}|r|S||}|||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)rkrZis_empty_valuer[r3r3r4run_validation+s   zField.run_validationc Csg}|jD]}t|dr2tjdtdd||z$t|ddrL|||n||Wq tk r}zt|j t rv| |j W5d}~XYq t k r}z| t |W5d}~XYq Xq |rt|dS)z Test the given value against all the validators on the field, and either raise a `ValidationError` or simply return. rzMethod `set_context` on validators is deprecated and will no longer be called starting with 3.13. Instead set `requires_context = True` on the class, and accept the context as an additional argument.rrrFN)rrrrr#rrMrrBdetailreextendDjangoValidationErrorr)rkr[r validatorrUr3r3r4r<s*       "zField.run_validatorscCstdj|jj|jddS)zN Transform the *incoming* primitive data into a native value. z{cls}.to_internal_value() must be implemented for field {field_name}. If you do not need to support write operations you probably want to subclass `ReadOnlyField` instead.rrNNotImplementedErrorrQrr/rrr3r3r4r^s zField.to_internal_valuecCstdj|jj|jddS)zL Transform the *outgoing* native value into primitive data. zE{cls}.to_representation() must be implemented for field {field_name}.rNrrkr[r3r3r4to_representationks zField.to_representationcKs^z|j|}Wn2tk r@|jj}tj||d}t|YnX|jf|}t||ddS)zH A helper method that simply raises a validation error. ) class_namer\rN)rrOrr/MISSING_ERROR_MESSAGErQrr)rkr\kwargsrrZmessage_stringr3r3r4rvs z Field.failcCs|}|jdk r|j}q|S)zB Returns the top-level serializer for this field. N)r)rkrr3r3r4rs z Field.rootcCst|jdiS)zY Returns the context as passed to the root serializer on initialization. _context)rMrrr3r3r4rsz Field.contextcst|}||_||_|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. )super__new___args_kwargs)rargsrrRrr3r4rs z Field.__new__cs4dd|jD}fdd|jD}|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|tst|n|qSr3)rB REGEX_TYPEcopydeepcopyr;itemr3r3r4rsz&Field.__deepcopy__..cs*i|]"\}}||dkr"t|n|qS))rregex)rr)r;r\r[memor3r4rsz&Field.__deepcopy__..)rrrdr)rkrrrr3rr4 __deepcopy__s zField.__deepcopy__cCs t|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*Z field_reprrr3r3r4rszField.__repr__) r/r0r1rrrrr-rrrlrpropertyrsetterrrrrVrrrrrrrrrrrr __classcell__r3r3rr4r8sT .$   )! "      rc@seZdZdediZdZdZdddddd d d d d ddddddhZddddddddddddd d!d"d#dhZd$d%d&d'd(hZ d)d*Z d+d,Z d(S)- BooleanFieldr}zMust be a valid boolean.FtTyYyesZYesZYEStrueTrueTRUEonZOnON1rvTfFnNnoZNoNOfalseFalseFALSEoffZOffZOFF0rgrZNullZNULLrNcCsbz:||jkrWdS||jkr"WdS||jkr8|jr8WdSWntk rNYnX|jd|ddS)NTFr}input) TRUE_VALUES FALSE_VALUES NULL_VALUESr TypeErrorrrr3r3r4rs   zBooleanField.to_internal_valuecCs8||jkrdS||jkrdS||jkr0|jr0dSt|S)NTF)rrrrboolrr3r3r4rs  zBooleanField.to_representation) r/r0r1rrrrrrrrrr3r3r3r4rsV  rcs eZdZdZfddZZS)NullBooleanFieldNc s:tjdtddd|ks tdd|d<tjf|dS)NzThe `NullBooleanField` is deprecated and will be removed starting with 3.14. Instead use the `BooleanField` field and set `allow_null=True` which does the same thing.rrrz#`allow_null` is not a valid option.T)rrr$rrrlrkrrr3r4rlszNullBooleanField.__init__)r/r0r1rrlrr3r3rr4rsrcs^eZdZededededdZdZfddZeffd d Zd d Z d dZ Z S) CharFieldzNot a valid string.zThis field may not be blank.;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|dd|_|dd|_|dd|_|dd|_tjf||jdk rzt|jd|jd}|j t |j|d|jdk rt|jd|jd }|j t |j|d|j t |j tdS) NrFtrim_whitespaceTr r!r rr!)poprr"r r!rrlr+rrappendrr r r,rkrrrr3r4rls"    zCharField.__init__cs>|dks|jr2t|dkr2|js.|ddSt|S)Nrr)r"strstriprrrrrrr3r4rs  zCharField.run_validationcCs>t|tst|tttfs$|dt|}|jr:|S|S)Nr})rBrr)intfloatrr"r*rkrr[r3r3r4r!s zCharField.to_internal_valuecCst|Sr6r)rr3r3r4r*szCharField.to_representation) r/r0r1rrrrlr-rrrrr3r3rr4rs   rcs(eZdZdediZfddZZS) EmailFieldr}zEnter a valid email address.c s.tjf|t|jdd}|j|dSNr}r$)rrlrrrr'rkrrrr3r4rl3szEmailField.__init__r/r0r1rrrlrr3r3rr4r/.sr/cs(eZdZdediZfddZZS) RegexFieldr}z/This value does not match the required pattern.c s0tjf|t||jdd}|j|dSr0)rrlr rrr')rkrrrrr3r4rl>szRegexField.__init__r2r3r3rr4r39sr3cs0eZdZededdZdfdd 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 s`tjf|||_|jr8ttdtj|jdd}nttd|jdd}|j |dS)Nz ^[-\w]+\Zr5r$z^[-a-zA-Z0-9_]+$r}) rrl allow_unicoder recompileUNICODErrr')rkr6rrrr3r4rlJs zSlugField.__init__)Fr2r3r3rr4r4Dsr4cs(eZdZdediZfddZZS)URLFieldr}zEnter a valid URL.c s.tjf|t|jdd}|j|dSr0)rrlrrrr'r1rr3r4rlYszURLField.__init__r2r3r3rr4r:Tsr:cs<eZdZdZdediZfddZddZdd ZZ S) UUIDField) hex_verbosehexr+Zurnr}zMust be a valid UUID.c sB|dd|_|j|jkr0tdd|jtjf|dS)NrQr<z;Invalid format for uuid representation. Must be one of "{}"z", ")r& uuid_format valid_formatsrPrQjoinrrlrrr3r4rlfs  zUUIDField.__init__cCsvt|tjsrzBt|tr&tj|dWSt|tr>tj|dWS|jd|dWn"tk rp|jd|dYnX|S)Nr+)r=r}r[)rBuuidUUIDr+r)rrPrr3r3r4ros   zUUIDField.to_internal_valuecCs"|jdkrt|St||jSdS)Nr<)r>r)rMrr3r3r4r|s zUUIDField.to_representation) r/r0r1r?rrrlrrrr3r3rr4r;_s  r;cs:eZdZdZdediZd fdd ZfddZZS) IPAddressFieldz5Support both IPAddressField and GenericIPAddressFieldr}z#Enter a valid IPv4 or IPv6 address.bothc sD||_|jdk|_tjf|t||j\}}|j|dS)NrF)lowerprotocol unpack_ipv4rrlrrr)rkrHrr error_messagerr3r4rls   zIPAddressField.__init__cslt|ts|jd|dd|kr`z|jdkr:t||jWSWn"tk r^|jd|dYnXt|S)Nr}rB:)rFZipv6) rBr)rrHrrIrrrrrr3r4rs  z IPAddressField.to_internal_value)rF) r/r0r1r2rrrlrrr3r3rr4rEs rEcsXeZdZededededdZdZedZfdd Z d d Z d d Z Z S) IntegerFieldzA valid integer is required.7Ensure this value is less than or equal to {max_value}.:Ensure this value is greater than or equal to {min_value}.String value too large.r} max_value min_valuemax_string_lengthz\.0*\s*$c s|dd|_|dd|_tjf||jdk r^t|jd|jd}|jt |j|d|jdk rt|jd|jd}|jt |j|ddSNrQrRrQr$rR r&rQrRrrlr+rrr'r r r(rr3r4rls    zIntegerField.__init__c Csdt|tr"t||jkr"|dzt|jdt|}Wn"tt fk r^|dYnX|S)NrSrr}) rBr)lenMAX_STRING_LENGTHrr+ re_decimalsubrPrrr3r3r4rs zIntegerField.to_internal_valuecCst|Sr6rArr3r3r4rszIntegerField.to_representation) r/r0r1rrrZr7r8r[rlrrrr3r3rr4rLs   rLcsNeZdZededededdZdZfddZd d Zd d ZZ S) FloatFieldA valid number is required.rMrNrOrPrTc s|dd|_|dd|_tjf||jdk r^t|jd|jd}|jt |j|d|jdk rt|jd|jd}|jt |j|ddSrUrXr(rr3r4rls    zFloatField.__init__c CsTt|tr"t||jkr"|dz t|WSttfk rN|dYnXdS)NrSr})rBr)rYrZrr,rrPrr3r3r4rs   zFloatField.to_internal_valuecCst|Sr6)r,rr3r3r4rszFloatField.to_representation) r/r0r1rrrZrlrrrr3r3rr4r]s  r]cs~eZdZedededededededdZd Zdfd d ZfddZddZddZ ddZ ddZ Z S) DecimalFieldr^rMrNz@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.rO)r}rQrR max_digitsmax_decimal_placesmax_whole_digitsrSrTNFc  s||_||_||_|dk r ||_|jr,d|_||_||_|jdk r\|jdk r\|j|j|_nd|_tjf||jdk rt |j d|jd} |j t |j| d|jdk rt |j d|jd} |j t|j| d|dk rddttD} || kstd || f||_dS) NTrQrVr$rRrWcSsg|]\}}|dr|qS)ZROUND_) startswith)r;rvr3r3r4rs z)DecimalField.__init__..z=Invalid rounding option %s. Valid values for rounding are: %s)r`decimal_placeslocalizecoerce_to_stringrQrRrbrrlr+rrr'r r varsdecimalrdrrounding) rkr`rergrQrRrfrjrrZvalid_roundingsrr3r4rls:       zDecimalField.__init__cs&t|dkr|jrdSt|S)Nrr)rr*rrrrrr3r4rsz"DecimalField.validate_empty_valuescCst|}|jrt|}t||jkr2|dzt|}Wn tj k r`|dYnX| rt|d|tdtdfkr|d| | |S)zd Validate that the input is a decimal number and return a Decimal instance. rSr}ZInfz-Inf) rr*rfrrYrZrriDecimalDecimalExceptionis_nanquantizevalidate_precisionr-r3r3r4rs    zDecimalField.to_internal_valuecCs|\}}}|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`ra)rarb)rb)as_tuplerYabsr`rrerb)rkr[signZ digittupleexponentZ total_digitsZ whole_digitsrer3r3r4ro:s&   zDecimalField.validate_precisioncCsjt|dtj}|dkr"|rdSdSt|tjs@tt|}||}|sR|S|j r`t |Sd |S)Nrgrz{:f}) rMr&ZCOERCE_DECIMAL_TO_STRINGrBrirkr)r*rnrfrrQ)rkr[rgZ quantizedr3r3r4r]s  zDecimalField.to_representationcCsJ|jdkr|St}|jdk r,|j|_|jtd|j|j|dS)zI Quantize the decimal value to the configured precision. Nz.1)rjr) reri getcontextrr`precrnrkrj)rkr[rr3r3r4rnrs   zDecimalField.quantize)NNNFN) r/r0r1rrrZrlrrrorrnrr3r3rr4r_s$ # #r_csjeZdZededededdZejjZeddffdd 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_awareoverflowNc s<|tk r||_|dk r||_|dk r*||_tjf|dSr6)r-rQ input_formatsrrrl)rkrQrzdefault_timezonerrr3r4rlszDateTimeField.__init__cCst|d|}|dk rt|rNz ||WStk rL|dYnXzt||WStk r~|jd|dYqXn|dkrt|rt |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. rNryrxr) rMr{rZis_aware astimezone OverflowErrorrrxr!Z make_naiver)rkr[Zfield_timezoner3r3r4enforce_timezones   zDateTimeField.enforce_timezonecCstjrtSdSr6)rZUSE_TZrZget_current_timezonerr3r3r4r{szDateTimeField.default_timezonec Cst|dtj}t|tjr0t|tjs0|dt|tjrF||S|D]}|t krz$t |}|dk r|||WSWqt t fk rYqXqJz| ||}||WSt t fk rYqJXqJt|}|jd|ddS)Nrzrwr}rQ)rMr&ZDATETIME_INPUT_FORMATSrBdatetimerwrr~rGr"rrPrdatetime_parserr(Zdatetime_formatsrkr[rzZ input_formatparsedZhumanized_formatr3r3r4rs(      zDateTimeField.to_internal_valuecCsr|sdSt|dtj}|dks(t|tr,|S||}|tkrh|}| drd|ddd}|S| |S)NrQz+00:00iZ) rMr&ZDATETIME_FORMATrBr)r~rGr" isoformatendswithstrftimerkr[Z output_formatr3r3r4rs   zDateTimeField.to_representation)r/r0r1rrrstrptimerr-rlr~r{rrrr3r3rr4rvs rvcsLeZdZededdZejjZedffdd 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}rNc s.|tk r||_|dk r||_tjf|dSr6r-rQrzrrlrkrQrzrrr3r4rls zDateField.__init__c Cst|dtj}t|tjr$|dt|tjr4|S|D]~}|tkrz t |}Wnt t fk rlYqX|dk r|Sq8z| ||}Wnt t fk rYq8X|Sq8t |}|jd|ddS)Nrzrr}r)rMr&ZDATE_INPUT_FORMATSrBrrrwrGr"rrPrrr(Z date_formatsrr3r3r4rs(       zDateField.to_internal_valuecCs^|sdSt|dtj}|dks(t|tr,|St|tjr@td|tkrT| S| |S)NrQzExpected 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.) rMr&Z DATE_FORMATrBr)rrrGr"rrrr3r3r4rs zDateField.to_representation r/r0r1rrrrrr-rlrrrr3r3rr4rsrcsFeZdZdediZejjZedffdd Z ddZ dd Z Z S) TimeFieldr}zBTime has wrong format. Use one of these formats instead: {format}.Nc s.|tk r||_|dk r||_tjf|dSr6rrrr3r4rl&s zTimeField.__init__c Cst|dtj}t|tjr|S|D]~}|tkrjz t|}Wnt t fk rVYqX|dk r|Sq"z| ||}Wnt t fk rYq"X|Sq"t |}|jd|ddS)Nrzr}r)rMr&ZTIME_INPUT_FORMATSrBrtimerGr"rrPrrr(Z time_formatsrrr3r3r4r-s$     zTimeField.to_internal_valuecCsb|dkr dSt|dtj}|dks,t|tr0|St|tjrDtd|tkrX| S| |S)N)NrrQzExpected 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.) rMr&Z TIME_FORMATrBr)rrrGr"rrrr3r3r4rGs zTimeField.to_representationrr3r3rr4r srcsDeZdZedededdZfddZddZd d ZZS) DurationFieldzFDuration has wrong format. Use one of these formats instead: {format}.rMrN)r}rQrRc s|dd|_|dd|_tjf||jdk r^t|jd|jd}|jt |j|d|jdk rt|jd|jd}|jt |j|ddSrUrXr(rr3r4rles    zDurationField.__init__cCs:t|tjr|Stt|}|dk r(|S|jddddS)Nr}z[DD] [HH:[MM:]]ss[.uuuuuu]r)rBr timedeltarr)r)rkr[rr3r3r4rrs   zDurationField.to_internal_valuecCst|Sr6rrr3r3r4rzszDurationField.to_representation r/r0r1rrrlrrrr3r3rr4r^s rcsfeZdZdediZdZedZfddZddZd d Z d d Z d dZ ddZ e e e ZZS) ChoiceFieldinvalid_choice "{input}" is not a valid choice.NzMore than {count} items...c sF||_|d|j|_|d|j|_|dd|_tjf|dS)N html_cutoffhtml_cutoff_textrF)rar&rrrrrl)rkrarrr3r4rls zChoiceField.__init__cCsJ|dkr|jrdSz|jt|WStk rD|jd|dYnXdS)Nrrr)rchoice_strings_to_valuesr)rOrrr3r3r4rs zChoiceField.to_internal_valuecCs|dkr |S|jt||S)N)rNrrr)rr3r3r4rszChoiceField.to_representationcCst|j|j|jdS)zP Helper method for use with templates rendering select widgets. )ryrz)r{rxrrrr3r3r4r{s zChoiceField.iter_optionscCs|jSr6)_choicesrr3r3r4 _get_choicesszChoiceField._get_choicescCs,t||_t|j|_dd|jD|_dS)NcSsi|]}t||qSr3r.)r;r\r3r3r4rsz,ChoiceField._set_choices..)r`rxrhrrar)rkrar3r3r4 _set_choicess   zChoiceField._set_choices)r/r0r1rrrrrlrrr{rrrrarr3r3rr4rs    rcsTeZdZedededdZgZfddZddZfd d Zd d Z Z S) MultipleChoiceFieldr5Expected a list of items but got type "{input_type}".z This selection may not be empty.)r not_a_listr-c s |dd|_tjf|dS)N allow_emptyT)r&rrrlrrr3r4rlszMultipleChoiceField.__init__cCs@|j|krt|jddrtSt|r2||jS||jtS)NrDF)rrMrr-r'rgetlistrrkrYr3r3r4rs    zMultipleChoiceField.get_valuecsXt|tst|ds(jdt|jdjsDt|dkrDdfdd|DS)N__iter__rZ input_typerr-csh|]}tt|qSr3)rrrr)rrkr3r4 sz8MultipleChoiceField.to_internal_value..)rBr)rrrr/rrYrrrr4rs  z%MultipleChoiceField.to_internal_valuecsfdd|DS)Ncsh|]}jt||qSr3rrrr3r4rsz8MultipleChoiceField.to_representation..r3rr3rr4rs z%MultipleChoiceField.to_representation) r/r0r1rrrrlrrrrr3r3rr4rs  rcs*eZdZdediZdfdd ZZS) rrz%"{input}" is not a valid path choice.NFTc  s0t||||||d}|j|d<tjf|dS)N)match recursive allow_files allow_foldersrra)DjangoFilePathFieldrarrl) rkpathrrrrrrrrr3r4rls zFilePathField.__init__)NFTFNr2r3r3rr4rsrcsPeZdZedededededdZfddZd 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 c sB|dd|_|dd|_d|kr0|d|_tjf|dS)Nr allow_empty_fileFuse_url)r&r rrrrlrrr3r4rls  zFileField.__init__cCsz|j}|j}Wntk r.|dYnX|s>|d|jsR|sR|d|jr|t||jkr||jd|jt|d|S)Nr}rr-r )r length)namesizerNrrr rY)rkr file_name file_sizer3r3r4rs    zFileField.to_internal_valuecCsf|sdSt|dtj}|r`z |j}Wntk r:YdSX|jdd}|dk r\||S|S|jS)Nrr) rMr&ZUPLOADED_FILES_USE_URLurlrNrrZbuild_absolute_urir)rkr[rrrr3r3r4rs  zFileField.to_representationrr3r3rr4rs rcs4eZdZdediZfddZfddZZS)rZ invalid_imagezYUpload a valid image. The file you uploaded was either not an image or a corrupted image.c s |dt|_tjf|dS)N_DjangoImageField)r&DjangoImageFieldrrrlrrr3r4rl/szImageField.__init__cs&t|}|}|j|_||Sr6)rrrrclean)rkrZ file_objectZ django_fieldrr3r4r3s zImageField.to_internal_value)r/r0r1rrrlrrr3r3rr4r(s rcs,eZdZfddZddZddZZS)_UnvalidatedFieldc stjf|d|_d|_dSNT)rrlrrrrr3r4rl@sz_UnvalidatedField.__init__cCs|Sr6r3rr3r3r4rEsz#_UnvalidatedField.to_internal_valuecCs|Sr6r3rr3r3r4rHsz#_UnvalidatedField.to_representation)r/r0r1rlrrrr3r3rr4r?s rcsdeZdZeZgZededededdZfddZdd Z d d Z d d Z ddZ Z S) ListFieldrzThis list may not be empty.z5Ensure this field has at least {min_length} elements.z9Ensure this field has no more than {max_length} elements.)rr-r!r c s|dt|j|_|dd|_|dd|_|dd|_t|jrTt d|jj dksht dt j f||jj d|d |jdk rt|jd|jd }|jt|j|d |jdk rt|jd|jd }|jt|j|d dS) NchildrTr r!"`child` has not been instantiated.vThe `source` argument is not meaningful when applied to a `child=` field. Remove `source=` from the field declaration.rrrr#r$r%)r&rrrrr r!r>isclassrrrrlrr+rrr'rr r(rr3r4rlVs   zListField.__init__cCsd|j|krt|jddrtSt|rV||jg}t|dkrD|Stj||jtdS| |jtS)NrDFr)prefixr:) rrMrr-r'rrrYparse_html_listr)rkrYvalr3r3r4rks   zListField.get_valuecCsjt|rtj|gd}t|ttfs0t|dsD|jdt|j d|j s`t |dkr`|d| |S)zY List of dicts of native values <- List of dicts of primitive datatypes. rrrrrr-) r'rrrBr)rrrrr/rrYrun_child_validationrr3r3r4rzs  zListField.to_internal_valuecsfdd|DS)zS List of object instances -> List of dicts of primitive datatypes. cs$g|]}|dk rj|ndqSr6)rrrrr3r4rsz/ListField.to_representation..r3rr3rr4rszListField.to_representationc Cstg}t}t|D]L\}}z||j|Wqtk r\}z|j||<W5d}~XYqXq|sh|St|dSr6)r enumerater'rrrr)rkrresultridxrer3r3r4rszListField.run_child_validationr/r0r1rrrrrrlrrrrrr3r3rr4rLs  rcsXeZdZeZiZededdZfddZddZ dd Z d d Z d d Z Z S) DictFieldz;Expected a dictionary of items but got type "{input_type}".z!This dictionary may not be empty.) not_a_dictr-c sn|dt|j|_|dd|_t|jr8td|jjdksLtdt j f||jj d|ddS)NrrTrrrr) r&rrrrr>rrrrrlrrrr3r4rlszDictField.__init__cCs(t|rtj||jdS||jtS)N)r)r'rparse_html_dictrrr-rr3r3r4rs zDictField.get_valuecCsXt|rt|}t|ts2|jdt|jd|jsNt |dkrN|d| |S)zI Dicts of native values <- Dicts of primitive datatypes. rrrr-) r'rrrBrerrr/rrYrrr3r3r4rs    zDictField.to_internal_valuecsfdd|DS)Ncs.i|]&\}}t||dk r&j|ndqSr6)r)rr)r;r\rrr3r4rsz/DictField.to_representation..)rdrr3rr4rs zDictField.to_representationc Cszi}t}|D]R\}}t|}z|j|||<Wqtk rb}z|j||<W5d}~XYqXq|sn|St|dSr6)rrdr)rrrr)rkrrrr\r[rr3r3r4rszDictField.run_child_validationrr3r3rr4rs  rcs(eZdZedddZfddZZS) HStoreFieldT)rrc s&tjf|t|jts"tddS)NzjThe `child` argument must be an instance of `CharField`, as the hstore extension stores values as strings.)rrlrBrrrrrr3r4rlszHStoreField.__init__)r/r0r1rrrlrr3r3rr4rs rcsDeZdZdediZdZfddZddZdd Zd d Z Z S) JSONFieldr}zValue must be valid JSON.Tc s<|dd|_|dd|_|dd|_tjf|dS)NbinaryFencoderdecoder)r&rrrrrlrrr3r4rlszJSONField.__init__cCs@t|r2|j|kr2Gdddt}|||jS||jtS)Nc@seZdZddZdS)z'JSONField.get_value..JSONStringcSst||}d|_|Sr)r)ris_json_string)rr[rbr3r3r4rs z/JSONField.get_value..JSONString.__new__N)r/r0r1rr3r3r3r4 JSONStringsr)r'rrr)rr-)rkrYrr3r3r4rszJSONField.get_valuec CsrzJ|jst|ddr8t|tr&|}tj||jdWStj||j dWn"t t fk rl| dYnX|S)NrFrr}) rrMrBbytesdecoder)loadsrdumpsrrrPrrr3r3r4rs zJSONField.to_internal_valuecCs"|jrtj||jd}|}|S)Nr)rr)rrencoderr3r3r4r szJSONField.to_representation) r/r0r1rrZ _is_jsonfieldrlrrrrr3r3rr4rs   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<tjf|dS)NTr)rrlrrr3r4rl"szReadOnlyField.__init__cCs|Sr6r3rr3r3r4r&szReadOnlyField.to_representation)r/r0r1r2rlrrr3r3rr4rs 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<tjf|dS)Nr:zdefault is a required argument.Tr)rrrlrrr3r4rl2szHiddenField.__init__cCstSr6)r-rr3r3r4r7szHiddenField.get_valuecCs|Sr6r3rr3r3r4r<szHiddenField.to_internal_value)r/r0r1r2rlrrrr3r3rr4r*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<tjf|dS)NrrTr) method_namerrl)rkrrrr3r4rlOszSerializerMethodField.__init__cs*|jdkrdj|d|_t||dS)Nzget_{field_name})r)rrQrrrrr3r4rUs zSerializerMethodField.bindcCst|j|j}||Sr6)rMrr)rkr[methodr3r3r4r\sz'SerializerMethodField.to_representation)N)r/r0r1r2rlrrrr3r3rr4r@s 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 rc sZ||_|dd|_tjf||jdk rVt|jd|jd}|jt |j|ddS)Nr r#r$) model_fieldr&r rrlr+rrr'r)rkrrrrr3r4rlls  zModelField.__init__cCs2|jj}|dk r&|jj|j|S|j|Sr6)rZ remote_fieldmodelZ_meta get_fieldrZ to_python)rkrrelr3r3r4rwszModelField.to_internal_valuecCs|Sr6r3)rkrIr3r3r4rV}szModelField.get_attributecCs$|j|}t|r|S|j|Sr6)rZvalue_from_objectrZvalue_to_string)rkrIr[r3r3r4rs zModelField.to_representation) r/r0r1r2rrrlrrVrrr3r3rr4ras r)NN)|rrrirCr>r7rCr collectionsrcollections.abcrZ django.confrZdjango.core.exceptionsrrrZdjango.core.validatorsrrr r r r r rrZ django.formsrrrrZ django.utilsrZdjango.utils.dateparserrrrZdjango.utils.durationrZdjango.utils.encodingrrZdjango.utils.formatsrrZdjango.utils.ipv6rZdjango.utils.timezonerZdjango.utils.translationr rZpytz.exceptionsr!Zrest_frameworkr"r#r$Zrest_framework.exceptionsr%Zrest_framework.settingsr&Zrest_framework.utilsr'r(r)r*Zrest_framework.utils.formattingr+Zrest_framework.validatorsr,r- Exceptionr5rLrVr]r`rhr{rrrrrr8rrrrrrrrrrr/r3r4r:r;rErLr]r_rvrrrrrrrrrrrrrrrr3r3r3r4s     ,             /$ .2   $%$XC>"9)3 O@ /!