a Eb-@sdZddlZddlZddlZddlmZddlmZddlm Z ddl m Z eddZ d d Z Gd d d e jZGd ddZGdddZdddZddZddZGdddZdS)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) LOOKUP_SEP)treePathInfozGfrom_opts to_opts target_fields join_field m2m direct filtered_relationccs&|V|D]}t|EdHqdSN)__subclasses__ subclassesclssubclassr \/home/ja/django-apps/lartica_env/lib/python3.9/site-packages/django/db/models/query_utils.pyr s r csjeZdZdZdZdZeZdZdddfdd 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)super__init__sorteditems)selfrrargskwargs __class__r rr,s z Q.__init__cCst|ts"t|dddus"t||sBt|dr8|St|St|trp|sp|\}}}t||i|St|}||_| ||| |||S)N conditionalFTcopy) isinstancergetattr TypeErrorhasattrr! deconstructtyperadd)rotherconn_rrobjr r r_combine3s   z Q._combinecCs|||jSr)r-rrr)r r r__or__CszQ.__or__cCs|||jSr)r-rr.r r r__and__Fsz Q.__and__cCs$t|}|||j||Sr)r'r(rnegate)rr,r r r __invert__Is z Q.__invert__cCs&|j|||ddd\}}|||S)NF) allow_joinsZ split_subqZcheck_filterable)Z_add_qZ promote_joins)rqueryr3reuseZ summarizeZfor_saveZclauseZjoinsr r rresolve_expressionOs  zQ.resolve_expressioncCsfd|jj|jjf}|dr*|dd}t|j}i}|j|jkrN|j|d<|j r\d|d<|||fS)Nz%s.%szdjango.db.models.query_utilszdjango.db.modelsrTr) r __module____name__ startswithreplacetuplerrdefaultr)rpathrrr r rr&^s     z Q.deconstruct)NTNFF)r8r7 __qualname____doc__rrr<r rr-r/r0r2r6r& __classcell__r r rrr 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)rrBr r rrqszDeferredAttribute.__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__rBattname_check_parent_chainZrefresh_from_db)rinstancer data field_namevalr r r__get__ts 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_linkrBmodel primary_keyr#rE)rrGoptsZ link_fieldr r rrFs  z%DeferredAttribute._check_parent_chain)N)r8r7r>r?rrKrFr r r rrAks rAc@steZdZeddZeejddddZddZd d Z e d d Z ed dZ edddZ edddZdS)RegisterLookupMixincCs||dSr) get_lookupsget)r lookup_namer r r _get_lookupszRegisterLookupMixin._get_lookupN)maxsizecCsddt|D}||S)NcSsg|]}|jdiqS) class_lookups)rDrR).0parentr r r sz3RegisterLookupMixin.get_lookups..)inspectgetmro merge_dicts)r rVr r rrQszRegisterLookupMixin.get_lookupscCsNddlm}||}|dur4t|dr4|j|S|durJt||sJdS|S)Nr)Lookup output_field)django.db.models.lookupsr]rTr%r^ get_lookup issubclass)rrSr]foundr r rr`s   zRegisterLookupMixin.get_lookupcCsNddlm}||}|dur4t|dr4|j|S|durJt||sJdS|S)Nr) Transformr^)r_rcrTr%r^ get_transformra)rrSrcrbr r rrds   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)Zdictsmergeddr r rr\s  zRegisterLookupMixin.merge_dictscCst|D]}|jqdSr)r rQ cache_clearr r r r_clear_cached_lookupss z)RegisterLookupMixin._clear_cached_lookupscCs4|dur|j}d|jvri|_||j|<||S)NrV)rSrDrVrjr lookuprSr r rregister_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)rSrVrkr r r_unregister_lookupsz&RegisterLookupMixin._unregister_lookup)N)N)r8r7r> classmethodrT functools lru_cacherQr`rd staticmethodr\rjrmrnr r r rrPs        rPFcCs|js dS|jjr|sdS|rD|r2||vr2dS|sD|j|vrDdS|sR|jrRdS|r|j|vr|r|j|vrd|jjj|jf}t |dS)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) Z remote_fieldZ parent_linkZrelated_query_namenamenullrErMrLZ object_namer)rBZ restricted requestedZ load_fieldsreversemsgr r rselect_related_descends&   rxcCsVtdt|dD]>}t|d|}||vr||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. rN)Fr )rangelenrjoin)Z lookup_parts annotationsnZlevel_n_lookupr r rrefs_expressions 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)rLZconcrete_modelZget_parent_list)rOrMr rchecks  z-check_rel_lookup_compatibility..checkrNF)r#rMrL)rMZ target_optsrBrr rrcheck_rel_lookup_compatibility s 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"rrr=)rrrr r rr,s zFilteredRelation.__init__cCs4t||jstS|j|jko2|j|jko2|j|jkSr)r"rNotImplementedrrrr.r r r__eq__6s    zFilteredRelation.__eq__cCs,t|j|jd}|j|_|jdd|_|S)Nr)rrrrr=)rcloner r rr?szFilteredRelation.clonecOs tddS)zz QuerySet.annotate() only accepts expression-like arguments (with a resolve_expression() method). z0FilteredRelation.resolve_expression() is unused.N)NotImplementedError)rrrr r rr6Esz#FilteredRelation.resolve_expressioncCs&|j}|j|jt|jd}||S)N)r5)r4Zbuild_filtered_relation_qrsetr=compile)rcompiler connectionr4wherer r ras_sqlLszFilteredRelation.as_sqlN) r8r7r>r?rrrrr6rr r r rr)s   r)F)r?r!rprZ collectionsrZdjango.core.exceptionsrZdjango.db.models.constantsrZ django.utilsrrr NoderrArPrxrrrr r r rs&    K)F %