SL,h~ddlZddlZddlZddlZddlZddlZddlmZmZddl 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`eaeRZeGdadbeaeSZfy)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 UUIDFieldc eZdZy)r2N__name__ __module__ __qualname___/var/www/paragaon_website/venv/lib/python3.12/site-packages/django/db/models/fields/__init__.pyr2r2JrKr2c eZdZy)r9NrFrJrKrLr9r9NrMrKr9)z ---------c`tj||jj|SN)r get_model_meta get_field) app_label model_name field_names rL _load_fieldrXWs$ >>)Z 0 6 6 @ @ LLrKc(t}||_|SrQ)r2 __class__)of_clsnews rL_emptyr]ks 'CCM JrKcyrQrJrJrKrL return_Noner_qs rKc: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%dRdZ&dZ'dRdZ(dZ)dRdZ*dZ+dZ,dRdZ-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>ZLdSd?ZMd@ZNdAZOdBZPdCZQdDZRdEZSdSdFZTdGZUdHZVdIZWe0dJZXe0dKZYdeZd dfdLZ[dMZ\edNZ]dOZ^dTdPZ_dQZ`xZaS)Ur3zBase 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_nameFcJtdd|jjizS)NzField of type: %(field_type)s field_type)_rZrGselfs rL _descriptionzField._descriptions)01 $..115   rKrOrJc\||_||_||_||_||c|_|_||c|_|_| |_|jdu|_ | |_ ||_ | |_ | |_ | |_||_||_||_||_||_||_||_||_||_|r/t0j2|_t0xj2dzc_n.t0j4|_t0xj4dz c_t7||_||_y)N)namerp _verbose_name primary_key max_length_uniquerdrc remote_field is_relationdefault db_defaultri serializerfunique_for_monthunique_for_yearrgrkdb_indexrh db_comment_db_tablespace auto_createdr3auto_creation_countercreation_counterlist _validators_error_messages)rurpryr{r|rerdrcrrelrrirrfrrrgrkrh db_tablespacerr rjrrs rL__init__zField.__init__s6 ()&(2F% %t DI,,D8 $  ". 0. "  "$+( $)$?$?D !  ' '1 , '$)$:$:D !  " "a ' " +-rKct|dst| S|j}|jj d|j S)zb Return "app_label.model_label.field_name" for fields attached to models. model.)hasattrsuper__str__rrSlabelry)rurrZs rLrz Field.__str__s> tW%7?$ $ ++++TYY77rKc|jjd|jj}t|dd}| d|d|dSd|zS)z1Display the module, class, and name of the field.rryNz<%s>)rZrHrIgetattr)rupathrys rL__repr__zField.__repr__sI..33T^^5P5PQtVT*  !%t, ,}rKc 2g|j|j|jdi||j|jdi||j |j di||j|jSNrJ) _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.check s   # # %   "  $T # # -f -   ! ! #  $T # # -f -   6 6 8  1T 0 0 :6 :   # # %   , , .  rKc>|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". rsz,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)ryendswithr Errorrrts rLrzField._check_field_names 99 I 99  c " B$ 499 $ 8:E$ YY$  R$ IrKcJt|ttfxs t| SrQ) isinstancestrrr")clsvalues rL_choices_is_valuezField._choices_is_value8s %#w0J E8J4JJrKc(jsgStjrtjtrt 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|-ywrQ)r).0r human_namerus rL z'Field._check_choices..Ss;)z**51Xd6L6LZ6XXs14c3XK|]"\}}t|tr t|$ywrQ)rrlen)rrrss rLrz'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) rgr"rrr r TypeError ValueErrorallr|maxrr)ruchoice_max_length choices_group group_name group_choicesrrs` rLrzField._check_choices<s||I4<<(Jt||S,I .$  !\\. M ,9) M K-:??.=(+-0= )%*--G. J*/@4??/RLL8:KL ( I LLX    [z*  (z* K$. z--e4DD> !(     rKc .|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 rgetrZrGsystem_check_deprecated_detailsrrts rLrz Field._check_deprecation_detailss  , , 8 5599&(,(?(?@ ::>>vF88<>;R;RR==AA&I;;??mT    rKc||jjjk(r|||k(r |jSddlm}||||SNr)Col)rrSdb_table cached_colrr)rur output_fieldrs rLget_colz Field.get_colsC DJJ$$-- -  LD$8?? "45$ --rKc|jSrQ)_choicesrts rLrgz Field.choices s }}rKc$t||_yrQ)rrrurs rLrgz Field.choices$s)%0 rKc\ddlm}||jjj|Sr)rrrrSr)rurs rLrzField.cached_col(s"44::##,,d33rKc ||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_format.s F{rKci}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. rpNr{Fr|rerdrcrrrriTrrfrrrgrkrOrh)rrrr rjr}rrrzr)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 startswithreplacery) rukeywords possiblesattr_overridesequals_comparisonryrrrs rL deconstructzField.deconstruct6ssB 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..rKcP|j\}}}}|j|i|S)z Uses deconstruct() to clone a new copy of this Field. Will not preserve any class attachments/attribute names. )r rZ)ruryrargsrs rLclonez Field.clones1 $(#3#3#5 dD&t~~t.v..rKct|tr6|j|jk(xrt|ddt|ddk(StSNr)rr3rrNotImplementedruothers rL__eq__z Field.__eq__sS eU #((E,B,BB/wgtH.H/ /rKct|tr|j|jk7st|ds%t|ds|j|jkSt|dt|dk7r t|d S|jj j |jj jf|jj j |jj jfkStSr) rr3rrrrSrUrVrrs rL__lt__z Field.__lt__s eU #%%)?)??tW-w/,,u/E/EEEw'75'+BB"4111 ((22DJJ4D4D4O4OPKK%%//KK%%00TrKc,t|jSrQ)hashrrts rL__hash__zField.__hash__sD))**rKc*tj|}|jrctj|j|_t|jdr)|jj|ur||j_||t |<|S)Nfield)copyr~rrr)rumemodictrs rL __deepcopy__zField.__deepcopy__sviio   #yy):):;C t(('2t7H7H7N7NRV7V),  & D rKczt}|j|_|jj|_|SrQ)r2rZ__dict__rrurs rL__copy__zField.__copy__s/g }}))+  rKc<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) rrrpopr]rZrXrrSrU object_namery)rustates rL __reduce__zField.__reduce__s tW% MM&&(E IInd +DNN,e3 3 JJ   & & JJ   ( ( II   rKc<|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)ruinstances rLget_pk_value_on_savezField.get_pk_value_on_saves <<##% %rKc|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]}|jt |di |j|j xsi|S)Ndefault_error_messages)reversedrZ__mro__updaterr)rumessagescs rLrjzField.error_messagessY$..001 FA OOGA'?D E F,,23rKc6g|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+;+;<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. Nrbrr8rrc)r8rd) rirgr9rrtupler r:rjrcrd)rurmodel_instance option_key option_value optgroup_keyoptgroup_values rLvalidatezField.validates }}  << #T5F5F(F,0LL ( LlT5M:9E#4 n L0"#j( ,,##$45%'  =,,T-@-@-HvV Vzzet'8'88,,T-@-@-IPWX X9zrKcn|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-rHr?rurrCs rLcleanz Field.clean7s3 u% e^, E" rKcXt|j|jjdS)Nqn_)rrops quote_namerur s rLdb_type_parameterszField.db_type_parametersBs4==*..*C*CUKKrKc|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)rQdata_type_check_constraintsget_internal_typeKeyError)rur datas rLdb_checkzField.db_checkEsO &&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)rQ data_typesrTrrU)rur rV column_types rLdb_typez Field.db_typeSsf(&&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[rPs rL rel_db_typezField.rel_db_typers ||J''rKc|jjj|j}|r||j |zS|j |S)z3Return the data type to use in the Cast() function.)rNcast_data_typesrrTrQr[)rur r[s rL cast_db_typezField.cast_db_typezsM..0044T5K5K5MN T44Z@@ @||J''rKcP|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[rW)rur type_string check_strings rL db_parameterszField.db_parameterss0 ll:. }}Z0 !  rKcT|jj|jSrQ)data_types_suffixrrTrPs rLdb_type_suffixzField.db_type_suffixs"++//0F0F0HIIrKc8t|dr |jgSgS)N from_db_value)rrjrPs rLget_db_converterszField.get_db_converterss 4 )&&' ' rKc6|jxs |jSrQ)r}r{rts rLrez Field.uniques||/t///rKc>|jxstjSrQ)rr DEFAULT_INDEX_TABLESPACErts rLrzField.db_tablespaces""Gh&G&GGrKc^|jtuxrtjjS)z6Private API intended only to be used by Django itself.)rr9r rcan_return_columns_from_insertrts rL db_returningzField.db_returnings* OO< / C##BB rKc|jxs||_|j\|_|_|jdu|_|j /|jr"|jj dd|_yyy)Nrs )ryget_attname_columnattnamecolumnconcreterpr)rurys rLset_attributes_from_namezField.set_attributes_from_nameslII% $($;$;$=! dk 4/    $ $ 1 1#s ;D *3 $rKc|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) rxrrS add_fieldrvsetattrrudescriptor_classrgryrr_get_FIELD_display)rurry private_onlys rLcontribute_to_classzField.contribute_to_classs %%d+  D,7 ;; Ct'<'z$Field._get_default..s 4<<rKrr)rrrrr9rrempty_strings_allowedrcr rrr_r)rurs` rLr#zField._get_defaultsl     %||#' ' ??, . D" "**yy''II  rKcd|j}|turt|dsddlm}|||}|S)Nresolve_expressionrr)rr9rrr)rurrs rLrzField._db_default_expressions7__ \ )' ,3  ;z40JrKc|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