a Lcf;@sdZddlZddlZddlZddlmZddlmZddlm Z m Z m Z ddl m Z ddlmZedZed d Zd d ZGd ddejZGdddZGdddZGdddZdddZddZddZGdddZdS)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_relationccs&|V|D]}t|EdHqdSN)__subclasses__ subclassesclssubclassrY/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/django/db/models/query_utils.pyr s r cseZdZdZdZdZdZeZdZdddfd d Z d d Z d dZ ddZ ddZ ddZdddZddZefddZddZZS)Qze Encapsulate filters as objects that can then be combined logically (using `&` and `|`). ANDORXORTNF) _connector_negatedcs&tjg|t|||ddS)N)children connectornegated)super__init__sorteditems)selfrrargskwargs __class__rrr0s z Q.__init__cCsbt|dddurt||s$|S|s:t|tr:|S|j|d}|||||||S)N conditionalF)r)getattr TypeErrorcopy isinstancercreateadd)r otherconnobjrrr_combine7s   z Q._combinecCs|||jSr )r/rr r,rrr__or__DszQ.__or__cCs|||jSr )r/rr0rrr__and__Gsz Q.__and__cCs|||jSr )r/rr0rrr__xor__Jsz Q.__xor__cCs|}||Sr )r(negate)r r.rrr __invert__Msz Q.__invert__cCs(|j|||dd|d\}}|||S)NF) allow_joinsZ split_subqZcheck_filterable summarize)Z_add_qZ promote_joins)r queryr6reuser7Zfor_saveZclauseZjoinsrrrresolve_expressionRs  zQ.resolve_expressionccsH|V|jD]6}t|tr"|d}t|dr<|EdHq |Vq dS)zg Recursively yield this Q object and all subexpressions, in depth-first order. flattenN)rr)tuplehasattrr<)r childrrrr<bs   z Q.flattenc Cs ddlm}m}ddlm}ddlm}ddlm}|d}| D]*\} } t | ds^|| } |j | | dd qD| |d d t |j jr|t||d |d n |||j|d} z| |duWSty} ztd|| WYd} ~ d Sd} ~ 00dS)z| Do a database query to check if the expressions of the Q instance matches against the expressions. r) BooleanFieldValue)Coalesce)Query)SINGLENr:F)selectr;_checkT) output_field)usingz.Got a database error calling check() on %r: %s)Zdjango.db.modelsr@rAZdjango.db.models.functionsrBZdjango.db.models.sqlrCZdjango.db.models.sql.constantsrDrr>Zadd_annotationrfeaturesZsupports_comparing_boolean_exprZadd_qrZ get_compilerZ execute_sqlrloggerwarning) r ZagainstrHr@rArBrCrDr8namevaluecompilererrrcheckqs&       zQ.checkcCsfd|jj|jjf}|dr*|dd}t|j}i}|j|jkrN|j|d<|j r\d|d<|||fS)Nz%s.%szdjango.db.models.query_utilsr rTr) r$ __module____name__ startswithreplacer=rrdefaultr)r pathr!r"rrr deconstructs     z Q.deconstruct)NTNFF)rRrQ __qualname____doc__rrrrUr%rr/r1r2r3r5r:r<rrPrW __classcell__rrr#rr#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)r r\rrrrszDeferredAttribute.__init__NcCsT|dur |S|j}|jj}||vrL||}|durD|j|gdn|||<||S)zx Retrieve and caches the value from the datastore on the first lookup. Return the cached value. N)fields)__dict__r\attname_check_parent_chainZrefresh_from_db)r instancerdata field_namevalrrr__get__s zDeferredAttribute.__get__cCs6|j}||jj}|jjr2|j|kr2t||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)_metaZget_ancestor_linkr\model primary_keyr&r_)r raoptsZ link_fieldrrrr`s  z%DeferredAttribute._check_parent_chain)N)rRrQrXrYrrer`rrrrr[s r[c@s eZdZdZddZddZdS)class_or_instance_methodz Hook used in RegisterLookupMixin to return partial functions depending on the caller type (instance or class of models.Field). cCs||_||_dSr ) class_methodinstance_method)r rkrlrrrrsz!class_or_instance_method.__init__cCs$|durt|j|St|j|Sr ) functoolspartialrkrl)r raownerrrrresz class_or_instance_method.__get__N)rRrQrXrYrrerrrrrjsrjc@seZdZddZejddddZddZeeeZ e eZd d Z d d Z e d dZe ddZdddZdddZeeeZe eZdddZdddZeeeZe eZdS)RegisterLookupMixincCs||dSr ) get_lookupsget)r lookup_namerrr _get_lookupszRegisterLookupMixin._get_lookupN)maxsizecCsddt|D}||S)NcSsg|]}|jdiqS) class_lookups)r^rr).0parentrrr sz9RegisterLookupMixin.get_class_lookups..)inspectgetmro merge_dicts)rrvrrrget_class_lookupssz%RegisterLookupMixin.get_class_lookupscCs(|}t|dd}r$i||S|SNinstance_lookups)r}r&)r rvrrrrget_instance_lookupss z(RegisterLookupMixin.get_instance_lookupscCsNddlm}||}|dur4t|dr4|j|S|durJt||sJdS|S)Nr)LookuprG)django.db.models.lookupsrrtr>rG get_lookup issubclass)r rsrfoundrrrrs   zRegisterLookupMixin.get_lookupcCsNddlm}||}|dur4t|dr4|j|S|durJt||sJdS|S)Nr) TransformrG)rrrtr>rG get_transformr)r rsrrrrrrs   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)Zdictsmergeddrrrr|s  zRegisterLookupMixin.merge_dictscCst|D]}|jqdSr )r r} cache_clearrrrr_clear_cached_class_lookupss z/RegisterLookupMixin._clear_cached_class_lookupscCs4|dur|j}d|jvri|_||j|<||S)Nrv)rsr^rvrrlookuprsrrrregister_class_lookup s  z)RegisterLookupMixin.register_class_lookupcCs,|dur|j}d|jvri|_||j|<|Sr~)rsr^rr rrsrrrregister_instance_lookups   z,RegisterLookupMixin.register_instance_lookupcCs"|dur|j}|j|=|dS)zn Remove given lookup from cls lookups. For use in tests only as it's not thread-safe. N)rsrvrrrrr_unregister_class_lookup"sz,RegisterLookupMixin._unregister_class_lookupcCs|dur|j}|j|=dS)zs Remove given lookup from instance lookups. For use in tests only as it's not thread-safe. N)rsrrrrr_unregister_instance_lookup,sz/RegisterLookupMixin._unregister_instance_lookup)N)N)N)N)rRrQrXrtrm lru_cacher}rrjrq classmethodrr staticmethodr|rrrZregister_lookuprrZ_unregister_lookuprrrrrps0         rpFcCs|js dS|jjr|sdS|rD|r2||vr2dS|sD|j|vrDdS|sR|jrRdS|r|r|j|vr||vrtd|jjjd|jddS)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 .zM cannot be both deferred and traversed using select_related at the same time.T) Z remote_fieldZ parent_linkZrelated_query_namerLnullrrgrfZ object_name)r\Z restricted requestedZ select_maskreverserrrselect_related_descend;s.  rcCsLtdt|dD]4}t|d|}||r|||dfSqdS)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. r;rN)Nr)rangelenrjoinrr)Z lookup_parts annotationsnZlevel_n_lookuprrrrefs_expressionbs  rcs,fdd}||p*t|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 )rfZconcrete_modelZget_parent_list)rirgrrrPws  z-check_rel_lookup_compatibility..checkrhF)r&rgrf)rgZ target_optsr\rPrrrcheck_rel_lookup_compatibilityos rc@s@eZdZdZedddZddZddZd d Zd d Z d S)FilteredRelationz7Specify custom filtering in the ON clause of SQL joins. conditioncCs:|s td||_d|_t|ts*td||_g|_dS)Nzrelation_name cannot be empty.z*condition argument must be a Q() instance.) ValueError relation_namealiasr)rrrV)r rrrrrrs zFilteredRelation.__init__cCs4t||jstS|j|jko2|j|jko2|j|jkSr )r)r$NotImplementedrrrr0rrr__eq__s    zFilteredRelation.__eq__cCs,t|j|jd}|j|_|jdd|_|S)Nr)rrrrrV)r clonerrrrszFilteredRelation.clonecOs tddS)zz QuerySet.annotate() only accepts expression-like arguments (with a resolve_expression() method). z0FilteredRelation.resolve_expression() is unused.N)NotImplementedError)r r!r"rrrr:sz#FilteredRelation.resolve_expressioncCs&|j}|j|jt|jd}||S)N)r9)r8Zbuild_filtered_relation_qrsetrVcompile)r rN connectionr8whererrras_sqlszFilteredRelation.as_sqlN) rRrQrXrYrrrrr:rrrrrrs   r)F)rYrmrzlogging collectionsrZdjango.core.exceptionsrZ django.dbrrrZdjango.db.models.constantsrZ django.utilsr getLoggerrJr r Noderr[rjrprrrrrrrrs,     x)g '