q^i;.dZddlZddlZddlZddlmZddlmZddlm Z m Z m Z ddl m Z ddlmZej dZed d Zd ZGd d ej(ZGddZGddZGddZddZdZdZGddZy)z Various data structures used in query construction. Factored out from django.db.models.query to avoid making the main module very large and/or so that they can be used by other modules without getting into circular import difficulties. N) namedtuple) FieldError)DEFAULT_DB_ALIAS DatabaseError connections) LOOKUP_SEP)treedjango.db.modelsPathInfozGfrom_opts to_opts target_fields join_field m2m direct filtered_relationc#hK||jD]}t|Ed{y7wN)__subclasses__ subclassesclssubclasss M/var/www/eb/venv/lib/python3.12/site-packages/django/db/models/query_utils.pyrrs4 I&&((h'''('s &202c|eZdZdZdZdZdZeZdZdddfd Z d Z d Z d Z d Z dZ ddZdZefdZdZxZS)Qze Encapsulate filters as objects that can then be combined logically (using `&` and `|`). ANDORXORTNF) _connector_negatedc`t|g|t|j||y)N)children connectornegated)super__init__sorteditems)selfrrargskwargs __class__s rr z Q.__init__0s3 5t5fV\\^45   ct|dddur t||s|jS|s t|tr|jS|j |}|j |||j |||S)N conditionalF)r)getattr TypeErrorcopy isinstancercreateadd)r#otherconnobjs r_combinez Q._combine7sv 5- /5 8E" "::< E1-99; kkDk) d t r'c:|j||jSr )r3rr#r0s r__or__zQ.__or__Ds}}UDGG,,r'c:|j||jSr )r3rr5s r__and__z Q.__and__G}}UDHH--r'c:|j||jSr )r3rr5s r__xor__z Q.__xor__Jr9r'cF|j}|j|Sr )r,negate)r#r2s r __invert__z Q.__invert__Msiik  r'c\|j|||dd|\}}|j||S)NF) allow_joins split_subqcheck_filterable summarize)_add_q promote_joins)r#queryr@reuserCfor_saveclausejoinss rresolve_expressionzQ.resolve_expressionRsB   #" %  E" r'c#K||jD]@}t|tr|d}t|dr|j Ed{=|By7 w)zg Recursively yield this Q object and all subexpressions, in depth-first order. flattenN)rr-tuplehasattrrN)r#childs rrNz Q.flattenbsV  ]] E%'aui( ==?**   +sAA A Ac Jddlm}m}ddlm}ddlm}ddlm}|d}|jD]-\} } t| ds|| } |j| | d /|j|d d t|jjr)|jt!||d | n|j||j#|} | j%|duS#t&$r!} t(j+d|| Yd} ~ y d} ~ wwxYw)z| Do a database query to check if the expressions of the Q instance matches against the expressions. r) BooleanFieldValue)Coalesce)Query)SINGLENrKF)selectrM_checkT) output_field)usingz.Got a database error calling check() on %r: %s)django.db.modelsrSrTdjango.db.models.functionsrUdjango.db.models.sqlrVdjango.db.models.sql.constantsrWr"rPadd_annotationrfeaturessupports_comparing_boolean_expradd_qr get_compiler execute_sqlrloggerwarning) r#againstr[rSrTrUrVrWrFnamevaluecompileres rcheckzQ.checkqs 97.9d "==? @RSDT]]# >>T\\ )#'>>F< <rKrNrrmrv __classcell__)r&s@rrr#sf C B CGK)-  -.. SX $4: "r'rc$eZdZdZdZddZdZy)DeferredAttributez A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed. c||_yr )field)r#r}s rr zDeferredAttribute.__init__s  r'Nc||S|j}|jj}||vr0|j|}||j |g||S|||<||S)zx Retrieve and caches the value from the datastore on the first lookup. Return the cached value. )fields)__dict__r}attname_check_parent_chainrefresh_from_db)r#instancerdata field_namevals r__get__zDeferredAttribute.__get__s  K  ZZ'' T !**84C{(( (=J$'Z Jr'c|j}|j|jj}|jjr%|j|k7rt ||j Sy)z Check if the field value can be fetched from a parent field already loaded in the instance. This can be done if the to-be fetched field is a primary key field. N)_metaget_ancestor_linkr}model primary_keyr*r)r#ropts link_fields rrz%DeferredAttribute._check_parent_chainsU ~~++DJJ,<,<= :: ! !djjJ&>8Z%7%78 8r'r )rqrprwrxr rrr'rr{r{s  & r'r{ceZdZdZdZdZy)class_or_instance_methodz Hook used in RegisterLookupMixin to return partial functions depending on the caller type (instance or class of models.Field). c ||_||_yr ) class_methodinstance_method)r#rrs rr z!class_or_instance_method.__init__s(.r'c| tj|j|Stj|j|Sr ) functoolspartialrr)r#rowners rrz class_or_instance_method.__get__s:  $$T%6%6> >  !5!5x@@r'N)rqrprwrxr rrr'rrrs /Ar'rceZdZdZej ddZdZeeeZ e eZdZ dZ e dZe d Zdd Zdd ZeeeZe eZdd Zdd ZeeeZe eZy)RegisterLookupMixincB|jj|dSr ) get_lookupsget)r# lookup_names r _get_lookupzRegisterLookupMixin._get_lookups!%%k488r'N)maxsizectj|Dcgc]}|jjdi }}|j |Scc}wN class_lookups)inspectgetmrorr merge_dicts)rparentrs rget_class_lookupsz%RegisterLookupMixin.get_class_lookupssQDK>>RUCV 9?FOO   4  }-- s#AcP|j}t|ddx}ri||S|SNinstance_lookups)rr*)r#rrs rget_instance_lookupsz(RegisterLookupMixin.get_instance_lookupss=..0 &t-?F F  F8m8'78 8r'cddlm}|j|}|'t|dr|jj |S| t ||sy|S)Nr)LookuprZ)django.db.models.lookupsrrrPrZ get_lookup issubclass)r#rrfounds rrzRegisterLookupMixin.get_lookupsQ3  - =WT>:$$// < <  Zv%> r'cddlm}|j|}|'t|dr|jj |S| t ||sy|S)Nr) TransformrZ)rrrrPrZ get_transformr)r#rrrs rrz!RegisterLookupMixin.get_transformsQ6  - =WT>:$$22;? ?  Zy%A r'cLi}t|D]}|j||S)z Merge dicts in reverse to preference the order of the original list. e.g., merge_dicts([a, b]) will preference the keys in 'a' over those in 'b'. )reversedupdate)dictsmergedds rrzRegisterLookupMixin.merge_dictss- % A MM!   r'cXt|D]}|jjyr )rr cache_clearrs r_clear_cached_class_lookupsz/RegisterLookupMixin._clear_cached_class_lookupss'"3 5H  & & 2 2 4 5r'c| |j}d|jvri|_||j|<|j|Sr)rrrrrlookuprs rregister_class_lookupz)RegisterLookupMixin.register_class_lookup sH   ,,K #,, . "C )/+& '') r'cj| |j}d|jvri|_||j|<|Sr)rrrr#rrs rregister_instance_lookupz,RegisterLookupMixin.register_instance_lookups<   ,,K T]] 2$&D !-3k* r'cZ| |j}|j|=|jy)zn Remove given lookup from cls lookups. For use in tests only as it's not thread-safe. N)rrrrs r_unregister_class_lookupz,RegisterLookupMixin._unregister_class_lookup"s/   ,,K   k * '')r'c:| |j}|j|=y)zs Remove given lookup from instance lookups. For use in tests only as it's not thread-safe. N)rrrs r_unregister_instance_lookupz/RegisterLookupMixin._unregister_instance_lookup,s#   ,,K  ! !+ .r'r )rqrprwrr lru_cacherrrr classmethodrr staticmethodrrrrregister_lookuprr_unregister_lookuprr'rrrs9Y&.'.  ++<>RSK#$5655/7O((=>*/2 "= ++CDr'rc^|jsy|jjr|sy|r&|r|j|vry|s|j|vry|s |jry|rN|rL|j|vr>||vr:t d|j jjd|jdy)af Return True if this field should be used to descend deeper for select_related() purposes. Used by both the query construction code (compiler.get_related_selections()) and the model instance creation code (compiler.klass_info). Arguments: * field - the field to be checked * restricted - a boolean field, indicating if the field list has been manually restricted using a requested clause) * requested - The select_related() dictionary. * select_mask - the dictionary of selected fields. * reverse - boolean, True if we are checking a reverse select related FzField rozM cannot be both deferred and traversed using select_related at the same time.T) remote_field parent_linkrelated_query_namerinullrrr object_name)r} restricted requested select_maskreverses rselect_related_descendr;s    %%g u//1B5::Y6 %**  JJ) #  $U[[&&2231UZZLAL L   r'ctdt|dzD]4}tj|d|}|j |s-|||dfcSy)z Check if the lookup_parts contains references to the given annotations set. Because the LOOKUP_SEP is contained in the default annotation names, check each prefix of the lookup_parts for a match. rMrN)Nr)rangelenrjoinr) lookup_parts annotationsnlevel_n_lookups rrefs_expressionrbs\ 1c,'!+ ,4#a):; ??> *!<#33 34 r'cxfd}||xs+t|ddxr||jjS)z Check that self.model is compatible with target_opts. Compatibility is OK if: 1) model and opts match (where proxy inheritance is removed) 2) model is parent of opts' model or the other way around cjj|jk(xs:|jjjvxs|jvSr )rconcrete_modelget_parent_list)rrs rrmz-check_rel_lookup_compatibility..checkwsV KK & &$*=*= = /""ekk&A&A&CC /,,.. r'rF)r*rr)r target_optsr}rms` rcheck_rel_lookup_compatibilityros<   }e,Iu{{7H7H1Ir'c>eZdZdZeddZdZdZdZdZ y) FilteredRelationz7Specify custom filtering in the ON clause of SQL joins. conditionc|s td||_d|_t|ts td||_g|_y)Nzrelation_name cannot be empty.z*condition argument must be a Q() instance.) ValueError relation_namealiasr-rrru)r#rrs rr zFilteredRelation.__init__sD=> >* )Q'IJ J" r'ct||jstS|j|jk(xr4|j|jk(xr|j |j k(Sr )r-r&NotImplementedrrrr5s r__eq__zFilteredRelation.__eq__sY%0! !   %"5"5 5 2 ekk) 2%//1 r'ct|j|j}|j|_|jdd|_|S)Nr)rrrrru)r#clones rrzFilteredRelation.clones7 !3!3t~~Njj YYq\  r'ctd)zz QuerySet.annotate() only accepts expression-like arguments (with a resolve_expression() method). z0FilteredRelation.resolve_expression() is unused.)NotImplementedError)r#r$r%s rrKz#FilteredRelation.resolve_expressions ""TUUr'c|j}|j|jt|j}|j |S)N)rG)rFbuild_filtered_relation_qrsetrucompile)r#rk connectionrFwheres ras_sqlzFilteredRelation.as_sqls=//c$))n/U&&r'N) rqrprwrxrr rrrKrrr'rrrs$A343  V'r'r)F)rxrrlogging collectionsrdjango.core.exceptionsr django.dbrrrdjango.db.models.constantsr django.utilsr getLoggerrfr rNoderr{rrrrrrrr'rrs"-BB1   - . M  ( u" u"p&&R A A dEdEN$N :''''r'