U ڲg @sDddlZddlZddlZddlZddlZddlZddlZddlZddlZddl 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 ddl5Z5Wne6k rRdZ5YnXddl7m8Z8ddl9m: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__r0r09/tmp/pip-unpacked-wheel-11h17kvo/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||}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: {}) 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(         rtcsZt|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,|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|jjdk }|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_|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. 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 tk rn}zt|jtrR||jW5d}~XYq tk 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. 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|}Wn2tk r@|jj}tj||d}t|YnX|jf|}t||ddS)zH A helper method that simply raises a validation error. ) class_namer[rxN)rrMrr,MISSING_ERROR_MESSAGErOrr)rdr[rrrZmessage_stringr0r0r1rNs z Field.failcCs|}|jdk r|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__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|qSr0)r@ REGEX_TYPEcopydeepcopyr8itemr0r0r1r}~sz&Field.__deepcopy__..cs*i|]"\}}||dkr"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 sV /$   )!       rc seZdZdediZdZdZdddddd d d hZd d dddddddh ZdddhZ fddZ e ddZ ddZ ddZZS) BooleanFieldrvzMust be a valid boolean.Ftyyestrueon1roTfnnofalseoff0rgrrNc s*|ddrd|_d|_tjf|dS)NrF)rrrrrerdrrr0r1res zBooleanField.__init__cCst|tr|S|Sr3)r@strlowerr\r0r0r1 _lower_if_strs zBooleanField._lower_if_strc Csttf|||jkr*W5QRdS|||jkrHW5QRdS|||jkrl|jrlW5QRdSW5QRX|jd|ddS)NTFrvinput) contextlibsuppress TypeErrorr TRUE_VALUES FALSE_VALUES NULL_VALUESrrrr0r0r1rs zBooleanField.to_internal_valuecCsJ|||jkrdS|||jkr(dS|||jkrB|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|_tjf||jdk rzt|jd|jd}|j t |j|d|jdk rt|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 s.tjf|t|jdd}|j|dSNrvr)rrerrrrrdrrrr0r1re szEmailField.__init__r,r-r.rrrerr0r0rr1rsrcs(eZdZdediZfddZZS) RegexFieldrvz/This value does not match the required pattern.c s0tjf|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 s`tjf|||_|jr8ttdtj|jdd}nttd|jdd}|j |dS)Nz ^[-\w]+\Zr#rz^[-a-zA-Z0-9_]+$rv) rre allow_unicoder recompileUNICODErrr)rdr$rrrr0r1re s zSlugField.__init__)Fr r0r0rr1r"sr"cs(eZdZdediZfddZZS)URLFieldrvzEnter a valid URL.c s.tjf|t|jdd}|j|dSr)rrerrrrrrr0r1re/szURLField.__init__r r0r0rr1r(*sr(cs<eZdZdZdediZfddZddZdd ZZ S) UUIDField) hex_verbosehexrZurnrvzMust be a valid UUID.c sB|dd|_|j|jkr0tdd|jtjf|dS)NrOr*z;Invalid format for uuid representation. Must be one of "{}"z", ")r uuid_format valid_formatsrNrOjoinrrerrr0r1re<s  zUUIDField.__init__cCsvt|tjsrzBt|tr&tj|dWSt|tr>tj|dWS|jd|dWn"tk rp|jd|dYnX|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 s@||_|jdk|_tjf|t||j}|j|dS)Nr3)rprotocol unpack_ipv4rrer rr)rdr4rrrr0r1re`s    zIPAddressField.__init__cslt|ts|jd|dd|kr`z|jdkr:t||jWSWn"tk r^|jd|dYnXt|S)Nrvr:)r3Zipv6) r@rrr4rr5rrrrrr0r1rgs  z IPAddressField.to_internal_value)r3) r,r-r.r/rrrerrr0r0rr1r2Ys r2csXeZdZededededdZdZedZfdd 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|_tjf||jdk r^t|jd|jd}|jt |j|d|jdk rt|jd|jd}|jt |j|ddSNr;r<r;rr< rr;r<rrer'rrrr r rrr0r1res    zIntegerField.__init__c Csdt|tr"t||jkr"|dzt|jdt|}Wn"tt fk r^|dYnX|S)Nr=rrv) r@rlenMAX_STRING_LENGTHrr re_decimalsubrNrrr0r0r1rs zIntegerField.to_internal_valuecCst|Sr3r/rr0r0r1rszIntegerField.to_representation) r,r-r.rrrDr%r&rErerrrr0r0rr1r7ws   r7csTeZdZedededededdZdZfdd Zd d Zd d ZZ S) FloatFieldA valid number is required.r8r9r:z+Integer value too large to convert to float)rvr;r<r=overflowr>c s|dd|_|dd|_tjf||jdk r^t|jd|jd}|jt |j|d|jdk rt|jd|jd}|jt |j|ddSr?rBrrr0r1res    zFloatField.__init__c Cspt|tr"t||jkr"|dz t|WSttfk rN|dYntk rj|dYnXdS)Nr=rvrI) r@rrCrDrrrrN OverflowErrorrr0r0r1rs  zFloatField.to_internal_valuecCst|Sr3)rrr0r0r1rszFloatField.to_representation) r,r-r.rrrDrerrrr0r0rr1rGs  rGcs~eZdZedededededededdZd Zdfd d ZfddZddZddZ ddZ ddZ Z S) DecimalFieldrHr8r9z@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  sh||_||_||_||_|dk r&||_|jr2d|_||_||_|jdk r`t|jtj s`t d|jdk rt|jtj st d|jdk r|jdk r|j|j|_ nd|_ t jf| |jdk rt|jd|jd} |jt|j| d|jdk r$t|jd|jd} |jt|j| d|dk r^d d ttD} || ks^td || f||_dS) NTz'max_value should be a Decimal instance.z'min_value should be a Decimal instance.r;r@rr<rAcSsg|]\}}|dr|qS)ZROUND_) startswith)r8r~vr0r0r1r}s z)DecimalField.__init__..z=Invalid rounding option %s. Valid values for rounding are: %s)rLdecimal_placeslocalizenormalize_outputcoerce_to_stringr;r<r@decimalDecimalwarningswarnrNrrer'rrrr r varsr]rrounding) rdrLrQrTr;r<rRrZrSrrzZvalid_roundingsrr0r1resD         zDecimalField.__init__cs&t|dkr|jrdSt|S)Nrr)rrrrrrrr0r1rsz"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. r=rvZInfz-Inf) rrrRrrCrDrrUrVDecimalExceptionis_nanquantizevalidate_precisionrr0r0r1rs    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. rNrL)rLrM)rMrN)rN)as_tuplerCabsrLrrQrN)rdr\signZ digittupleexponentZ total_digitsZ whole_digitsrQr0r0r1r^s&   zDecimalField.validate_precisioncCsxt|dtj}|dkr"|rdSdSt|tjs@tt|}||}|j rX| }|s`|S|j rnt |Sd |S)NrTrz{:f})rKr"ZCOERCE_DECIMAL_TO_STRINGr@rUrVrrr]rS normalizerRrrO)rdr\rTZ quantizedr0r0r1r<s  zDecimalField.to_representationcCsJ|jdkr|St}|jdk r,|j|_|jtd|j|j|dS)zI Quantize the decimal value to the configured precision. Nz.1)rZr) rQrU getcontextrrLprecr]rVrZ)rdr\rr0r0r1r]Ts   zDecimalField.quantize)NNNFNF) r,r-r.rrrDrerrr^rr]rr0r0rr1rKs& ) #rKcsjeZdZededededdZejjZeddffdd 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_awarerINc s<|tk r||_|dk r||_|dk r*||_tjf|dSr3)r*rO input_formatsrrre)rdrOridefault_timezonerrr0r1repszDateTimeField.__init__c Cst|dr|jn|}|dk rt|rVz ||WStk rT|dYnXz(t||}t|sz|jd|d|WSt k r}z(t rt |t j j r|jd|d|W5d}~XYqXn"|dkrt|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. rNrIrhr)rrrjZis_aware astimezonerJrrhr( Exceptionpytzr@ exceptionsZInvalidTimeErrorZ make_naivedatetimeutc)rdr\Zfield_timezonedter0r0r1enforce_timezoneys&   zDateTimeField.enforce_timezonecCstjrtSdSr3)rZUSE_TZrZget_current_timezonerr0r0r1rjszDateTimeField.default_timezonec Cst|dtj}t|tjr0t|tjs0|dt|tjrF||S|D]t}t t t ^| t krt|}|dk r||W5QRS|||}||W5QRSQRXqJt|}|jd|ddS)NrirgrvrO)rKr"ZDATETIME_INPUT_FORMATSr@rorgrrsrrrNrrrrdatetime_parserr$Zdatetime_formatsrdr\riZ input_formatparsedZhumanized_formatr0r0r1rs     " zDateTimeField.to_internal_valuecCsr|sdSt|dtj}|dks(t|tr,|S||}|tkrh|}| drd|ddd}|S| |S)NrOz+00:00iZ) rKr"ZDATETIME_FORMATr@rrsrr isoformatendswithstrftimerdr\Z output_formatr0r0r1rs   zDateTimeField.to_representation)r,r-r.rrrostrptimerur*rersrjrrrr0r0rr1rfgs rfcsLeZdZededdZejjZedffdd 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.)rvroNc s.|tk r||_|dk r||_tjf|dSr3r*rOrirrerdrOrirrr0r1res 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)Nrirorvrt)rKr"ZDATE_INPUT_FORMATSr@rorrgrrrrNrrur$Z date_formatsrvr0r0r1rs(       zDateField.to_internal_valuecCs^|sdSt|dtj}|dks(t|tr,|St|tjr@td|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@rrorrrryr{r|r0r0r1rs zDateField.to_representation r,r-r.rrror}rur*rerrrr0r0rr1r~sr~csFeZdZdediZejjZedffdd Z ddZ dd Z Z S) TimeFieldrvzBTime has wrong format. Use one of these formats instead: {format}.Nc s.|tk r||_|dk r||_tjf|dSr3rrrr0r1re 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)Nrirvrt)rKr"ZTIME_INPUT_FORMATSr@rotimerrrrNrrur$Z time_formatsrrvr0r0r1rs$     zTimeField.to_internal_valuecCsb|dkr dSt|dtj}|dks,t|tr0|St|tjrDtd|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@rrorrrryr{r|r0r0r1r+s zTimeField.to_representationrr0r0rr1rsrcsJeZdZededededdZfddZdd Zd d ZZS) DurationFieldzFDuration has wrong format. Use one of these formats instead: {format}.r8r9z=The number of days must be between {min_days} and {max_days}.)rvr;r<rIc s|dd|_|dd|_tjf||jdk r^t|jd|jd}|jt |j|d|jdk rt|jd|jd}|jt |j|ddSr?rBrrr0r1reJs    zDurationField.__init__cCspt|tjr|Sztt|}Wn0tk rP|jdtjjjtjj jdYnX|dk r^|S|jddddS)NrI)Zmin_daysZmax_daysrvz[DD] [HH:[MM:]]ss[.uuuuuu]rt) r@ro timedeltarrrJrmindaysmax)rdr\rwr0r0r1rWs "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 sF||_|d|j|_|d|j|_|dd|_tjf|dS)N html_cutoffhtml_cutoff_textrF)rXrrrrrre)rdrXrrr0r1reos zChoiceField.__init__cCsl|dkr|jrdSt|tr4t|t|jkr4|j}z|jt|WStk rf|jd|dYnXdS)Nrrr)rr@rrr\choice_strings_to_valuesrMrrr0r0r1rxszChoiceField.to_internal_valuecCs@|dkr |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[r0r0r1rs,z,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|_tjf|dS)N allow_emptyT)rrrrerrr0r1reszMultipleChoiceField.__init__cCs@|j|krt|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,rrCrrrr1rs  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  s8t||||||d}|j|d<||d<tjf|dS)N)match recursive allow_files allow_foldersrrXr)DjangoFilePathFieldrXrre) rdpathrrrrrrrrr0r1res zFilePathField.__init__)NFTFNr r0r0rr1rsrcsPeZdZedededededdZfddZd 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 sB|dd|_|dd|_d|kr0|d|_tjf|dS)Nrallow_empty_fileFuse_url)rrrrrrerrr0r1res  zFileField.__init__cCsz|j}|j}Wntk r.|dYnX|s>|d|jsR|sR|d|jr|t||jkr||jd|jt|d|S)Nrvrr*r)rlength)namesizerLrrrrC)rdr file_name file_sizer0r0r1rs    zFileField.to_internal_valuecCsf|sdSt|dtj}|r`z |j}Wntk r:YdSX|jdd}|dk r\||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|_tjf|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 stjf|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|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) 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<isclassrrrrerr'rrrrr rrr0r1reBs   zListField.__init__cCsd|j|krt|jddrtSt|rV||jg}t|dkrD|Stj||jtdS| |jtS)NrBFr)prefixr7) rrKrr*r#rrrCparse_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,rrCrun_child_validationrr0r0r1rfs  zListField.to_internal_valuecsfdd|DS)zS List of object instances -> List of dicts of primitive datatypes. cs$g|]}|dk rj|ndqSr3)rrrrr0r1r}vsz/ListField.to_representation..r0rr0rr1rrszListField.to_representationc Csg}i}t|D]x\}}z||j|Wqtk rZ}z|j||<W5d}~XYqtk r}zt|||<W5d}~XYqXq|s|St|dSr3) enumeraterrrrrrr)rdrresultridxrrrr0r0r1rxs 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 sn|dt|j|_|dd|_t|jr8td|jjdksLtdt j f||jj d|ddS)NrrTrrrr) rrrrrr<rrrrrerrrr0r1reszDictField.__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,rrCrrr0r0r1rs    zDictField.to_internal_valuecsfdd|DS)Ncs.i|]&\}}t||dk r&j|ndqSr3)rrr)r8r[rrr0r1rsz/DictField.to_representation..)r]rr0rr1rs zDictField.to_representationc Csxi}i}|D]R\}}t|}z|j|||<Wqtk r`}z|j||<W5d}~XYqXq|sl|St|dSr3)r]rrrrr)rdrrrr[r\rrr0r0r1rszDictField.run_child_validationrr0r0rr1rs  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.)rrer@rr rrrr0r1reszHStoreField.__init__)r,r-r.r rrerr0r0rr1rs rcsDeZdZdediZdZfddZddZdd Zd d Z Z S) JSONFieldrvzValue must be valid JSON.Tc s<|dd|_|dd|_|dd|_tjf|dS)NbinaryFencoderdecoder)rrrrrrerrr0r1reszJSONField.__init__cCs@t|r2|j|kr2Gdddt}|||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 CsrzJ|jst|ddr8t|tr&|}tj||jdWStj||j dWn"t t fk rl| dYnX|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<tjf|dS)NTr)rrerrr0r1reszReadOnlyField.__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|kstdd|d<tjf|dS)Nr7zdefault is a required argument.Tr)rrrerrr0r1re!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<tjf|dS)NrrTr) method_namerre)rdrrrr0r1re?szSerializerMethodField.__init__cs*|jdkrdj|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 sZ||_|dd|_tjf||jdk rVt|jd|jd}|jt |j|ddS)Nrrr) model_fieldrrrrer'rrrr)rdrrrzrr0r1re\s  zModelField.__init__cCs2|jj}|dk r&|jj|j|S|j|Sr3)rZ remote_fieldmodelZ_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)zrrrorUrAr<r%r0rWcollections.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.translationrrrm 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*rlr2rJrTrWrartrrrrrr&rrrrrrrrr rr!r"r(r)r2r7rGrKrfr~rrrrrrrrrrrrrrr0r0r0r1s     (                / u?2   $%'%ZC>&<)3 Q@ /"