3
W­E^«/  ã               @   sÊ   d Z ddlZddlZddlZddlmZ ddlmZ ddlm	Z	 eddƒZ
G dd	„ d	eƒZd
d„ ZG dd„ dƒZG dd„ de	jƒZG dd„ dƒZG dd„ dƒZddd„Zdd„ Zdd„ ZG dd„ dƒZdS )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)ÚtreeÚPathInfozGfrom_opts to_opts target_fields join_field m2m direct filtered_relationc               @   s   e Zd ZdZdS )ÚInvalidQueryz?The query passed to raw() isn't a safe query to use with raw().N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__© r   r   ú>/tmp/pip-build-78s3knkw/Django/django/db/models/query_utils.pyr      s   r   c             c   s*   | V  x| j ƒ D ]}t|ƒE d H  qW d S )N)Ú__subclasses__Ú
subclasses)ÚclsÚsubclassr   r   r   r      s    r   c               @   s&   e Zd ZdZdZdd„ Zddd„ZdS )	Ú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.
    Fc             C   s   |t |ƒf| _d S )N)ÚlistÚdata)ÚselfZsqlÚparamsr   r   r   Ú__init__(   s    zQueryWrapper.__init__Nc             C   s   | j S )N)r   )r   ÚcompilerÚ
connectionr   r   r   Úas_sql+   s    zQueryWrapper.as_sql)NN)r   r   r	   r
   Zcontains_aggregater   r   r   r   r   r   r   !   s   r   c                   sj   e Zd ZdZdZdZeZdZdddœ‡ fdd	„
Zd
d„ Z	dd„ Z
dd„ Zdd„ Zddd„Zdd„ Z‡  ZS )ÚQze
    Encapsulate filters as objects that can then be combined logically (using
    `&` and `|`).
    ÚANDÚORTNF)Ú
_connectorÚ_negatedc               s"   t ƒ j|t|jƒ ƒ•||d� d S )N)ÚchildrenÚ	connectorÚnegated)Úsuperr   ÚsortedÚitems)r   r   r   ÚargsÚkwargs)Ú	__class__r   r   r   :   s    z
Q.__init__c             C   sZ   t |tƒst|ƒ‚|s tj| ƒS | s.tj|ƒS t| ƒƒ }||_|j| |ƒ |j||ƒ |S )N)Ú
isinstancer   Ú	TypeErrorÚcopyÚdeepcopyÚtyper    Úadd)r   ÚotherÚconnÚobjr   r   r   Ú_combine=   s    



z
Q._combinec             C   s   | j || jƒS )N)r1   r   )r   r.   r   r   r   Ú__or__N   s    zQ.__or__c             C   s   | j || jƒS )N)r1   r   )r   r.   r   r   r   Ú__and__Q   s    z	Q.__and__c             C   s$   t | ƒƒ }|j| | jƒ |jƒ  |S )N)r,   r-   r   Únegate)r   r0   r   r   r   Ú
__invert__T   s    
zQ.__invert__c             C   s&   |j | ||ddd�\}}|j|ƒ |S )NF)Úallow_joinsZ
split_subqZcheck_filterable)Z_add_qZpromote_joins)r   Úqueryr6   ÚreuseZ	summarizeZfor_saveZclauseZjoinsr   r   r   Úresolve_expressionZ   s
    
zQ.resolve_expressionc             C   s¨   d| j j| j jf }|jdƒr*|jddƒ}f i  }}t| jƒdkrpt| jd tƒ rp| jd }|d |d i}n t	| jƒ}| j
| jkr�d| j
i}| jržd|d< |||fS )	Nz%s.%szdjango.db.models.query_utilszdjango.db.modelsé   r   r   Tr   )r'   r   r   Ú
startswithÚreplaceÚlenr   r(   r   Útupler    Údefaultr!   )r   Úpathr%   r&   Úchildr   r   r   Údeconstructd   s    

 


zQ.deconstruct)NTNFF)r   r   r	   r
   r   r   r?   Zconditionalr   r1   r2   r3   r5   r9   rB   Ú__classcell__r   r   )r'   r   r   /   s   

r   c               @   s*   e Zd ZdZdd„ Zd	dd„Zdd„ ZdS )
Ú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 )N)Úfield)r   rE   r   r   r   r   z   s    zDeferredAttribute.__init__Nc             C   sd   |dkr| S |j }| jj}|j|| ƒ| kr\| j|ƒ}|dkrT|j|gd� t||ƒ}|||< || S )zx
        Retrieve and caches the value from the datastore on the first lookup.
        Return the cached value.
        N)Úfields)Ú__dict__rE   ÚattnameÚgetÚ_check_parent_chainZrefresh_from_dbÚgetattr)r   Úinstancer   r   Ú
field_nameÚvalr   r   r   Ú__get__}   s    

zDeferredAttribute.__get__c             C   s6   |j }|j| jjƒ}| jjr2| j|kr2t||jƒS dS )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)Ú_metaZget_ancestor_linkrE   ÚmodelÚprimary_keyrK   rH   )r   rL   ÚoptsZ
link_fieldr   r   r   rJ   �   s
    z%DeferredAttribute._check_parent_chain)N)r   r   r	   r
   r   rO   rJ   r   r   r   r   rD   u   s   
