a cf @sBddlZddlZddlZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl mZddlmZddlmZddlmZmZmZmZmZmZmZmZddlmZdd 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/ddl0m1Z1ddl2m3Z4z ddl5Z5Wne6yPdZ5Yn0ddl7m8Z8ddl9m:Z:ddl;mZ>ddl?m@Z@mAZAmBZBmCZCddlDmEZEddlFmGZGddlHmIZIGdddZJGdddeKZLddZMdd ZNd!d"ZOd#d$ZPdqd%d&ZQd'd(ZRGd)d*d*ZSGd+d,d,ZTGd-d.d.eKZUeVeWd/ZXd0ZYd1ZZd2Z[d3Z\d4Z]Gd5d6d6Z^Gd7d8d8e^Z_Gd9d:d:e^Z`Gd;d<dd>e`ZbGd?d@d@e`ZcGdAdBdBe`ZdGdCdDdDe^ZeGdEdFdFe`ZfGdGdHdHe^ZgGdIdJdJe^ZhGdKdLdLe^ZiGdMdNdNe^ZjGdOdPdPe^ZkGdQdRdRe^ZlGdSdTdTe^ZmGdUdVdVe^ZnGdWdXdXenZoGdYdZdZenZGd[d\d\e^ZpGd]d^d^epZGd_d`d`e^ZqGdadbdbe^ZrGdcdddde^ZsGdedfdfesZtGdgdhdhe^ZuGdidjdje^ZvGdkdldle^ZwGdmdndne^ZxGdodpdpe^ZydS)rN)Mapping)Enum)settings)ObjectDoesNotExist)ValidationError)EmailValidatorMaxLengthValidatorMaxValueValidatorMinLengthValidatorMinValueValidatorProhibitNullCharactersValidatorRegexValidator URLValidator) FilePathField) ImageFieldtimezone) parse_dateparse_datetimeparse_duration parse_timeduration_string)is_protected_type smart_str)localize_inputsanitize_separators)clean_ipv6_address) gettext_lazy)ISO_8601)ip_address_validators) ErrorDetailr) api_settings)htmlhumanize_datetimejsonrepresentation) lazy_format)valid_datetime)$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__r0r0R/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/rest_framework/fields.pyr*0sr*c@seZdZdZdS)BuiltinSignatureErrorz Built-in function signatures are not inspectable. This exception is raised so the serializer can raise a helpful error message. Nr+r0r0r0r1r2:sr2cCsht|s dSt|rtdt|sBt|sBt|tjsBdSt |}|j }t dd|DS)zC True if the object is a callable that takes no arguments. FzkBuilt-in function signatures are not inspectable. Wrap the function call in a simple, pure Python function.css2|]*}|j|jkp(|j|jkp(|j|jkVqdSN)kindVAR_POSITIONAL VAR_KEYWORDdefaultr*).0paramr0r0r1 Ts   z%is_simple_callable..) callableinspect isbuiltinr2 isfunctionismethod isinstance functoolspartial signature parametersvaluesall)objsigparamsr0r0r1is_simple_callableBs    rJc Cs|D]}z"t|tr||}n t||}Wnty@YdS0t|rz |}Wqttfy}ztd||WYd}~qd}~00q|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: {}) r@rgetattrrrJAttributeErrorKeyError ValueErrorformat)instanceattrsattrexcr0r0r1 get_attribute\s     (rTcCsVi}|D]H}t|ttfs$|||<q|\}}t|ttfrHt|||<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'}} )r@listtupleto_choices_dict)choicesretchoicekeyvaluer0r0r1rWws   rWcCsHi}|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'} )itemsr@dict)rXrYr[r\sub_key sub_valuer0r0r1flatten_choices_dicts   rac 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 ||_dSr3label)selfrcr0r0r1__init__sz/iter_options..StartOptionGroup.__init__Nr,r-r.start_option_groupend_option_grouprer0r0r0r1StartOptionGroupsric@seZdZdZdZdS)z$iter_options..EndOptionGroupFTN)r,r-r.rgrhr0r0r0r1EndOptionGroupsrjc@seZdZdZdZdddZdS)ziter_options..OptionFcSs||_||_||_dSr3r\ display_textdisabled)rdr\rlrmr0r0r1resz%iter_options..Option.__init__N)Frfr0r0r0r1Optionsrnrrb)r\rl)countzn/aTrkN)r]r@r^rO) grouped_choicescutoff cutoff_textrirjrnrpr[r\r_r`r0r0r1 iter_optionss(         rtcsXt|ddpdz |j}Wn&ty@fdd|jDYS0fdd|DS)zf Given a Django ValidationError, return a list of ErrorDetail, with the `code` populated. codeNinvalidcs8g|]0}t|jr|j|jn|j|jr,|jndqSrur!rImessagerur8errorrxr0r1 sz$get_error_detail..cs$i|]\}}|fdd|DqS)cs8g|]0}t|jr|j|jn|j|jr,|jndqSrwryr{rxr0r1r}sz/get_error_detail...r0)r8kerrorsrxr0r1 s z$get_error_detail..)rK error_dictrLZ error_listr])exc_inforr0rxr1get_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 ||_dSr3r7)rdr7r0r0r1reszCreateOnlyDefault.__init__cCsF|jjdu}|rtt|jr@t|jddr8||S|S|jS)Nrequires_contextF)parentrP SkipFieldr;r7rK)rdserializer_fieldZ is_updater0r0r1__call__s   zCreateOnlyDefault.__call__cCsd|jjt|jfS)Nz%s(%s)) __class__r,reprr7rdr0r0r1__repr__szCreateOnlyDefault.__repr__N)r,r-r.r/rrerrr0r0r0r1rs  rc@s eZdZdZddZddZdS)CurrentUserDefaultTcCs |jdjS)Nrequest)contextuser)rdrr0r0r1r szCurrentUserDefault.__call__cCs d|jjS)Nz%s())rr,rr0r0r1r szCurrentUserDefault.__repr__N)r,r-r.rrrr0r0r0r1rsrc@s eZdZdS)rN)r,r-r.r0r0r0r1rsrz-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 d d Z e ddZejddZddZddZddZddZddZddZefddZdd Zd!d"Zd#d$Zd%d&Ze d'd(Ze d)d*Zfd+d,Zd-d.Zd/d0ZZ S)1FieldrzThis field is required.zThis field may not be null.)requirednullNF) read_only write_onlyrr7initialsourcerc help_textstyleerror_messages validators allow_nullc CsFtj|_tjd7_|dur,|tuo*| }|r<|r|dd|fS|durv|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. TrBFrNrr)FNTN) rrr*rKrrrfailrrrddatar0r0r1validate_empty_valuess      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)rdrZis_empty_valuer\r0r0r1run_validation s   zField.run_validationc Csg}|jD]}z$t|ddr(|||n||Wq typ}z&t|jtrP||jWYd}~q d}~0ty}z|t|WYd}~q d}~00q |rt|dS)z Test the given value against all the validators on the field, and either raise a `ValidationError` or simply return. rFN) rrKrr@detailr^extendDjangoValidationErrorr)rdr\r validatorrSr0r0r1rs      &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.rrNNotImplementedErrorrOrr,rrr0r0r1r6s 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}.rNrrdr\r0r0r1to_representationCs zField.to_representationcKs`z|j|}Wn0ty>|jj}tj||d}t|Yn0|jfi|}t||ddS)zH A helper method that simply raises a validation error. ) class_namer[rxN)rrMrr,MISSING_ERROR_MESSAGErOAssertionErrorr)rdr[rrrZmessage_stringr0r0r1rNs z Field.failcCs|}|jdur|j}q|S)zB Returns the top-level serializer for this field. N)r)rdrr0r0r1r[s z Field.rootcCst|jdiS)zY Returns the context as passed to the root serializer on initialization. _context)rKrrr0r0r1resz 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)rrrrPrr0r1rls z Field.__new__cs8dd|jD}fdd|jD}|j|i|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|qSr0)r@ REGEX_TYPEcopydeepcopyr8itemr0r0r1r}~sz&Field.__deepcopy__..cs*i|]"\}}||dvr"t|n|qS))rregex)rr)r8r[r\memor0r1rsz&Field.__deepcopy__..)rrr]r)rdrrrr0rr1 __deepcopy__vs 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_reprrr0r0r1rszField.__repr__)!r,r-r.rrrrr*rrrerrpropertyrsetterrrrrTrrrrrrrrrrrr __classcell__r0r0rr1r sH /$   )!       rcsdeZdZdediZdZdZhdZhdZhdZ fddZ e d d Z d d Z d dZZS) BooleanFieldrvzMust be a valid boolean.F>rotruetyes1ony>rnofalsenofff0>rNrc s.|ddrd|_d|_tjfi|dS)NrF)rrrrrerdrrr0r1res zBooleanField.__init__cCst|tr|S|Sr3)r@strlowerr\r0r0r1 _lower_if_strs zBooleanField._lower_if_strcCsttv|||jvr,WddS|||jvrLWddS|||jvrr|jrrWddSWdn1s0Y|jd|ddS)NTFrvinput) contextlibsuppress TypeErrorr TRUE_VALUES FALSE_VALUES NULL_VALUESrrrr0r0r1rs .zBooleanField.to_internal_valuecCsJ|||jvrdS|||jvr(dS|||jvrB|jrBdSt|S)NTF)rrr r rboolrr0r0r1rszBooleanField.to_representation)r,r-r.rrrrrr r re staticmethodrrrrr0r0rr1rs     rcs^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.)rvblank max_length min_lengthrc s|dd|_|dd|_|dd|_|dd|_tjfi||jdur~t|jd|jd}|j t |j|d|jdurt|jd|jd }|j t |j|d|j t |j tdS) NrFtrim_whitespaceTrrrrzr)poprrrrrrer'rrappendrr r r)rdrrzrr0r1res"    zCharField.__init__cs>|dks|jr2t|dkr2|js.|ddSt|S)Nrr)rrstriprrrrrrr0r1rs  zCharField.run_validationcCs>t|tst|tttfs$|dt|}|jr:|S|S)Nrv)r@r rintfloatrrrrdrr\r0r0r1rs zCharField.to_internal_valuecCst|Sr3)rrr0r0r1rszCharField.to_representation) r,r-r.rrrrer*rrrrr0r0rr1r s   r cs(eZdZdediZfddZZS) EmailFieldrvzEnter a valid email address.c s2tjfi|t|jdd}|j|dSNrvr)rrerrrrrdrrrr0r1re szEmailField.__init__r,r-r.rrrerr0r0rr1rsrcs(eZdZdediZfddZZS) RegexFieldrvz/This value does not match the required pattern.c s4tjfi|t||jdd}|j|dSr)rrer rrr)rdrrrrr0r1reszRegexField.__init__r r0r0rr1r!sr!cs0eZdZededdZdfdd ZZS) SlugFieldzLEnter a valid "slug" consisting of letters, numbers, underscores or hyphens.zUEnter a valid "slug" consisting of Unicode letters, numbers, underscores, or hyphens.)rvinvalid_unicodeFc sdtjfi|||_|jrtj|dWS|jd|dWn tyn|jd|dYn0|S)Nr)r+rvr)r@uuidUUIDrrrrNrr0r0r1rEs    zUUIDField.to_internal_valuecCs"|jdkrt|St||jSdS)Nr*)r-rrKrr0r0r1rRs zUUIDField.to_representation) r,r-r.r.rrrerrrr0r0rr1r)5s   r)cs:eZdZdZdediZd fdd ZfddZZS) IPAddressFieldz5Support both IPAddressField and GenericIPAddressFieldrvz#Enter a valid IPv4 or IPv6 address.bothc sD||_|jdk|_tjfi|t||j}|j|dS)Nr4)rprotocol unpack_ipv4rrer rr)rdr5rrrr0r1re`s    zIPAddressField.__init__csjt|ts|jd|dd|vr^z|jdvr:t||jWSWn ty\|jd|dYn0t|S)Nrvr:)r4Zipv6) r@rrr5rr6rrrrrr0r1rgs   z IPAddressField.to_internal_value)r4) r,r-r.r/rrrerrr0r0rr1r3Ys r3csXeZdZededededdZdZedZfdd 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.)rv max_value min_valuemax_string_lengthz\.0*\s*$c s|dd|_|dd|_tjfi||jdurbt|jd|jd}|jt |j|d|jdurt|jd|jd}|jt |j|ddSNr<r=r<rr= rr<r=rrer'rrrr r rrr0r1res    zIntegerField.__init__c Csbt|tr"t||jkr"|dzt|jdt|}Wn tt fy\|dYn0|S)Nr>rrv) r@rlenMAX_STRING_LENGTHrr re_decimalsubrNrrr0r0r1rs zIntegerField.to_internal_valuecCst|Sr3r0rr0r0r1rszIntegerField.to_representation) r,r-r.rrrEr%r&rFrerrrr0r0rr1r8ws   r8csTeZdZedededededdZdZfdd Zd d Zd d ZZ S) FloatFieldA valid number is required.r9r:r;z+Integer value too large to convert to float)rvr<r=r>overflowr?c s|dd|_|dd|_tjfi||jdurbt|jd|jd}|jt |j|d|jdurt|jd|jd}|jt |j|ddSr@rCrrr0r1res    zFloatField.__init__c Cslt|tr"t||jkr"|dz t|WSttfyL|dYntyf|dYn0dS)Nr>rvrJ) r@rrDrErrrrN OverflowErrorrr0r0r1rs   zFloatField.to_internal_valuecCst|Sr3)rrr0r0r1rszFloatField.to_representation) r,r-r.rrrErerrrr0r0rr1rHs  rHcs~eZdZedededededededdZd Zdfd d ZfddZddZddZ ddZ ddZ Z S) DecimalFieldrIr9r: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.r;)rvr<r= max_digitsmax_decimal_placesmax_whole_digitsr>r?NFc  sl||_||_||_||_|dur&||_|jr2d|_||_||_|jdur`t|jtj s`t d|jdurt|jtj st d|jdur|jdur|j|j|_ nd|_ t jfi| |jdurt|jd|jd} |jt|j| d|jdur(t|jd|jd} |jt|j| d|durbd d ttD} || vsbJd || f||_dS) NTz'max_value should be a Decimal instance.z'min_value should be a Decimal instance.r<rArr=rBcSsg|]\}}|dr|qS)ZROUND_) startswith)r8r~vr0r0r1r}z)DecimalField.__init__..z=Invalid rounding option %s. Valid values for rounding are: %s)rMdecimal_placeslocalizenormalize_outputcoerce_to_stringr<r=r@decimalDecimalwarningswarnrOrrer'rrrr r varsr]rounding) rdrMrSrVr<r=rTr\rUrrzZvalid_roundingsrr0r1resD         zDecimalField.__init__cs&t|dkr|jrdSt|S)Nrr)rrrrrrrr0r1rsz"DecimalField.validate_empty_valuescCst|}|jrt|}t||jkr2|dzt|}Wntj y^|dYn0| rr|d|tdtdfvr|d| | |S)zd Validate that the input is a decimal number and return a Decimal instance. r>rvZInfz-Inf) rrrTrrDrErrWrXDecimalExceptionis_nanquantizevalidate_precisionrr0r0r1rs    zDecimalField.to_internal_valuecCs|\}}}|dkr,t||}|}d}n>t|t|krZt|}|t|}t|}nt|}d}|}|jdur||jkr|jd|jd|jdur||jkr|jd|jd|jdur||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. rNrM)rMrN)rNrO)rO)as_tuplerDabsrMrrSrO)rdr\signZ digittupleexponentZ total_digitsZ whole_digitsrSr0r0r1r`s&   zDecimalField.validate_precisioncCsxt|dtj}|dur"|rdSdSt|tjs@tt|}||}|j rX| }|s`|S|j rnt |Sd |S)NrVrz{:f})rKr"ZCOERCE_DECIMAL_TO_STRINGr@rWrXrrr_rU normalizerTrrO)rdr\rVZ quantizedr0r0r1r<s  zDecimalField.to_representationcCsJ|jdur|St}|jdur,|j|_|jtd|j|j|dS)zI Quantize the decimal value to the configured precision. Nz.1)r\r) rSrW getcontextrrMprecr_rXr\)rdr\rr0r0r1r_Ts   zDecimalField.quantize)NNNFNF) r,r-r.rrrErerrr`rr_rr0r0rr1rLs" ) #rLcsjeZdZededededdZejjZeddffdd 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.)rvdate make_awarerJNc s@|tur||_|dur||_|dur*||_tjfi|dSr3)r*rO input_formatsrrre)rdrOrkdefault_timezonerrr0r1repszDateTimeField.__init__c Cst|dr|jn|}|durt|rTz ||WStyR|dYn0z(t||}t|sx|jd|d|WSt y}z0t rt |t j j r|jd|d|WYd}~qd}~00n"|durt|rt|tjjS|S)z When `self.default_timezone` is `None`, always return naive datetimes. When `self.default_timezone` is not `None`, always return aware datetimes. rNrJrjr)rrrlZis_aware astimezonerKrrjr( Exceptionpytzr@ exceptionsZInvalidTimeErrorZ make_naivedatetimeutc)rdr\Zfield_timezonedter0r0r1enforce_timezoneys&    zDateTimeField.enforce_timezonecCstjrtSdSr3)rZUSE_TZrZget_current_timezonerr0r0r1rlszDateTimeField.default_timezonec Cst|dtj}t|tjr0t|tjs0|dt|tjrF||S|D]}t t t b| t krt|}|dur||WdS|||}||WdS1s0YqJt|}|jd|ddS)NrkrirvrO)rKr"ZDATETIME_INPUT_FORMATSr@rqrirrurrrNrrrrdatetime_parserr$Zdatetime_formatsrdr\rkZ input_formatparsedZhumanized_formatr0r0r1rs     . zDateTimeField.to_internal_valuecCsr|sdSt|dtj}|dus(t|tr,|S||}|tkrh|}| drd|ddd}|S| |S)NrOz+00:00iZ) rKr"ZDATETIME_FORMATr@rrurr isoformatendswithstrftimerdr\Z output_formatr0r0r1rs   zDateTimeField.to_representation)r,r-r.rrrqstrptimerwr*rerurlrrrr0r0rr1rhgs rhcsLeZdZededdZejjZedffdd 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.)rvrqNc s2|tur||_|dur||_tjfi|dSr3r*rOrkrrerdrOrkrrr0r1res zDateField.__init__c Cst|dtj}t|tjr$|dt|tjr4|S|D]z}|tkr~z t |}Wnt t fyjYq0|dur|Sq8z| ||}Wnt t fyYq80|Sq8t |}|jd|ddS)Nrkrqrvrv)rKr"ZDATE_INPUT_FORMATSr@rqrrirrrrNrrwr$Z date_formatsrxr0r0r1rs(       zDateField.to_internal_valuecCs^|sdSt|dtj}|dus(t|tr,|St|tjr@Jd|tkrT|S| |S)NrOzExpected 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.) rKr"Z DATE_FORMATr@rrqrrr{r}r~r0r0r1rs zDateField.to_representation r,r-r.rrrqrrwr*rerrrr0r0rr1rsrcsFeZdZdediZejjZedffdd Z ddZ dd Z Z S) TimeFieldrvzBTime has wrong format. Use one of these formats instead: {format}.Nc s2|tur||_|dur||_tjfi|dSr3rrrr0r1re s zTimeField.__init__c Cst|dtj}t|tjr|S|D]z}|tkrhz t|}Wnt t fyTYq0|dur|Sq"z| ||}Wnt t fyYq"0|Sq"t |}|jd|ddS)Nrkrvrv)rKr"ZTIME_INPUT_FORMATSr@rqtimerrrrNrrwr$Z time_formatsrrxr0r0r1rs$     zTimeField.to_internal_valuecCsb|dvr dSt|dtj}|dus,t|tr0|St|tjrDJd|tkrX|S| |S)N)NrrOzExpected 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.) rKr"Z TIME_FORMATr@rrqrrr{r}r~r0r0r1r+s zTimeField.to_representationrr0r0rr1rs rcsJeZdZededededdZfddZdd Zd d ZZS) DurationFieldzFDuration has wrong format. Use one of these formats instead: {format}.r9r:z=The number of days must be between {min_days} and {max_days}.)rvr<r=rJc s|dd|_|dd|_tjfi||jdurbt|jd|jd}|jt |j|d|jdurt|jd|jd}|jt |j|ddSr@rCrrr0r1reJs    zDurationField.__init__cCsnt|tjr|Sztt|}Wn.tyN|jdtjjjtjj jdYn0|dur\|S|jddddS)NrJ)Zmin_daysZmax_daysrvz[DD] [HH:[MM:]]ss[.uuuuuu]rv) r@rq timedeltarrrKrmindaysmax)rdr\ryr0r0r1rWs  "zDurationField.to_internal_valuecCst|Sr3rrr0r0r1rbszDurationField.to_representation r,r-r.rrrerrrr0r0rr1rBs  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 sJ||_|d|j|_|d|j|_|dd|_tjfi|dS)N html_cutoffhtml_cutoff_textrF)rXrrrrrre)rdrXrrr0r1reos zChoiceField.__init__cCsj|dkr|jrdSt|tr4t|t|jkr4|j}z|jt|WStyd|jd|dYn0dS)Nrrr)rr@rrr\choice_strings_to_valuesrMrrr0r0r1rxs zChoiceField.to_internal_valuecCs@|dvr |St|tr.t|t|jkr.|j}|jt||S)N)rN)r@rrr\rrrr0r0r1rs zChoiceField.to_representationcCst|j|j|jdS)zP Helper method for use with templates rendering select widgets. )rrrs)rtrqrrrr0r0r1rts zChoiceField.iter_optionscCs|jSr3)_choicesrr0r0r1 _get_choicesszChoiceField._get_choicescCs,t||_t|j|_dd|jD|_dS)NcSs<i|]4}t|tr.t|t|jkr.t|jnt||qSr0)r@rrr\)r8r[r0r0r1rsz,ChoiceField._set_choices..)rWrqrarrXr)rdrXr0r0r1 _set_choicess   zChoiceField._set_choices)r,r-r.rrrrrerrrtrrrrXrr0r0rr1rhs    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|_tjfi|dS)N allow_emptyT)rrrrerrr0r1reszMultipleChoiceField.__init__cCs@|j|vrt|jddrtSt|r2||jS||jtS)NrBF)rrKrr*r#rgetlistrrdrr0r0r1rs    zMultipleChoiceField.get_valuecsXt|tst|ds(jdt|jdjsDt|dkrDdfdd|DS)N__iter__rZ input_typerr*csh|]}tt|qSr0)rrrr)rrdr0r1 sz8MultipleChoiceField.to_internal_value..)r@rrrrr,rrDrrrr1rs  z%MultipleChoiceField.to_internal_valuecsfdd|DS)Ncsh|]}jt||qSr0)rrrrrr0r1rsz8MultipleChoiceField.to_representation..r0rr0rr1rs z%MultipleChoiceField.to_representation) r,r-r.rrrrerrrrr0r0rr1rs  rcs*eZdZdediZdfdd ZZS) rrz%"{input}" is not a valid path choice.NFTc  s<t||||||d}|j|d<||d<tjfi|dS)N)match recursive allow_files allow_foldersrrXr)DjangoFilePathFieldrXrre) rdpathrrrrrrrrr0r1res zFilePathField.__init__)NFTFNr r0r0rr1rs rcsPeZdZedededededdZfddZd 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}).)rrvno_namer*rc sF|dd|_|dd|_d|vr0|d|_tjfi|dS)Nrallow_empty_fileFuse_url)rrrrrrerrr0r1res  zFileField.__init__cCs~z|j}|j}Wnty,|dYn0|s<|d|jsP|sP|d|jrzt||jkrz|jd|jt|d|S)Nrvrr*r)rlength)namesizerLrrrrD)rdr file_name file_sizer0r0r1rs     zFileField.to_internal_valuecCsd|sdSt|dtj}|r^z |j}Wnty8YdS0|jdd}|durZ||S|S|jS)Nrr) rKr"ZUPLOADED_FILES_USE_URLurlrLrrZbuild_absolute_urir)rdr\rrrr0r0r1rs   zFileField.to_representationrr0r0rr1rs rcs4eZdZdediZfddZfddZZS)rZ invalid_imagezYUpload a valid image. The file you uploaded was either not an image or a corrupted image.c s$|dt|_tjfi|dS)N_DjangoImageField)rDjangoImageFieldrrrerrr0r1reszImageField.__init__cs&t|}|}|j|_||Sr3)rrrrclean)rdrZ file_objectZ django_fieldrr0r1rs zImageField.to_internal_value)r,r-r.rrrerrr0r0rr1rs  rcs,eZdZfddZddZddZZS)_UnvalidatedFieldc s"tjfi|d|_d|_dSNT)rrerrrrr0r1re,sz_UnvalidatedField.__init__cCs|Sr3r0rr0r0r1r1sz#_UnvalidatedField.to_internal_valuecCs|Sr3r0rr0r0r1r4sz#_UnvalidatedField.to_representation)r,r-r.rerrrr0r0rr1r+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*rrc s|dt|j|_|dd|_|dd|_|dd|_t|jrTJd|jj dushJdt j fi||jj d|d |jdurt |jd|jd }|jt|j|d |jdurt |jd|jd }|jt|j|d dS) NchildrTrr"`child` has not been instantiated.vThe `source` argument is not meaningful when applied to a `child=` field. Remove `source=` from the field declaration.rrrrrr)rrrrrrrr<isclassrrrerr'rrrrr rrr0r1reBs   zListField.__init__cCsd|j|vrt|jddrtSt|rV||jg}t|dkrD|Stj||jtdS| |jtS)NrBFr)prefixr7) rrKrr*r#rrrDparse_html_listr)rdrvalr0r0r1rWs   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#rrr@rrrrrr,rrDrun_child_validationrr0r0r1rfs  zListField.to_internal_valuecsfdd|DS)zS List of object instances -> List of dicts of primitive datatypes. cs$g|]}|durj|ndqSr3)rrrrr0r1r}vrRz/ListField.to_representation..r0rr0rr1rrszListField.to_representationc Csg}i}t|D]|\}}z||j|Wqty\}z|j||<WYd}~qd}~0ty}zt|||<WYd}~qd}~00q|s|St|dSr3) enumeraterrrrrrr)rdrresultridxrrtr0r0r1rxs$zListField.run_child_validationr,r-r.rrrrrrerrrrrr0r0rr1r8s  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 sr|dt|j|_|dd|_t|jr8Jd|jjdusLJdtj fi||jj d|ddS)NrrTrrrr) rrrrrr<rrrrerrrr0r1reszDictField.__init__cCs(t|rtj||jdS||jtS)N)r)r#rparse_html_dictrrr*rr0r0r1rs zDictField.get_valuecCsXt|rt|}t|ts2|jdt|jd|jsNt |dkrN|d| |S)zI Dicts of native values <- Dicts of primitive datatypes. rrrr*) r#rrr@r^rrr,rrDrrr0r0r1rs    zDictField.to_internal_valuecsfdd|DS)Ncs.i|]&\}}t||dur&j|ndqSr3)rrr)r8r[rrr0r1rsz/DictField.to_representation..)r]rr0rr1rs zDictField.to_representationc Cszi}i}|D]T\}}t|}z|j|||<Wqtyb}z|j||<WYd}~qd}~00q|sn|St|dSr3)r]rrrrr)rdrrrr[r\rtr0r0r1rs"zDictField.run_child_validationrr0r0rr1rs  rcs(eZdZedddZfddZZS) HStoreFieldT)rrc s*tjfi|t|jts&JddS)NzjThe `child` argument must be an instance of `CharField`, as the hstore extension stores values as strings.)rrer@rr rrr0r1reszHStoreField.__init__)r,r-r.r rrerr0r0rr1rs rcsDeZdZdediZdZfddZddZdd Zd d Z Z S) JSONFieldrvzValue must be valid JSON.Tc s@|dd|_|dd|_|dd|_tjfi|dS)NbinaryFencoderdecoder)rrrrrrerrr0r1reszJSONField.__init__cCs@t|r2|j|vr2Gdddt}|||jS||jtS)Nc@seZdZddZdS)z'JSONField.get_value..JSONStringcSst||}d|_|Sr)rris_json_string)rr\rYr0r0r1rs z/JSONField.get_value..JSONString.__new__N)r,r-r.rr0r0r0r1 JSONStringsr)r#rrrrr*)rdrrr0r0r1rszJSONField.get_valuec CspzJ|jst|ddr8t|tr&|}tj||jdWStj||j dWn t t fyj| dYn0|S)NrFrrv) rrKr@bytesdecoder%loadsrdumpsrrrNrrr0r0r1rs zJSONField.to_internal_valuecCs"|jrtj||jd}|}|S)Nr)rr%rrencoderr0r0r1rszJSONField.to_representation) r,r-r.rrZ _is_jsonfieldrerrrrr0r0rr1rs   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<tjfi|dS)NTrrrerrr0r1reszReadOnlyField.__init__cCs|Sr3r0rr0r0r1rszReadOnlyField.to_representation)r,r-r.r/rerrr0r0rr1rs 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|vsJdd|d<tjfi|dS)Nr7zdefault is a required argument.Trrrrr0r1re!szHiddenField.__init__cCstSr3)r*rr0r0r1r&szHiddenField.get_valuecCs|Sr3r0rr0r0r1r+szHiddenField.to_internal_value)r,r-r.r/rerrrr0r0rr1rs 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(Serializer): extra_info = SerializerMethodField() def get_extra_info(self, obj): return ... # Calculate some data to return. Nc s,||_d|d<d|d<tjfi|dS)NrrTr) method_namerre)rdrrrr0r1re?szSerializerMethodField.__init__cs*|jdurdj|d|_t||dS)Nzget_{field_name})r)rrOrrrrr0r1rEs zSerializerMethodField.bindcCst|j|j}||Sr3)rKrr)rdr\methodr0r0r1rLsz'SerializerMethodField.to_representation)N)r,r-r.r/rerrrr0r0rr1r/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. rrc s^||_|dd|_tjfi||jdurZt|jd|jd}|jt |j|ddS)Nrrr) model_fieldrrrrer'rrrr)rdrrrzrr0r1re\s  zModelField.__init__cCs2|jj}|dur&|jj|j|S|j|Sr3)rZ remote_fieldmodel_meta get_fieldrZ to_python)rdrrelr0r0r1rgszModelField.to_internal_valuecCs|Sr3r0)rdrGr0r0r1rTmszModelField.get_attributecCs$|j|}t|r|S|j|Sr3)rZvalue_from_objectrZvalue_to_string)rdrGr\r0r0r1rrs zModelField.to_representation) r,r-r.r/rrrerrTrrr0r0rr1rQs r)NN)zrrrqrWrAr<r%r1rYcollections.abcrenumrZ django.confrZdjango.core.exceptionsrrrZdjango.core.validatorsrrr r r r r rZ django.formsrrrrZ django.utilsrZdjango.utils.dateparserrrrZdjango.utils.durationrZdjango.utils.encodingrrZdjango.utils.formatsrrZdjango.utils.ipv6rZdjango.utils.translationrrro ImportErrorZrest_frameworkrZrest_framework.compatr Zrest_framework.exceptionsr!Zrest_framework.settingsr"Zrest_framework.utilsr#r$r%r&Zrest_framework.utils.formattingr'Zrest_framework.utils.timezoner(Zrest_framework.validatorsr)r*rnr2rJrTrWrartrrrrrr&rrrrrrrrr rr!r"r(r)r3r8rHrLrhrrrrrrrrrrrrrrrr0r0r0r1s     (                / u?2   $%'%ZC>&<)3 Q@ /"