k"gddlZddlZddlZddlZddlZddlZddlmZmZddl m Z ddl m Z m Z ddlmZddlmZddlmZddlmZmZmZdd lmZmZmZdd lmZdd lmZm Z dd l!m"Z"dd l#m$Z$ddl%m&Z&m'Z'm(Z(m)Z)ddl*m+Z+ddl,m-Z-m.Z.m/Z/m0Z0ddl1m2Z2m3Z3ddl4m5Z5m6Z6ddl7m8Z8ddl9m:Z:ddl;mGddZ?GddZ@dgZAdZBdZCdZDe Gdd e ZEGd!d"eEZFGd#d$eEZGGd%d&eGZHd'ZId(ZJGd)d*ZKGd+d,eKeEZLGd-d.eLZMGd/d0eEZNGd1d2eEZOGd3d4eGZPGd5d6eEZQGd7d8eEZRGd9d:eEZSGd;deSZUGd?d@eEZVGdAdBeEZWGdCdDeFZXGdEdFZYGdGdHeYeTZZGdIdJeYeSZ[GdKdLeYeUZ\GdMdNeGZ]GdOdPeEZ^GdQdReKeEZ_GdSdTeGZ`GdUdVeEZaGdWdXeEZbGdYdZZcGd[d\edZeGd]d^eceSee_ZfGd`daeceTZgGdbdceceUZhy)dN) b64decode b64encode)Iterable) partialmethodtotal_ordering)forms)apps)settings)checks exceptions validators) connection connectionsrouter) LOOKUP_SEP)DeferredAttributeRegisterLookupMixinNotSupportedError)timezone)BlankChoiceIteratorCallableChoiceIteratorflatten_choicesnormalize_choices) DictWrapper) parse_dateparse_datetimeparse_duration parse_time)duration_microsecondsduration_string)Promisecached_property)clean_ipv6_address)capfirst) gettext_lazy) AutoFieldBLANK_CHOICE_DASH BigAutoFieldBigIntegerField BinaryField BooleanField CharFieldCommaSeparatedIntegerField DateField DateTimeField DecimalField DurationField EmailFieldEmptyField FilePathField FloatFieldGenericIPAddressFieldIPAddressField IntegerField NOT_PROVIDEDNullBooleanFieldPositiveBigIntegerFieldPositiveIntegerFieldPositiveSmallIntegerField SlugFieldSmallAutoFieldSmallIntegerField TextField TimeFieldURLField UUIDFieldc eZdZy)r4N__name__ __module__ __qualname__Y/var/www/html/djangosite/lib/python3.12/site-packages/django/db/models/fields/__init__.pyr4r4KrMr4c eZdZy)r;NrHrLrMrNr;r;OrOrMr;)z ---------c`tj||jj|SN)r get_model_meta get_field) app_label model_name field_names rN _load_fieldrZXs$ >>)Z 0 6 6 @ @ LLrMc(t}||_|SrS)r4 __class__)of_clsnews rN_emptyr_ls 'CCM JrMcyrSrLrLrMrN return_Nonerars rMc@eZdZdZdZeejZdZ 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%dSdZ&dZ'dSdZ(dZ)dSdZ*dZ+dZ,dSdZ-ed Z.e.j^d!Z.e0d"Z1d#Z2d$Z3d%Z4d&Z5d'Z6d(Z7d)Z8d*Z9d+Z:d,Z;d-Zd1Z?d2Z@d3ZAd4ZBd5ZCd6ZDd7ZEd8ZFd9ZGd:ZHe0d;ZIed<ZJed=ZKd>ZLdTd?ZMd@ZNdAZOdBZPdCZQdDZRdEZSdTdFZTdGZUdHZVdIZWe0dJZXe0dKZYdeZd dfdLZ[dMZ\edNZ]dOZ^dUdPZ_dQZ`dRZaxZbS)Vr5zBase 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) rfchoices db_columneditableerror_messages help_textlimit_choices_to on_delete related_namerelated_query_namer verbose_nameFcJtdd|jjizS)NzField of type: %(field_type)s field_type)_r\rIselfs rN _descriptionzField._descriptions)01 $..115   rMrQrLc\||_||_||_||_||c|_|_||c|_|_| |_|jdu|_ | |_ ||_ | |_ | |_ | |_||_||_||_||_||_||_||_||_||_|r/t0j2|_t0xj2dzc_n.t0j4|_t0xj4dz c_t7||_||_y)N)namerr _verbose_name primary_key max_length_uniquerfre remote_field is_relationdefault db_defaultrk serializerhunique_for_monthunique_for_yearrirmdb_indexrj db_comment_db_tablespace auto_createdr5auto_creation_countercreation_counterlist _validators_error_messages)rwrrr{r}r~rgrfrerrelrrkrrhrrrirmrj db_tablespacerr rlrrs rN__init__zField.__init__s6 ()&(2F% %t DI,,D8 $  ". 0. "  "$+( $)$?$?D !  ' '1 , '$)$:$:D !  " "a ' " +-rMct|dst| S|j}|jj d|j S)zb Return "app_label.model_label.field_name" for fields attached to models. model.)hasattrsuper__str__rrUlabelr{)rwrr\s rNrz Field.__str__s> tW%7?$ $ ++++TYY77rMc|jjd|jj}t|dd}| d|d|dSd|zS)z1Display the module, class, and name of the field.rr{Nz<%s>)r\rJrKgetattr)rwpathr{s rN__repr__zField.__repr__sI..33T^^5P5PQtVT*  !%t, ,}rMc 2g|j|j|jdi||j|jdi||j |j di||j|jSNrL) _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_detailsrwkwargss rNcheckz Field.check s   # # %   "  $T # # -f -   ! ! #  $T # # -f -   6 6 8  1T 0 0 :6 :   # # %   , , .  rMc>|jgS|jjdrtjd|dgSt|jvr tjdtz|dgS|jdk(rtjd|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". ruz,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 Errorrrvs rNrzField._check_field_names 99 I 99  c " B$ 499 $ 8:E$ YY$  R$ IrMcTt|ttfxst|t SrS) isinstancestrr"r)clsvalues rN_choices_is_valuezField._choices_is_value9s"%#w0S 5(8S4SSrMc2jsgStjtrtjtrt j ddgSd}jD]T} |\}} tfd|Dsnpj|rt|gd|D}t|tsTn:j+|jkDrt j d|zdgSgSt j d d gS#t tf$rY+wxYw#t tf$r]||}}j|rj|sYgj%t|trt|t|}YwxYw) NzV'choices' must be a mapping (e.g. a dictionary) or an iterable (e.g. a list or tuple).z fields.E004rrc3lK|]+\}}j|xrj|-ywrS)r).0r human_namerws rN z'Field._check_choices..Ts;)z**51Xd6L6LZ6XXs14c3XK|]"\}}t|tr t|$ywrS)rrlen)rrrus rNrz'Field._check_choices..]s*$,E1#-eS#9!$E s(*zP'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) rirrrr r TypeError ValueErrorallr~maxrr)rwchoice_max_length choices_group group_name group_choicesrrs` rNrzField._check_choices=s||I$,,1Z c5R .$  !\\. M ,9) M K-:??.=(+-0= )%*--G. J*/@4??/RLL8:KL ( I LLX    [z*  (z* K$. z--e4DD> !(     rMc .|j~tj|jjdd|jj z|jjd||jjddgS|j ~tj|j jdd|jj z|j jd||j 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 rgetr\rIsystem_check_deprecated_detailsrrvs rNrz Field._check_deprecation_detailss  , , 8 5599&(,(?(?@ ::>>vF88<>;R;RR==AA&I;;??mT    rMc||jjjk(r|||k(r |jSddlm}||||SNr)Col)rrUdb_table cached_colrr)rwr output_fieldrs rNget_colz Field.get_colsC DJJ$$-- -  LD$8?? "45$ --rMc|jSrS)_choicesrvs rNriz Field.choices!s }}rMc$t||_yrS)rrrwrs rNriz Field.choices%s)%0 rMc\ddlm}||jjj|Sr)rrrrUr)rwrs rNrzField.cached_col)s"44::##,,d33rMc ||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. rL)rwcompilersqlparamss rN select_formatzField.select_format/s F{rMci}iddddddddddddd dd td td d dd dddddddddddddddgdd}dddddd}ddh}|jD]W\}}t||j||}t |t r |j }||vr ||k7sH|||<N||usS|||<Y|jjd|jj}|jdr|jdd }n|jd!r|jd!d }n|jd"r|jd"d }nk|jd#r|jd#d }nG|jd$r|jd$d }n#|jd%r|jd%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. rrNr}Fr~rgrfrerrrrkTrrhrrrirmrQrj)rrrr rlrrrr|r)rgrlr rrrr 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) r;itemsrrrrfuncr\rJrK startswithreplacer{) rwkeywords possiblesattr_overridesequals_comparisonr{rrrs rN deconstructzField.deconstruct7ssB D 5  $  e  U  E     |  ,      t    t  t ! " # $!!"- 2 /'+-  ' 5&__. +MD'D."4"4T4"@AE%!78 ((G#%*HTN'%*HTN +..33T^^5P5PQ ??< =<< ACUVD __< =<< ?ASTD __@ A<< CEWXD __; <<< >@RSD __< =<< ?ASTD __6 7<< 9;MND 4X..rMcP|j\}}}}|j|i|S)z Uses deconstruct() to clone a new copy of this Field. Will not preserve any class attachments/attribute names. )r r\)rwr{rargsrs rNclonez Field.clones1 $(#3#3#5 dD&t~~t.v..rMct|tr6|j|jk(xrt|ddt|ddk(StSNr)rr5rrNotImplementedrwothers rN__eq__z Field.__eq__sS eU #((E,B,BB/wgtH.H/ /rMct|tr|j|jk7st|ds%t|ds|j|jkSt|dt|dk7r t|d S|jj j |jj jf|jj j |jj jfkStSr) rr5rrrrUrWrXrrs rN__lt__z Field.__lt__s eU #%%)?)??tW-w/,,u/E/EEEw'75'+BB"4111 ((22DJJ4D4D4O4OPKK%%//KK%%00TrMc,t|jSrS)hashrrvs rN__hash__zField.__hash__sD))**rMc*tj|}|jrctj|j|_t|jdr)|jj|ur||j_||t |<|S)Nfield)copyrrrr)rwmemodictrs rN __deepcopy__zField.__deepcopy__sviio   #yy):):;C t(('2t7H7H7N7NRV7V),  & D rMczt}|j|_|jj|_|SrS)r4r\__dict__rrwrs rN__copy__zField.__copy__s/g }}))+  rMc<t|ds@|jj}|jddt|j f|fSt |jjj|jjj|jffS)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) rr!rpopr_r\rZrrUrW object_namer{)rwstates rN __reduce__zField.__reduce__s tW% MM&&(E IInd +DNN,e3 3 JJ   & & JJ   ( ( II   rMc<|jr|jSy)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)rwinstances rNget_pk_value_on_savezField.get_pk_value_on_saves <<##% %rMc|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. rLrs rN to_pythonzField.to_pythons  rMci}t|jjD]}|jt |di |j|j xsi|S)Ndefault_error_messages)reversedr\__mro__updaterr)rwmessagescs rNrlzField.error_messagessY$..001 FA OOGA'?D E F,,23rMc6g|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_validatorsrrvs rNr zField.validatorss =((<4+;+;<AB99B>c |jsy|jy||jvrk|jD]5\}}t|tt fr|D] \}}||k(s y/||k(s5yt j|jddd|i|0|js$t j|jdd|js3||jvr$t j|jddyy)z Validate value and raise ValidationError if necessary. Subclasses should override this to provide validation logic. Nrdrr:rre)r:rf) rkrir;rrtupler r<rlrerf)rwrmodel_instance option_key option_value optgroup_keyoptgroup_values rNvalidatezField.validates }}  << #T5F5F(F,0LL ( LlT5M:9E#4 n L0"#j( ,,##$45%'  =,,T-@-@-HvV Vzzet'8'88,,T-@-@-IPWX X9zrMcn|j|}|j|||j||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/rJrArwrrEs rNcleanz Field.clean8s3 u% e^, E" rMcXt|j|jjdS)Nqn_)rr!ops quote_namerwrs rNdb_type_parameterszField.db_type_parametersCs4==*..*C*CUKKrMc|j|} |j|j|zS#t$rYywxYw)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)rSdata_type_check_constraintsget_internal_typeKeyError)rwrdatas rNdb_checkzField.db_checkFsO &&z2 66t7M7M7OPSWW   s 3 ??c|j|} |j|j}t|r||S||zS#t$rYywxYw)zk Return the database column data type for this field, for the provided connection. N)rS data_typesrVrrW)rwrrX column_types rNdb_typez Field.db_typeTsf(&&z2 &$//0F0F0HIK  $"4((% %   sA AAc$|j|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]rRs rN rel_db_typezField.rel_db_typess ||J''rMc|jjj|j}|r||j |zS|j |S)z3Return the data type to use in the Cast() function.)rPcast_data_typesrrVrSr])rwrr]s rN cast_db_typezField.cast_db_type{sM..0044T5K5K5MN T44Z@@ @||J''rMcP|j|}|j|}||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]rY)rwr type_string check_strings rN db_parameterszField.db_parameterss0 ll:. }}Z0 !  rMcT|jj|jSrS)data_types_suffixrrVrRs rNdb_type_suffixzField.db_type_suffixs"++//0F0F0HIIrMc8t|dr |jgSgS)N from_db_value)rrlrRs rNget_db_converterszField.get_db_converterss 4 )&&' ' rMc6|jxs |jSrS)rr}rvs rNrgz Field.uniques||/t///rMc>|jxstjSrS)rr DEFAULT_INDEX_TABLESPACErvs rNrzField.db_tablespaces""Gh&G&GGrMc^|jtuxrtjjS)z6Private API intended only to be used by Django itself.)rr;rrcan_return_columns_from_insertrvs rN db_returningzField.db_returnings* OO< / C##BB rMc|jxs||_|j\|_|_|jdu|_|j /|jr"|jj dd|_yyy)Nru )r{get_attname_columnattnamecolumnconcreterrr)rwr{s rNset_attributes_from_namezField.set_attributes_from_nameslII% $($;$;$=! dk 4/    $ $ 1 1#s ;D *3 $rMc|j|||_|jj|||jr&t ||j |j||jLd|jz|jvr0t |d|jzt|j|yyy)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) rzrrU add_fieldrxsetattrrwdescriptor_classrir{r!r_get_FIELD_display)rwrr{ private_onlys rNcontribute_to_classzField.contribute_to_classs %%d+  D,7 ;; Ct'<'z$Field._get_default..s 4<<rMr)DatabaseDefaultc,jS)N)r)r)rrwsrNrz$Field._get_default..s?++$rM)rrrrr;rrempty_strings_allowedrerrrrar)rwrs`@rNr%zField._get_defaultsp     %||#' ' ??, . D  **yy''II  rMcd|j}|turt|dsddlm}|||}|S)Nresolve_expressionrr)rr;rrr)rwrrs rNrzField._db_default_expressions7__ \ )' ,3  ;z40JrMc|j$|rt|j|S|jS|jj}|xs|j }t j t|jdr$|jjjnd}|jj|}|r|j|}|r|ng|Dcgc]}||t|fc}zScc}w)z{ Return choices with a default blank choices included, for use as