lKdu`ddlZddlZddlZddlZddlZddlZddlZddlm Z m Z ddl m Z m Z ddlmZddlmZddlmZddlmZmZmZddlmZmZmZdd lmZdd lmZm Z dd l!m"Z"dd l#m$Z$dd l%m&Z&m'Z'm(Z(m)Z)ddl*m+Z+m,Z,ddl-m.Z.m/Z/ddl0m1Z1ddl2m3Z3ddl4m5Z5ddl6m7Z8gdZ9GddZ:GddZ;dgZdZ?e Gdde Z@Gdd e@ZAGd!d"e@ZBGd#d$eBZCd%ZDd&ZEGd'd(ZFGd)d*eFe@ZGGd+d,eGZHGd-d.e@ZIGd/d0e@ZJGd1d2eBZKGd3d4e@ZLGd5d6e@ZMGd7d8e@ZNGd9d:eNZOGd;de@ZQGd?d@e@ZRGdAdBeAZSGdCdDZTGdEdFeTeOZUGdGdHeTeNZVGdIdJeTePZWGdKdLeBZXGdMdNe@ZYGdOdPeFe@ZZGdQdReBZ[GdSdTe@Z\GdUdVe@Z]GdWdXZ^GdYdZe_Z`Gd[d\e^eNe`]ZaGd^d_e^eOZbGd`dae^ePZcdS)bN) b64decode b64encode) partialmethodtotal_ordering)forms)apps)settings)checks exceptions validators) connection connectionsrouter) LOOKUP_SEP)DeferredAttributeRegisterLookupMixin)timezone) DictWrapper) parse_dateparse_datetimeparse_duration parse_time)duration_microsecondsduration_string)Promisecached_property)clean_ipv6_address) is_iterable)capfirst) gettext_lazy) AutoFieldBLANK_CHOICE_DASH BigAutoFieldBigIntegerField BinaryField BooleanField CharFieldCommaSeparatedIntegerField DateField DateTimeField DecimalField DurationField EmailFieldEmptyField FilePathField FloatFieldGenericIPAddressFieldIPAddressField IntegerField NOT_PROVIDEDNullBooleanFieldPositiveBigIntegerFieldPositiveIntegerFieldPositiveSmallIntegerField SlugFieldSmallAutoFieldSmallIntegerField TextField TimeFieldURLField UUIDFieldceZdZdS)r.N__name__ __module__ __qualname__FF:\djangOuth\env\Lib\site-packages\django/db/models/fields/__init__.pyr.r.EDrGr.ceZdZdS)r5NrBrFrGrHr5r5IrIrGr5)z ---------c\tj||j|SN)r get_model_meta get_field) app_label model_name field_names rH _load_fieldrTRs% >)Z 0 0 6 @ @ L LLrGc0t}||_|SrM)r. __class__)of_clsnews rH_emptyrYfs ''CCM JrGcdSrMrFrFrGrH return_Noner[ls 4rGcDeZdZdZdZeejZdZ dZ gZ e de de de de d d Z d Zd Zd Zd Zd Zd Zd Zd Zd ZeZdZeeZd d d d d d d d d eddd d d d dd d d dd d fdZfdZdZdZ dZ!e"dZ#dZ$dZ%dNdZ&dZ'dNdZ(dZ)dZ*dNdZ+e,dZ-d Z.d!Z/d"Z0d#Z1d$Z2d%Z3d&Z4d'Z5d(Z6d)Z7d*Z8e,d+Z9e,d,Zd-Z:d.Z;d/Zd2Z?d3Z@d4ZAd5ZBd6ZCd7ZDed8ZEed9ZFed:ZGd;ZHdOd<ZId=ZJd>ZKd?ZLd@ZMdAZNdBZOdOdCZPdDZQdEZRdFZSe,dGZTdeUd dfdHZVdIZWdJZXeeXZYdKZZdPdLZ[dMZ\xZ]S)Qr/zBase class for all field typesTrz&Value %(value)r is not a valid choice.zThis field cannot be null.zThis field cannot be blank.z8%(model_name)s with this %(field_label)s already exists.zH%(field_label)s must be unique for %(date_field_label)s %(lookup_type)s.)invalid_choicenullblankuniqueunique_for_dateN) r`choices db_columneditableerror_messages help_textlimit_choices_to on_delete related_namerelated_query_namer verbose_nameFc>tdd|jjizS)NzField of type: %(field_type)s field_type)_rVrCselfs rH _descriptionzField._descriptions'011 $.15   rGrKrFc||_||_||_||_||c|_|_||c|_|_| |_|jdu|_ | |_ | |_ | |_ | |_ ||_||_t!|t"jjrt)|}||_||_||_||_||_||_||_|r't8j|_t8xjdzc_n&t8j|_t8xjdz c_t)||_||_ dS)N)!namerl _verbose_name primary_key max_length_uniquer`r_ remote_field is_relationdefaultre serializerbunique_for_monthunique_for_year isinstance collectionsabcIteratorlistrcrgdb_indexrd db_comment_db_tablespace auto_createdr/auto_creation_countercreation_counter _validators_error_messages)rqrlrurwrxrar`r_rrelr|rer}rbr~rrcrgrd db_tablespacerr rfrs rH__init__zField.__init__sF4 ()&(2F% %t DI,D8   ". 0. g{7 8 8 $7mmG "  "$+(  ($)$?D !  ' '1 , ' ' '$)$:D !  " "a ' " " ++-rGct|ds tS|j}|jjd|jS)zb Return "app_label.model_label.field_name" for fields attached to models. model.)hasattrsuper__str__rrOlabelru)rqrrVs rHrz Field.__str__sL tW%% %77??$$ $ ++++TYY77rGcz|jjd|jj}t|dd}| d|d|dSd|zS)z1Display the module, class, and name of the field.rruNz<%s>)rVrDrEgetattr)rqpathrus rH__repr__zField.__repr__sV.333T^5P5PQtVT**   !%ttt, ,}rGc *g||||jdi|||jdi|||SNrF)_check_field_name_check_choices_check_db_index_check_db_comment$_check_null_allowed_for_primary_keys_check_backend_specific_checks_check_validators_check_deprecation_detailsrqkwargss rHcheckz Field.checks   # # % %   " "   ! ! # #  $T # - -f - -   6 6 8 8  1T 0 : :6 : :   # # % %   , , . .  rGc |jdrtjd|dgSt|jvr tjdtz|dgS|jdkrtjd|d gSgS) z Check if field name is valid, i.e. 1) does not end with an underscore, 2) does not contain "__" and 3) is not "pk". roz,Field names must not end with an underscore.z fields.E001objidz"Field names must not contain "%s".z fields.E002pkz<'pk' is a reserved word that cannot be used as a field name.z fields.E003)ruendswithr Errorrrps rHrzField._check_field_names 9  c " "  B$ 49 $ $ 8:E$ Y$   R$ IrGcZt|ttfpt| SrM)rstrrr)clsvalues rH_choices_is_valuezField._choices_is_value/s&%#w00J E8J8J4JJrGc@jsgStjrtjtrt jddgSd}jD]} |\}}n#t tf$rYnwxYw tfd|Dsnj |rt|gd|D}n#t tf$rm||}} |r |sYnj 2t|trt|t|}YnwxYwt|trn0j &|j krt jd|zdgSgSt jd d gS) Nz6'choices' must be an iterable (e.g., a list or tuple).z fields.E004rrc3rK|]1\}}|o|V2dSrM)r).0r human_namerqs rH z'Field._check_choices..Is\)z**511Xd6L6LZ6X6XrGc3dK|]+\}}t|tt|V,dSrM)rrlen)rrros rHrz'Field._check_choices..RsP$,E1#-eS#9#9 #E rGzP'max_length' is too small to fit the longest value in 'choices' (%d characters).z fields.E009zT'choices' must be an iterable containing (actual value, human readable name) tuples.z fields.E005) rcrrrr r TypeError ValueErrorallrxmaxrr)rqchoice_max_length choices_group group_name group_choicesrrs` rHrzField._check_choices3sl| I4<(( Jt|S,I,I  L$ !\. . M ,9) MMz*     K-:E?.=.(+-0= ) )%z* K K K$. z--e44D      s0A##A98A9=C%C?D>9D>=D>cH|jdvrtjd|dgSgS)N)NTFz''db_index' must be None, True or False.z fields.E006r)rr rrps rHrzField._check_db_index{s> = 3 3 3 =$ IrGc |jr|sgSg}|D]{}tj||jst|}|jjsEd|jjjvs2| tj |j d|d||S)Nsupports_commentsz3 does not support comments on columns (db_comment).z fields.W163r) rrallow_migrate_modelrrfeaturesrrOrequired_db_featuresappendr Warning display_name)rq databasesrerrorsdbr s rHrzField._check_db_comments i I  B-b$*== $RJ#5 &$**:*OOO N%2111 (  rGcv|jr1|jr*tjjst jdd|dgSgS)Nz%Primary keys must not have null=True.zASet null=False on the field, or remove primary_key=True argument.z fields.E007hintrr)rwr_r r!interprets_empty_strings_as_nullsr rrps rHrz*Field._check_null_allowed_for_primary_keyss^     'I  ;<$  IrGc |gSg}|D]L}tj||jr0|t |jj|fi|M|SrM)rrrextendr validation check_field)rqrrraliass rHrz$Field._check_backend_specific_checksso  I Y YE)%<< Y k%0;GWWPVWWXXX rGc g}t|jD]a\}}t|sM|t jdd|t||db|S)Nz"All 'validators' must be callable.zKvalidators[{i}] ({repr}) isn't a function or instance of a validator class.)ireprz fields.E008r) enumerater callablerr rformatr)rqrr validators rHrzField._check_validatorss%do66  LAyI&&  L<==CV"#%))__>D>> !(       rGc |jptj|jdd|jjz|jd||jddgS|jptj|jdd|jjz|jd||jddgSgS) Nmsgz@%s has been removed except for support in historical migrations.rrz fields.EXXXrz%s has been deprecated.z fields.WXXX)system_check_removed_detailsr rgetrVrCsystem_check_deprecated_detailsrrps rHrz Field._check_deprecation_detailss   , 8 599&(,(?@ :>>vFF8<;RR=AA&II;??mTT    rGcp||jjjkr|||kr|jSddlm}||||SNr)Col)rrOdb_table cached_coldjango.db.models.expressionsr)rqr output_fieldrs rHget_colz Field.get_colsS DJ$- - -  LD$8$8? "444444s5$ ---rGcDddlm}||jjj|Sr)rrrrOr)rqrs rHrzField.cached_cols.444444s4:#,d333rGc ||fS)z Custom format for select clauses. For example, GIS columns need to be selected as AsText(table.col) on MySQL as the table.col data can't be used by Django. rF)rqcompilersqlparamss rH select_formatzField.select_formats F{rGci}iddddddddddddd dd td d d d ddddddddddddddddgdd}dddddd}ddh}|D]v\}}t||||}|dkr.t |t jjrt|}||vr ||kr|||<m||ur|||<w|j j d|j j }| dr| dd }n| d!r| d!d }n| d"r| d"d }nW| d#r| d#d }n+| d$r| d$d }|j|g|fS)%a| Return enough information to recreate the field as a 4-tuple: * The name of the field on the model, if contribute_to_class() has been run. * The import path of the field, including the class, e.g. django.db.models.IntegerField. This should be the most portable version, so less specific may be better. * A list of positional arguments. * A dict of keyword arguments. Note that the positional or keyword arguments must contain values of the following types (including inner values of collection types): * None, bool, str, int, float, complex, set, frozenset, list, tuple, dict * UUID * datetime.datetime (naive), datetime.date * top-level classes, top-level functions - will be referenced by their full import path * Storage instances - these have their own deconstruct() method This is because the values here must be serialized into a text format (possibly new Python code, possibly JSON) and these are the only types with encoding handlers defined. There's no need to return the exact way the field was instantiated this time, just ensure that the resulting field is the same - prefer keyword arguments over positional ones, and omit parameters with their default values. rlNrwFrxrar`r_rr|reTr}rbr~rrcrgrKrdr)rrr rfryrrrvr)rarfr rlrr rzdjango.db.models.fields.relatedzdjango.db.modelszdjango.db.models.fields.fileszdjango.db.models.fields.jsonzdjango.db.models.fields.proxyzdjango.db.models.fields)r5itemsrrrrrIterablerrVrDrE startswithreplaceru) rqkeywords possiblesattr_overridesequals_comparisonrur|rrs rH deconstructzField.deconstructsB D 5  $  e  U  E     |      t    t  t   ! " $# $"!"+   0 /'+-   ' 5&__.. + +MD'D."4"4T4"@"@AAEy  Z{7O%P%P U (((G##%*HTN''%*HTN.333T^5P5PQ ??< = = O<< ACUVVDD __< = = O<< ?ASTTDD __; < < O<< >@RSSDD __< = = O<< ?ASTTDD __6 7 7 O<< 9;MNND 4X..rGcN|\}}}}|j|i|S)z Uses deconstruct() to clone a new copy of this Field. Will not preserve any class attachments/attribute names. )rrV)rqrurargsrs rHclonez Field.clone_s5 $(#3#3#5#5 dD&t~t.v...rGct|tr4|j|jko#t|ddt|ddkStSNr)rr/rrNotImplementedrqothers rH__eq__z Field.__eq__gs^ eU # # /(E,BB/wgtHH..H/ /rGct|tr|j|jks t|ds t|ds|j|jkSt|dt|dkrt|d S|jjj|jjjf|jjj|jjjfkStSr) rr/rrrrOrQrRrrs rH__lt__z Field.__lt__os eU # # %)???tW--@w//@,u/EEEw''75'+B+BBB"41111 (2DJ4D4OPK%/K%0TrGc*t|jSrM)hashrrps rH__hash__zField.__hash__sD)***rGctj|}|jrMtj|j|_t|jdr|jj|ur ||j_||t |<|S)Nfield)copyrzrr r)rqmemodictrs rH __deepcopy__zField.__deepcopy__swioo   -#y):;;C t('22 -t7H7NRV7V7V), & D rGcvt}|j|_|j|_|SrM)r.rV__dict__rrqrs rH__copy__zField.__copy__s0gg }))++  rGct|ds?|j}|ddt|jf|fSt |jjj |jjj |j ffS)z Pickling should return the model._meta.fields instance of the field, not a new copy of that field. So, use the app registry to load the model and then the field back. r _get_defaultN) rrrpoprYrVrTrrOrQ object_nameru)rqstates rH __reduce__zField.__reduce__s tW%% 4 M&&((E IInd + + +DN,e3 3 J  & J  ( I   rGc<|jr|SdS)a  Hook to generate new PK values on save. This method is called when saving instances with no primary key value set. If this method returns something else than None, then the returned value is used when saving the new instance. N)r| get_default)rqinstances rHget_pk_value_on_savezField.get_pk_value_on_saves% < &##%% %trGc|S)z Convert the input value into the expected Python data type, raising django.core.exceptions.ValidationError if the data can't be converted. Return the converted value. Subclasses should override this. rFrqrs rH to_pythonzField.to_pythons  rGci}t|jjD]&}|t |di'||jpi|S)Ndefault_error_messages)reversedrV__mro__updaterr)rqmessagescs rHrfzField.error_messagessf$.011 F FA OOGA'?DD E E E E,2333rGc"g|j|jS)z Some validators can't be created at field initialization time. This method provides a way to delay their creation until required. )default_validatorsrrps rHr zField.validatorss =(<4+;<t j|jddd|i|(|j s!t j|jdd|j s*||jvr#t j|jdddSdS)z Validate value and raise ValidationError if necessary. Subclasses should override this to provide validation logic. Nr^rr,rr_)r,r`) rercr-rrtupler r.rfr_r`)rqrmodel_instance option_key option_value optgroup_keyoptgroup_values rHvalidatezField.validatesG }  F < #T5F(F(F,0L  ( LlT5M::9E##4 n L00"FFF1#j((FF),#$45%'  ==,T-@-HvVVV Vz Yet'888,T-@-IPWXXX X Y Y88rGc||}||||||S)z Convert the value's type and run validation. Validation errors from to_python() and validate() are propagated. Return the correct value if no error is raised. )r!r<r3rqrr7s rHcleanz Field.cleansB u%% e^,,, E""" rGcBt|j|jjdS)Nqn_)rrops quote_namerqr s rHdb_type_parameterszField.db_type_parameters s4=*.*CUKKKrGc||} |j||zS#t$rYdSwxYw)z Return the database column check constraint for this field, for the provided connection. Works the same way as db_type() for the case that get_internal_type() does not map to a preexisting model field. N)rEdata_type_check_constraintsget_internal_typeKeyError)rqr datas rHdb_checkzField.db_checksb &&z22 6t7M7M7O7OPSWW    44 s!9 AAc||} |j|}t|r ||S||zS#t$rYdSwxYw)zk Return the database column data type for this field, for the provided connection. N)rE data_typesrHrrI)rqr rJ column_types rHdb_typez Field.db_types(&&z22 &$/0F0F0H0HIK  $$ )"{4(((% %    44 sA A#"A#c,||S)z Return the data type that a related field pointing to this field should use. For example, this method is called by ForeignKey and OneToOneField to determine its data type. )rOrDs rH rel_db_typezField.rel_db_type=s ||J'''rGc|jj|}|r|||zS||S)z3Return the data type to use in the Cast() function.)rBcast_data_typesrrHrErO)rqr rOs rH cast_db_typezField.cast_db_typeEsZ.044T5K5K5M5MNN  AT44Z@@@ @||J'''rGc`||}||}||dS)z Extension of db_type(), providing a range of different return values (type, checks). This will look at db_type(), allowing custom model fields to override it. )typer)rOrK)rqr type_string check_strings rH db_parameterszField.db_parametersLs; ll:.. }}Z00 !   rGcZ|j|SrM)data_types_suffixrrHrDs rHdb_type_suffixzField.db_type_suffixYs%+//0F0F0H0HIIIrGc6t|dr|jgSgS)N from_db_value)rr^rDs rHget_db_converterszField.get_db_converters\s% 4 ) ) (&' ' rGc|jp|jSrM)ryrwrps rHraz Field.uniqueas|/t//rGc(|jp tjSrM)rr DEFAULT_INDEX_TABLESPACErps rHrzField.db_tablespacees"Gh&GGrGcdS)z Private API intended only to be used by Django itself. Currently only the PostgreSQL backend supports returning multiple fields on a model. FrFrps rH db_returningzField.db_returningis urGc|jp||_|\|_|_|jdu|_|j)|jr$|jdd|_dSdSdS)Nro )ruget_attname_columnattnamecolumnconcreterlr)rqrus rHset_attributes_from_namezField.set_attributes_from_nameqsvI% $($;$;$=$=! dk 4/   $ $ $ 1 1#s ; ;D    % $ $ $rGch||||_|j|||jr)t ||j|||j@d|j z|j vr1t |d|j zt|j |dSdSdS)z Register the field with the model class it belongs to. If private_only is True, create a separate instance of this field for every subclass of cls, even if cls is not an abstract model. )privateNzget_%s_display)r ) rkrrO add_fieldrisetattrrhdescriptor_classrcrurr_get_FIELD_display)rqrru private_onlys rHcontribute_to_classzField.contribute_to_classxs %%d+++  D,777 ; D Ct'<'z$Field._get_default..s 4<rG) rrr|empty_strings_allowedr_r rrr[rrps`rHrzField._get_defaultst      ( %% $|#'''' '* y 'I    rGc |j=t|j}|r%td|jD}|s||z}|S|jj}|p|}tjt|jdr|j j nd |j |}|r |j|}|r|ng fd|DzS)z{ Return choices with a default blank choices included, for use as