o uvXj/@sdZddlZddlZddlZddlmZddlmZddlm Z eddZ Gdd d e Z d d Z Gd d d ZGddde jZGdddZGdddZdddZddZddZGdddZdS)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) LOOKUP_SEP)treePathInfozGfrom_opts to_opts target_fields join_field m2m direct filtered_relationc@seZdZdZdS) InvalidQueryz?The query passed to raw() isn't a safe query to use with raw().N)__name__ __module__ __qualname____doc__r r Y/var/www/html/myproject/venv/lib/python3.10/site-packages/django/db/models/query_utils.pyrsrccs(|V|D] }t|EdHqdSN)__subclasses__ subclassesclssubclassr r r rs  rc@s&eZdZdZdZddZdddZdS) QueryWrapperz A type that indicates the contents are an SQL fragment and the associate parameters. Can be used to pass opaque data to a where-clause, for example. FcCs|t|f|_dSr )listdata)selfsqlparamsr r r __init__(szQueryWrapper.__init__NcCs|jSr )r)rcompiler connectionr r r as_sql+szQueryWrapper.as_sql)NN)rrr r contains_aggregaterrr r r r r!s rcsjeZdZdZdZdZeZdZdddfdd Zd d Z d d Z ddZ ddZ dddZ ddZZS)Qze Encapsulate filters as objects that can then be combined logically (using `&` and `|`). ANDORTNF) _connector_negatedcs&tjg|t|||ddS)N)children connectornegated)superrsorteditems)rr!r"argskwargs __class__r r r:s&z Q.__init__cCsZt|ts t||st|S|st|St|}||_|||||||Sr ) isinstancer TypeErrorcopydeepcopytyper$add)rotherconnobjr r r _combine=s      z Q._combinecC|||jSr )r6r rr3r r r __or__NzQ.__or__cCr7r )r6rr8r r r __and__Qr:z Q.__and__cCs$t|}|||j||Sr )r1r2rnegate)rr5r r r __invert__Ts z Q.__invert__cCs$|j|||dd\}}|||S)NF) allow_joins split_subq)_add_q promote_joins)rqueryr>reuse summarizefor_saveclausejoinsr r r resolve_expressionZs zQ.resolve_expressioncCsd|jj|jjf}|dr|dd}di}}t|jdkr7t|jdts7|jd}|d|di}nt |j}|j |j krGd|j i}|j rNd|d <|||fS) Nz%s.%szdjango.db.models.query_utilszdjango.db.modelsr rr!Tr") r,rr startswithreplacelenr#r-rtupler$defaultr%)rpathr)r*childr r r deconstructas        z Q.deconstruct)NTNFF)rrr r rr rN conditionalrr6r9r;r=rHrQ __classcell__r r r+r r/s rc@s*eZdZdZddZd ddZddZdS) DeferredAttributez A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed. cCs ||_dSr ) field_name)rrUr r r rws zDeferredAttribute.__init__NcCsj|dur|S|j}||j||ur0|||j}|dur+|j|jgdt||j}|||j<||jS)zx Retrieve and caches the value from the datastore on the first lookup. Return the cached value. N)fields)__dict__getrU_check_parent_chainrefresh_from_dbgetattr)rinstancerrvalr r r __get__zs   zDeferredAttribute.__get__cCs:|j}||}||j}|jr||krt||jSdS)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)_meta get_fieldget_ancestor_linkmodel primary_keyr[attname)rr\nameoptsf link_fieldr r r rYs    z%DeferredAttribute._check_parent_chainr )rrr r rr^rYr r r r rTrs   rTc@steZdZeddZeejddddZddZd d Z e d d Z ed dZ edddZ edddZdS)RegisterLookupMixincCs||dSr ) get_lookupsrX)r lookup_namer r r _get_lookupszRegisterLookupMixin._get_lookupN)maxsizecCsddt|D}||S)NcSsg|] }|jdiqS) class_lookups)rWrX).0parentr r r sz3RegisterLookupMixin.get_lookups..)inspectgetmro merge_dicts)rrnr r r rjs zRegisterLookupMixin.get_lookupscCNddlm}||}|durt|dr|j|S|dur%t||s%dS|S)Nr)Lookup output_field)django.db.models.lookupsrvrlhasattrrw get_lookup issubclass)rrkrvfoundr r r rz   zRegisterLookupMixin.get_lookupcCru)Nr) Transformrw)rxr~rlryrw get_transformr{)rrkr~r|r r r rr}z!RegisterLookupMixin.get_transformcCs i}t|D]}||q|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)dictsmergeddr r r rts  zRegisterLookupMixin.merge_dictscCst|D]}|jqdSr )rrj cache_clearrr r r _clear_cached_lookupss  z)RegisterLookupMixin._clear_cached_lookupscCs4|dur|j}d|jvri|_||j|<||S)Nrn)rkrWrnrrlookuprkr r r register_lookups  z#RegisterLookupMixin.register_lookupcCs|dur|j}|j|=dS)zn Remove given lookup from cls lookups. For use in tests only as it's not thread-safe. N)rkrnrr r r _unregister_lookups z&RegisterLookupMixin._unregister_lookupr )rrr classmethodrl functools lru_cacherjrzr staticmethodrtrrrr r r r ris         riFcCs|jsdS|jjr |s dS|r"|r||vrdS|s"|j|vr"dS|s)|jr)dS|rC|j|vrC|rC|j|vrCtd|jjj |jfdS)au Return True if this field should be used to descend deeper for select_related() purposes. Used by both the query construction code (sql.query.fill_related_selections()) and the model instance creation code (query.get_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. * load_fields - the set of fields to be loaded on this model * reverse - boolean, True if we are checking a reverse select related FzXField %s.%s cannot be both deferred and traversed using select_related at the same time.T) remote_field parent_linkrelated_query_namerenullrdrrbr_ object_name)field restricted requested load_fieldsreverser r r select_related_descends$   rcCsVtdt|dD]}t|d|}||vr(||r(||||dfSq dS)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. rIrN)Fr )rangerLrjoin) lookup_parts annotationsnlevel_n_lookupr r r refs_expressions rcs,fdd}||pt|ddo||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 cs*jj|jkp|jjvp|vSr )r_concrete_modelget_parent_list)rfrbr r checks  z-check_rel_lookup_compatibility..checkrcF)r[rbr_)rb target_optsrrr rr check_rel_lookup_compatibilitys rc@s@eZdZdZedddZddZddZd d Zd d Z d S)FilteredRelationz7Specify custom filtering in the ON clause of SQL joins. conditioncCs:|std||_d|_t|tstd||_g|_dS)Nzrelation_name cannot be empty.z*condition argument must be a Q() instance.) ValueError relation_namealiasr-rrrO)rrrr r r r-s  zFilteredRelation.__init__cCs0t||jo|j|jko|j|jko|j|jkSr )r-r,rrrr8r r r __eq__7s    zFilteredRelation.__eq__cCs,t|j|jd}|j|_|jdd|_|S)Nr)rrrrrO)rcloner r r r?szFilteredRelation.clonecOstd)zz QuerySet.annotate() only accepts expression-like arguments (with a resolve_expression() method). z0FilteredRelation.resolve_expression() is unused.)NotImplementedError)rr)r*r r r rHEsz#FilteredRelation.resolve_expressioncCs&|j}|j|jt|jd}||S)N)rC)rBbuild_filtered_relation_qrsetrOcompile)rrrrBwherer r r rLs zFilteredRelation.as_sqlN) rrr r rrrrrHrr r r r r*s  r)F)r r/rrr collectionsrdjango.db.models.constantsr django.utilsrr ExceptionrrrNoderrTrirrrrr r r r s$    C( C$