|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/django/db/models/__pycache__/ |
Upload File : |
o
3�a�0 � @ s� d Z ddlZddlZddlZddlZddlmZ ddlmZm Z ddl
m Z ddl m
Z
ddlmZ edd �ZG d
d � d e�ZG d d
� d
eed�Zdd� ZG dd� de
j�ZG dd� d�ZG dd� d�Zd dd�Zdd� Zd d � Z G d d � d �Z dS )!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��FieldDoesNotExist�
FieldError)�
LOOKUP_SEP)�tree)�RemovedInDjango40Warning�PathInfozGfrom_opts to_opts target_fields join_field m2m direct filtered_relationc s< e Zd Zedd� �Zdd� Z� fdd�Z� fdd�Z� ZS ) �InvalidQueryTypec C s t tfS �Nr ��self� r �>/usr/lib/python3/dist-packages/django/db/models/query_utils.py� _subclasses s z InvalidQueryType._subclassesc C s t jdtdd� d S )Nz\The InvalidQuery exception class is deprecated. Use FieldDoesNotExist or FieldError instead.� )�category�
stacklevel)�warnings�warnr r r r r �__warn s
�zInvalidQueryType.__warnc � | � � t|| j�pt� �|�S r )�_InvalidQueryType__warn�
isinstancer �super�__instancecheck__)r
�instance�� __class__r r r & � z"InvalidQueryType.__instancecheck__c r r )r �
issubclassr r �__subclasscheck__)r
�subclassr r r r! * r z"InvalidQueryType.__subclasscheck__) �__name__�
__module__� __qualname__�propertyr r r r! �
__classcell__r r r r r
s
r
c @ s e Zd ZdS )� InvalidQueryN)r# r$ r% r r r r r( / s r( )� metaclassc c s( � | V | � � D ] }t|�E d H qd S r )�__subclasses__�
subclasses��clsr" r r r r+ 3 s
� �r+ c sj e Zd ZdZdZdZeZdZddd�� fdd �
Zd
d � Z d d
� Z
dd� Z dd� Z ddd�Z
dd� Z� ZS )�Qze
Encapsulate filters as objects that can then be combined logically (using
`&` and `|`).
�AND�ORTNF)�
_connector�_negatedc s& t � jg |�t|�� ��||d� d S )N)�children� connector�negated)r �__init__�sorted�items)r
r1 r2 �args�kwargsr r r r6 D s &z
Q.__init__c C s� t |t�st|dd�du st|��| s!t|d�r |�� S t�|�S t |t�r8|s8| �� \}}}t| �|i |��S t| �� }||_|� | |� |� ||� |S )N� conditionalFT�copy)
r r. �getattr� TypeError�hasattrr< � deconstruct�typer4 �add)r
�other�conn�_r9 r: �objr r r �_combineG s
z
Q._combinec C � | � || j�S r )rG r0 �r
rC r r r �__or__W � zQ.__or__c C rH r )rG r/ rI r r r �__and__Z rK z Q.__and__c C s$ t | �� }|�| | j� |�� |S r )rA rB r/ �negate)r
rF r r r �
__invert__] s
z Q.__invert__c C s& |j | ||ddd�\}}|�|� |S )NF)� allow_joins�
split_subq�check_filterable)�_add_q�
promote_joins)r
�queryrO �reuse� summarize�for_save�clause�joinsr r r �resolve_expressionc s
�
zQ.resolve_expressionc C sf d| j j| j jf }|�d�r|�dd�}t| j�}i }| j| jkr'| j|d< | j r.d|d< |||fS )Nz%s.%sz django.db.models.query_utilszdjango.db.modelsr1 Tr2 )
r r$ r# �
startswith�replace�tupler3 r4 �defaultr5 )r
�pathr9 r: r r r r@ m s
z
Q.deconstruct)NTNFF)r# r$ r% �__doc__r/ r0 r^ r; r6 rG rJ rL rN rZ r@ r' r r r r r. 9 s
r. c @ s* e Zd ZdZdd� Zd dd�Zdd� ZdS )
�DeferredAttributez�
A wrapper for a deferred-loading field. When the value is read from this
object the first time, the query is executed.
c C s
|| _ d S r )�field)r
rb r r r r6 s
zDeferredAttribute.__init__Nc C sZ |du r| S |j }| jj}||vr)| �|�}|du r%|j|gd� || S |||< || S )zx
Retrieve and caches the value from the datastore on the first lookup.
Return the cached value.
N)�fields)�__dict__rb �attname�_check_parent_chain�refresh_from_db)r
r r- �data�
field_name�valr r r �__get__� s
�zDeferredAttribute.__get__c C s6 |j }|�| jj�}| jjr| j|krt||j�S dS )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_ancestor_linkrb �model� primary_keyr= re )r
r �opts�
link_fieldr r r rf � s
z%DeferredAttribute._check_parent_chainr )r# r$ r% r` r6 rk rf r r r r ra z s
ra c @ st e Zd Zedd� �Zeejdd�dd� ��Zdd� Zd d
� Z e
d d � �Z ed
d� �Z eddd��Z
eddd��ZdS )�RegisterLookupMixinc C s | � � �|d �S r )� get_lookups�get)r- � lookup_namer r r � _get_lookup� s z RegisterLookupMixin._get_lookupN)�maxsizec C s dd� t �| �D �}| �|�S )Nc S s g | ] }|j �d i ��qS )�
class_lookups)rd rt )�.0�parentr r r �
<listcomp>� s z3RegisterLookupMixin.get_lookups.<locals>.<listcomp>)�inspect�getmro� merge_dicts)r- rx r r r rs � s
z RegisterLookupMixin.get_lookupsc C �N ddl m} | �|�}|d u rt| d�r| j�|�S |d ur%t||�s%d S |S )Nr )�Lookup� output_field)�django.db.models.lookupsr� rv r? r� �
get_lookupr )r
ru r� �foundr r r r� � �
z RegisterLookupMixin.get_lookupc C r )Nr )� Transformr� )r� r� rv r? r� �
get_transformr )r
ru r� r� r r r r� � r� z!RegisterLookupMixin.get_transformc C s 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'.
)�reversed�update)�dicts�merged�dr r r r~ � s z RegisterLookupMixin.merge_dictsc C s t | �D ]}|j�� qd S r )r+ rs � cache_clearr, r r r �_clear_cached_lookups� s �z)RegisterLookupMixin._clear_cached_lookupsc C s4 |d u r|j }d| jvri | _|| j|< | �� |S )Nrx )ru rd rx r� �r- �lookupru r r r �register_lookup� s
z#RegisterLookupMixin.register_lookupc C s |du r|j }| j|= dS )zn
Remove given lookup from cls lookups. For use in tests only as it's
not thread-safe.
N)ru rx r� r r r �_unregister_lookup� s z&RegisterLookupMixin._unregister_lookupr )r# r$ r% � classmethodrv � functools� lru_cachers r� r� � staticmethodr~ r� r� r� r r r r rr � s
rr Fc C s� | j sdS | j jr
|s
dS |r"|r| �� |vrdS |s"| j|vr"dS |s)| jr)dS |rE| j|vrE|rE| j|v rEd| 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)
� remote_field� parent_link�related_query_name�name�nullre rn rl � object_namer )rb �
restricted� requested� load_fields�reverse�msgr r r �select_related_descend� s&
�r� c C sV t dt| �d �D ] }t�| d|� �}||v r(|| r(|| | |d� f S q 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.
� r N)Fr )�range�lenr �join)� lookup_parts� annotations�n�level_n_lookupr r r �refs_expression
s �r� c s, � fdd�}||�pt |dd�o||jj�S )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
c s* � j j| jkp| j� j �� v p� | �� v S r )rl �concrete_model�get_parent_list)rp �rn r r �check s
�
�z-check_rel_lookup_compatibility.<locals>.checkro F)r= rn rl )rn � target_optsrb r� r r� r � check_rel_lookup_compatibility s �r� c @ s@ e Zd ZdZe� d�dd�Zdd� Zdd� Zd d
� Zd d � Z d
S )�FilteredRelationz7Specify custom filtering in the ON clause of SQL joins.�� conditionc C s: |st d��|| _d | _t|t�st d��|| _g | _d S )Nz relation_name cannot be empty.z*condition argument must be a Q() instance.)�
ValueError�
relation_name�aliasr r. r� r_ )r
r� r� r r r r6 6 s
zFilteredRelation.__init__c C s4 t || j�stS | j|jko| j|jko| j|jkS r )r r �NotImplementedr� r� r� rI r r r �__eq__@ s
�
�zFilteredRelation.__eq__c C s, t | j| jd�}| j|_| jd d � |_|S )Nr� )r� r� r� r� r_ )r
�cloner r r r� I s zFilteredRelation.clonec O s t d��)zz
QuerySet.annotate() only accepts expression-like arguments
(with a resolve_expression() method).
z0FilteredRelation.resolve_expression() is unused.)�NotImplementedError)r
r9 r: r r r rZ O s z#FilteredRelation.resolve_expressionc C s& |j }|j| jt| j�d�}|�|�S )N)rU )rT �build_filtered_relation_qr� �setr_ �compile)r
�compiler�
connectionrT �wherer r r �as_sqlV s
zFilteredRelation.as_sqlN)
r# r$ r% r` r. r6 r� r� rZ r� r r r r r� 3 s
r� )F) r` r< r� r| r � collectionsr �django.core.exceptionsr r �django.db.models.constantsr � django.utilsr �django.utils.deprecationr r rA r
� Exceptionr( r+ �Noder. ra rr r� r� r� r� r r r r �<module> s*
A(
C%