af!~pddlZddlZddlZddlZddlZddlZddlmZmZddl m Z m Z ddl m Z ddlmZddlmZddlmZmZmZddlmZmZmZdd lmZdd lmZmZdd lm Z dd l!m"Z"m#Z#m$Z$m%Z%dd l&m'Z'ddl(m)Z)m*Z*m+Z+m,Z,ddl-m.Z.m/Z/ddl0m1Z1m2Z2ddl3m4Z4ddl5m6Z6ddl7m8Z8ddl9m:Z;gdZ<GddZ=GddZ>dgZ?dZ@dZAdZBe GddeZCGd d!eCZDGd"d#eCZEGd$d%eEZFd&ZGd'ZHGd(d)ZIGd*d+eIeCZJGd,d-eJZKGd.d/eCZLGd0d1eCZMGd2d3eEZNGd4d5eCZOGd6d7eCZPGd8d9eCZQGd:d;eQZRGd<d=eQZSGd>d?eCZTGd@dAeCZUGdBdCeDZVGdDdEZWGdFdGeWeRZXGdHdIeWeQZYGdJdKeWeSZZGdLdMeEZ[GdNdOeCZ\GdPdQeIeCZ]GdRdSeEZ^GdTdUeCZ_GdVdWeCZ`GdXdYZaGdZd[ebZcGd\d]eaeQec^ZdGd_d`eaeRZeGdadbeaeSZfdS)cN) b64decode b64encode) partialmethodtotal_ordering)forms)apps)settings)checks exceptions validators) connection connectionsrouter) LOOKUP_SEP)DeferredAttributeRegisterLookupMixin)timezone)BlankChoiceIteratorCallableChoiceIteratorflatten_choicesnormalize_choices) 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)r2N__name__ __module__ __qualname__R/var/www/html/env/lib/python3.11/site-packages/django/db/models/fields/__init__.pyr2r2JDrKr2ceZdZdS)r9NrFrJrKrLr9r9NrMrKr9)z ---------c\tj||j|SN)r get_model_meta get_field) app_label model_name field_names rL _load_fieldrXWs% >)Z 0 0 6 @ @ L LLrKc0t}||_|SrQ)r2 __class__)of_clsnews rL_emptyr]ks ''CCM JrKcdSrQrJrJrKrL return_Noner_qs 4rKceZdZdZdZeejZdZ dZ gZ e de de de de d d Z d Zd 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 efdZfdZdZ dZ!dZ"e#dZ$dZ%dQdZ&dZ'dQdZ(dZ)dQdZ*dZ+dZ,dQdZ-ed Z.e.j/d!Z.e0d"Z1d#Z2d$Z3d%Z4d&Z5d'Z6d(Z7d)Z8d*Z9d+Z:d,Z;d-Zd1Z?d2Z@d3ZAd4ZBd5ZCd6ZDd7ZEd8ZFd9ZGd:ZHed;ZIed<ZJed=ZKd>ZLdRd?ZMd@ZNdAZOdBZPdCZQdDZRdEZSdRdFZTdGZUdHZVdIZWe0dJZXdeYd dfdKZZdLZ[edMZ\dNZ]dSdOZ^dPZ_xZ`S)Tr3zBase 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) rdchoices 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)_rZrGselfs rL _descriptionzField._descriptions'011 $.15   rKrOrJc||_||_||_||_||c|_|_||c|_|_| |_|jdu|_ | |_ |tur!t|dsddl m}||}||_| |_| |_| |_||_||_||_||_||_||_||_||_||_|r't8j|_t8xjdzc_n&t8j|_t8xjdz c_t?||_ ||_!dS)Nresolve_expressionrValue)"namerp _verbose_name primary_key max_length_uniquerdrc remote_field is_relationdefaultr9hasattrdjango.db.models.expressionsrz db_defaultri serializerfunique_for_monthunique_for_yearrgrkdb_indexrh db_comment_db_tablespace auto_createdr3auto_creation_countercreation_counterlist _validators_error_messages)rurpr|r~rrerdrcrrelrrirrfrrrgrkrh db_tablespacerr rjrrrzs rL__init__zField.__init__sn6 ()&(2F% %t DI,D8 \ ) )' ,3 3 ) ; : : : : :z**J$  ". 0. "  "$+(  ($)$?D !  ' '1 , ' ' '$)$:D !  " "a ' " " ++-rKct|ds tS|j}|jjd|jS)zb Return "app_label.model_label.field_name" for fields attached to models. model.)rsuper__str__rrSlabelr|)rurrZs rLrz Field.__str__sL tW%% %77??$$ $ ++++TYY77rKcz|jjd|jj}t|dd}| d|d|dSd|zS)z1Display the module, class, and name of the field.rr|Nz<%s>)rZrHrIgetattr)rupathr|s rL__repr__zField.__repr__sV.333T^5P5PQtVT**   !%ttt, ,}rKc Dg|||jdi|||jdi|||jdi|||SNrJ) _check_field_name_check_choices_check_db_default_check_db_index_check_db_comment$_check_null_allowed_for_primary_keys_check_backend_specific_checks_check_validators_check_deprecation_detailsrukwargss rLcheckz Field.checks   # # % %   " "  $T # - -f - -   ! ! # #  $T # - -f - -   6 6 8 8  1T 0 : :6 : :   # # % %   , , . .  rKc|jgS|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". Nrsz,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)r|endswithr Errorrrts rLrzField._check_field_names 9 I 9  c " "  B$ 49 $ $ 8:E$ Y$   R$ IrKcZt|ttfpt| SrQ) isinstancestrrr")clsvalues rL_choices_is_valuezField._choices_is_value>s&%#w00J E8J8J4JJrKc@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) NzV'choices' must be a mapping (e.g. a dictionary) or an iterable (e.g. a list or tuple).z fields.E004rrc3rK|]1\}}|o|V2dSrQ)r).0r human_namerus rL z'Field._check_choices..Ys\)z**511Xd6L6LZ6X6XrKc3dK|]+\}}t|tt|V,dSrQ)rrlen)rrrss rLrz'Field._check_choices..bsP$,E1#-eS#9#9 #E rKzP'max_length' is too small to fit the longest value in 'choices' (%d characters).z fields.E009z'choices' must be a mapping of actual values to human readable names or an iterable containing (actual value, human readable name) tuples.z fields.E005) rgr"rrr r TypeError ValueErrorallrmaxrr)ruchoice_max_length choices_group group_name group_choicesrrs` rLrzField._check_choicesBso| I4<(( Jt|S,I,I  .$  !\. . M ,9) MMz*     K-:E?.=.(+-0= ) )%z* K K K$. z--e44D9D>=D>c ddlm}|jtust |j|s|gSg}|D]}t j||jst|}t|jdds@|j j r4|jd}| tj||d|j j sGd|jjjvs4|jd }| tj||d |S) Nrryallowed_defaultFz cannot be used in db_default.z fields.E012rsupports_expression_defaultszH does not support default database values with expressions (db_default).z fields.E011)rrzrr9rrallow_migrate_modelrrrfeaturesrappendr rrSrequired_db_features display_name)ru databasesrrzerrorsdbr msgs rLrzField._check_db_defaultsG666666 O| + +$/511 , I M MB-b$*== $RJ4?,=uEE M#@ MHHH fl3D]KKKLLL#@ M1:#899".<<< fl3D]KKKLLL rKcH|jdvrtjd|dgSgS)N)NTFz''db_index' must be None, True or False.z fields.E006r)rr rrts rLrzField._check_db_indexs> = 3 3 3 =$ IrKc |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) rrrrrrrrSrrr Warningr)rurrrrr s rLrzField._check_db_comments i I  B-b$*== $RJ#5 &$**:*OOO N%2111 (  rKcv|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)r~rcr r!interprets_empty_strings_as_nullsr rrts rLrz*Field._check_null_allowed_for_primary_keyss^     'I  ;<$  IrKc |gSg}|D]L}tj||jr0|t |jj|fi|M|SrQ)rrrextendr validation check_field)rurrraliass rLrz$Field._check_backend_specific_checksso  I Y YE)%<< Y k%0;GWWPVWWXXX rKc 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)rurr validators rLrzField._check_validatorss%do66  LAyI&&  L<==CV"#%))__>D>> !(       rKc |jptj|jdd|jjz|jd||jddgS|jptj|jdd|jjz|jd||jddgSgS) Nrz@%s has been removed except for support in historical migrations.rrz fields.EXXXrz%s has been deprecated.z fields.WXXX)system_check_removed_detailsr rgetrZrGsystem_check_deprecated_detailsrrts rLrz Field._check_deprecation_detailss   , 8 599&(,(?@ :>>vFF8<;RR=AA&II;??mTT    rKcp||jjjkr|||kr|jSddlm}||||SNr)Col)rrSdb_table cached_colrr)rur output_fieldrs rLget_colz Field.get_colsS DJ$- - -  LD$8$8? "444444s5$ ---rKc|jSrQ)_choicesrts rLrgz Field.choices&s }rKc.t||_dSrQ)rrrurs rLrgz Field.choices*s)%00 rKcDddlm}||jjj|Sr)rrrrSr)rurs rLrzField.cached_col.s.444444s4:#,d333rKc ||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. rJ)rucompilersqlparamss rL select_formatzField.select_format4s F{rKci}iddddddddddddd dd td td d dd dddddddddddddddgdd}dddddd}ddh}|D]^\}}t||||}t |t r|j}||vr ||kr|||<U||ur|||<_|jjd|jj }| dr| dd }n| d!r| d!d }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. rpNr~FrrerdrcrrrriTrrfrrrgrkrOrh)rrrr rjrrrr}r)rerjr rprr rzdjango.db.models.fields.relatedzdjango.db.modelszdjango.db.models.fields.filesz!django.db.models.fields.generatedzdjango.db.models.fields.jsonzdjango.db.models.fields.proxyzdjango.db.models.fields) r9itemsrrrrfuncrZrHrI startswithreplacer|) rukeywords possiblesattr_overridesequals_comparisonr|rrrs rL deconstructzField.deconstruct<sB D 5  $  e  U  E     |  ,      t    t  t ! " # $!!"-   2 /'+-   ' 5&__.. + +MD'D."4"4T4"@"@AAE%!788 # (((G##%*HTN''%*HTN.333T^5P5PQ ??< = = O<< ACUVVDD __< = = O<< ?ASTTDD __@ A A O<< CEWXXDD __; < < O<< >@RSSDD __< = = O<< ?ASTTDD __6 7 7 O<< 9;MNND 4X..rKcN|\}}}}|j|i|S)z Uses deconstruct() to clone a new copy of this Field. Will not preserve any class attachments/attribute names. )r rZ)rur|rargsrs rLclonez Field.clones5 $(#3#3#5#5 dD&t~t.v...rKct|tr4|j|jko#t|ddt|ddkStSNr)rr3rrNotImplementedruothers rL__eq__z Field.__eq__s^ eU # # /(E,BB/wgtHH..H/ /rKct|tr|j|jks t|ds t|ds|j|jkSt|dt|dkrt|d S|jjj|jjjf|jjj|jjjfkStSr) rr3rrrrSrUrVrrs rL__lt__z Field.__lt__s eU # # %)???tW--@w//@,u/EEEw''75'+B+BBB"41111 (2DJ4D4OPK%/K%0TrKc*t|jSrQ)hashrrts rL__hash__zField.__hash__sD)***rKctj|}|jrMtj|j|_t|jdr|jj|ur ||j_||t |<|S)Nfield)copyrrrr)rumemodictrs rL __deepcopy__zField.__deepcopy__swioo   -#y):;;C t('22 -t7H7NRV7V7V), & D rKcvt}|j|_|j|_|SrQ)r2rZ__dict__rrurs rL__copy__zField.__copy__s0gg }))++  rKct|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) rrrpopr]rZrXrrSrU object_namer|)rustates rL __reduce__zField.__reduce__s tW%% 4 M&&((E IInd + + +DN,e3 3 J  & J  ( I   rKc<|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)ruinstances rLget_pk_value_on_savezField.get_pk_value_on_saves% < &##%% %trKc|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. rJrs rL to_pythonzField.to_pythons  rKci}t|jjD]&}|t |di'||jpi|S)Ndefault_error_messages)reversedrZ__mro__updaterr)rumessagescs rLrjzField.error_messagessf$.011 F FA OOGA'?DD E E E E,2333rKc"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_validatorsrrts rLr 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. Nrbrr8rrc)r8rd) rirgr9rrtupler r:rjrcrd)rurmodel_instance option_key option_value optgroup_keyoptgroup_values rLvalidatezField.validatesG }  F < #T5F(F(F,0L  ( LlT5M::9E##4 n L00"FFF1#j((FF),#$45%'  ==,T-@-HvVVV Vz Yet'888,T-@-IPWXXX X Y Y88rKc||}||||||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-rHr?rurrCs rLcleanz Field.clean=sB u%% e^,,, E""" rKcBt|j|jjdS)Nqn_)rrops quote_namerur s rLdb_type_parameterszField.db_type_parametersHs4=*.*CUKKKrKc||} |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)rQdata_type_check_constraintsget_internal_typeKeyError)rur datas rLdb_checkzField.db_checkKsb &&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)rQ data_typesrTrrU)rur rV column_types rLdb_typez Field.db_typeYs(&&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. )r[rPs rL rel_db_typezField.rel_db_typexs ||J'''rKc|jj|}|r|||zS||S)z3Return the data type to use in the Cast() function.)rNcast_data_typesrrTrQr[)rur r[s rL cast_db_typezField.cast_db_typesZ.044T5K5K5M5MNN  AT44Z@@@ @||J'''rKc`||}||}||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)r[rW)rur type_string check_strings rL db_parameterszField.db_parameterss; ll:.. }}Z00 !   rKcZ|j|SrQ)data_types_suffixrrTrPs rLdb_type_suffixzField.db_type_suffixs%+//0F0F0H0HIIIrKc6t|dr|jgSgS)N from_db_value)rrjrPs rLget_db_converterszField.get_db_converterss% 4 ) ) (&' ' rKc|jp|jSrQ)rr~rts rLrez Field.uniques|/t//rKc(|jp tjSrQ)rr DEFAULT_INDEX_TABLESPACErts rLrzField.db_tablespaces"Gh&GGrKc@|jtuotjjS)z6Private API intended only to be used by Django itself.)rr9r rcan_return_columns_from_insertrts rL db_returningzField.db_returnings" O< / C#B rKc|jp||_|\|_|_|jdu|_|j)|jr$|jdd|_dSdSdS)Nrs )r|get_attname_columnattnamecolumnconcreterpr)rur|s rLset_attributes_from_namezField.set_attributes_from_namesvI% $($;$;$=$=! dk 4/   $ $ $ 1 1#s ; ;D    % $ $ $rKch||||_|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) rxrrS add_fieldrvsetattrrudescriptor_classrgr|rr_get_FIELD_display)rurr| private_onlys rLcontribute_to_classzField.contribute_to_classs %%d+++  D,777 ; D Ct'<'z$Field._get_default.. s 4<rKrr)rrrrr9rrempty_strings_allowedrcr rrr_r)rurs` rLr#zField._get_defaults      ( %% $|#'''' ' ?, . . D D D D D D" "* y 'I    rKc|j|rt|j|S|jS|jj}|p|}t jt|jdr|jj nd|j |}|r |j |}|r|ngfd|DzS)z{ Return choices with a default blank choices included, for use as