rD   c               @   st   e Zd Zedd„ ƒZeejdd�dd„ ƒƒZdd„ Zd	d
„ Z	e
dd„ ƒZedd„ ƒZeddd„ƒZeddd„ƒZdS )ÚRegisterLookupMixinc             C   s   | j ƒ j|d ƒS )N)Úget_lookupsrI   )r   Úlookup_namer   r   r   Ú_get_lookupŸ   s    zRegisterLookupMixin._get_lookupN)Úmaxsizec             C   s   dd„ t j| ƒD ƒ}| j|ƒS )Nc             S   s   g | ]}|j jd i ƒ‘qS )Úclass_lookups)rG   rI   )Ú.0Úparentr   r   r   ú
<listcomp>¦   s    z3RegisterLookupMixin.get_lookups.<locals>.<listcomp>)ÚinspectÚgetmroÚmerge_dicts)r   rY   r   r   r   rU   £   s    zRegisterLookupMixin.get_lookupsc             C   sP   ddl m} | j|ƒ}|d kr4t| dƒr4| jj|ƒS |d k	rLt||ƒ rLd S |S )Nr   )ÚLookupÚoutput_field)Údjango.db.models.lookupsr`   rW   Úhasattrra   Ú
get_lookupÚ
issubclass)r   rV   r`   Úfoundr   r   r   rd   ©   s    
zRegisterLookupMixin.get_lookupc             C   sP   ddl m} | j|ƒ}|d kr4t| dƒr4| jj|ƒS |d k	rLt||ƒ rLd S |S )Nr   )Ú	Transformra   )rb   rg   rW   rc   ra   Úget_transformre   )r   rV   rg   rf   r   r   r   rh   ²   s    
z!RegisterLookupMixin.get_transformc             C   s$   i }xt | ƒD ]}|j|ƒ qW |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)ZdictsZmergedÚdr   r   r   r_   »   s    zRegisterLookupMixin.merge_dictsc             C   s    xt | ƒD ]}|jjƒ  q
W d S )N)r   rU   Úcache_clear)r   r   r   r   r   Ú_clear_cached_lookupsÆ   s    z)RegisterLookupMixin._clear_cached_lookupsc             C   s4   |d kr|j }d| jkri | _|| j|< | jƒ  |S )NrY   )rV   rG   rY   rm   )r   ÚlookuprV   r   r   r   Úregister_lookupË   s    

z#RegisterLookupMixin.register_lookupc             C   s   |dkr|j }| j|= dS )zn
        Remove given lookup from cls lookups. For use in tests only as it's
        not thread-safe.
        N)rV   rY   )r   rn   rV   r   r   r   Ú_unregister_lookupÕ   s    z&RegisterLookupMixin._unregister_lookup)N)N)r   r   r	   ÚclassmethodrW   Ú	functoolsÚ	lru_cacherU   rd   rh   Ústaticmethodr_   rm   ro   rp   r   r   r   r   rT   �   s   			rT   Fc             C   s�   | j s
dS | j jr| rdS |rH|r4| jƒ |kr4dS | rH| j|krHdS | rX| jrXdS |rŒ| j|krŒ|rŒ| j|krŒtd| jjj	| jf ƒ‚dS )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_linkZrelated_query_nameÚnameÚnullrH   r   rQ   rP   Zobject_name)rE   Z
restrictedÚ	requestedZload_fieldsÚreverser   r   r   Úselect_related_descendà   s"    
ry   c             C   sZ   xPt dt| ƒd ƒD ]:}tj| d|… ƒ}||kr|| r|| | |d… fS qW df fS )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:   r   NF)Úranger=   r   Újoin)Zlookup_partsÚannotationsÚnZlevel_n_lookupr   r   r   Úrefs_expression  s
    r~   c                s,   ‡ fdd„}||ƒp*t |ddƒo*||jjƒ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| jkp(| jˆ j jƒ kp(ˆ | jƒ kS )N)rP   Zconcrete_modelZget_parent_list)rS   )rQ   r   r   Úcheck  s    z-check_rel_lookup_compatibility.<locals>.checkrR   F)rK   rQ   rP   )rQ   Ztarget_optsrE   r   r   )rQ   r   Úcheck_rel_lookup_compatibility  s    r€   c               @   s@   e Zd ZdZeƒ dœdd„Zdd„ Zdd„ Zd	d
„ Zdd„ Z	dS )ÚFilteredRelationz7Specify custom filtering in the ON clause of SQL joins.)Ú	conditionc            C   s:   |st dƒ‚|| _d | _t|tƒs*t 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   r   0  s    
zFilteredRelation.__init__c             C   s0   t || jƒo.| j|jko.| j|jko.| j|jkS )N)r(   r'   r„   r…   r‚   )r   r.   r   r   r   Ú__eq__:  s    zFilteredRelation.__eq__c             C   s,   t | j| jd�}| j|_| jd d … |_|S )N)r‚   )r�   r„   r‚   r…   r@   )r   Úcloner   r   r   r‡   B  s    zFilteredRelation.clonec             O   s   t dƒ‚dS )zz
        QuerySet.annotate() only accepts expression-like arguments
        (with a resolve_expression() method).
        z0FilteredRelation.resolve_expression() is unused.N)ÚNotImplementedError)r   r%   r&   r   r   r   r9   H  s    z#FilteredRelation.resolve_expressionc             C   s&   |j }|j| jt| jƒd�}|j|ƒS )N)r8   )r7   Zbuild_filtered_relation_qr‚   Úsetr@   Úcompile)r   r   r   r7   Úwherer   r   r   r   O  s    zFilteredRelation.as_sqlN)
r   r   r	   r
   r   r   r†   r‡   r9   r   r   r   r   r   r�   -  s   
r�   )F)r
   r*   rr   r]   Úcollectionsr   Zdjango.db.models.constantsr   Zdjango.utilsr   r   Ú	Exceptionr   r   r   ÚNoder   rD   rT   ry   r~   r€   r�   r   r   r   r   Ú<module>   s"   
F(C
$