OwlCyberSecurity - MANAGER
Edit File: related.cpython-39.pyc
a kH�f( � @ s� d dl Z d dlZd dl mZ d dlmZ d dlmZ d dlmZm Z d dl m Z m Z d dl mZmZ d dlmZ d d lmZ d d lmZ d d lmZmZmZ d d lmZ d d l m Z d dl m Z d dl m!Z" ddl#m$Z$ ddl%m&Z& ddl'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z- ddl.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5 ddl6m7Z7m8Z8m9Z9m:Z: dZ;dd� Z<dd� Z=G dd � d e&e$�Z>G d d � d e>�Z?e?�@e2� e?�@e/� e?�@e4� e?�@e0� e?�@e1� e?�@e5� e?�@e3� G d d � d e?�ZAG d!d"� d"eA�ZBd#d$� ZCG d%d&� d&e>�ZDdS )'� N)�partial)�forms)�apps)�SettingsReference�settings)�checks� exceptions)� connection�router)�utils)�Q)� LOOKUP_SEP)�CASCADE� SET_DEFAULT�SET_NULL)�PathInfo��make_model_tuple)�cached_property)� gettext_lazy� )�Field)�FieldCacheMixin)�ForeignKeyDeferredAttribute�ForwardManyToOneDescriptor�ForwardOneToOneDescriptor�ManyToManyDescriptor�ReverseManyToOneDescriptor�ReverseOneToOneDescriptor)� RelatedExact�RelatedGreaterThan�RelatedGreaterThanOrEqual� RelatedIn� RelatedIsNull�RelatedLessThan�RelatedLessThanOrEqual)�ForeignObjectRel� ManyToManyRel� ManyToOneRel� OneToOneRel�selfc C s2 |t kr | }t|t�r.d|vr.d| jj|f }|S )a� Transform relation into a model or fully-qualified model string of the form "app_label.ModelName", relative to scope_model. The relation argument can be: * RECURSIVE_RELATIONSHIP_CONSTANT, i.e. the string "self", in which case the model argument will be returned. * A bare model name without an app_label, in which case scope_model's app_label will be prepended. * An "app_label.ModelName" string. * A model class, which will be returned unchanged. �.�%s.%s)� RECURSIVE_RELATIONSHIP_CONSTANT� isinstance�str�_meta� app_label)Z scope_modelZrelation� r2 �a/home/gouroczh/virtualenv/test/3.9/lib/python3.9/site-packages/django/db/models/fields/related.py�resolve_relation+ s r4 c sL � g� fdd�|D � }dd� |D �}� j j}|jt| fi |��g|�R � S )a� Schedule `function` to be called once `model` and all `related_models` have been imported and registered with the app registry. `function` will be called with the newly-loaded model classes as its positional arguments, plus any optional keyword arguments. The `model` argument must be a model class. Each subsequent positional argument is another model, or a reference to another model - see `resolve_relation()` for the various forms these may take. Any relative references will be resolved relative to `model`. This is a convenience wrapper for `Apps.lazy_model_operation` - the app registry model used is the one found in `model._meta.apps`. c s g | ]}t � |��qS r2 )r4 )�.0�rel��modelr2 r3 � <listcomp>S � z*lazy_related_operation.<locals>.<listcomp>c s s | ]}t |�V qd S �Nr )r5 �mr2 r2 r3 � <genexpr>T r: z)lazy_related_operation.<locals>.<genexpr>)r0 r Zlazy_model_operationr )�functionr8 Zrelated_models�kwargs�modelsZ model_keysr r2 r7 r3 �lazy_related_operationD s rA c s� e Zd ZdZdZdZdZdZd.� fdd� Ze dd� �Z � fdd �Z d d � Z d d � Z dd� Zdd� Zdd� Zdd� Zd/� fdd� Z� fdd�Zdd� Zd d � Zed d � �Zd d!� Zd"d#� Zd$d%� Z� fd&d'�Zd(d)� Z ed*d+� �Z d,d-� Z � Z S )0� RelatedFieldz3Base class that all relational fields inherit from.FNc s( || _ || _|| _t� jf i |�� d S r; )� _related_name�_related_query_name�_limit_choices_to�super�__init__)r* � related_name�related_query_name�limit_choices_tor? �� __class__r2 r3 rG b s zRelatedField.__init__c C s t �� | jjS r; )r Zcheck_models_ready� remote_fieldr8 �r* r2 r2 r3 � related_modeln s zRelatedField.related_modelc s> g t � jf i |���| �� �| �� �| �� �| �� �| �� �S r; )rF �check� _check_related_name_is_valid�"_check_related_query_name_is_valid� _check_relation_model_exists�#_check_referencing_to_swapped_model�_check_clashes�r* r? rK r2 r3 rP t s ������zRelatedField.checkc C sl dd l }| jj}|d u r g S |�|� o.|�� }|sh|�d�shtjd| jj| jj j | j f d| dd�gS g S )Nr �+z5The name '%s' is invalid related_name for field %s.%sz@Related name must be a valid Python identifier or end with a '+'z fields.E306��hint�obj�id) �keywordrM rH � iskeyword� isidentifier�endswithr �Errorr8 r0 � object_name�name)r* r\ rH Z is_valid_idr2 r2 r3 rQ ~ s( �����z)RelatedField._check_related_name_is_validc C sl | j �� rg S | �� }g }|�d�r@|�tjd| d| dd�� t|v rh|�tjd|tf d| dd�� |S )N�_z8Reverse query name '%s' must not end with an underscore.zKAdd or change a related_name or related_query_name argument for this field.z fields.E308rX z.Reverse query name '%s' must not contain '%s'.z fields.E309)rM � is_hiddenrI r_ �appendr r` r )r* �rel_query_name�errorsr2 r2 r3 rR � s6 ��� ��� z/RelatedField._check_related_query_name_is_validc C sh | j j| jj�� v}t| j jt�}|r.| j jn | j jjj}|rd|sN| j jjj sdt j d| | dd�gS g S )NzXField defines a relation with model '%s', which is either not installed, or is abstract.z fields.E300�rZ r[ ) rM r8 �optsr � get_modelsr. r/ r0 ra �swappedr r` )r* Zrel_is_missing� rel_is_string� model_namer2 r2 r3 rS � s( � �� ����z)RelatedField._check_relation_model_existsc C s^ | j j| jj�� vrZt| j jt�sZ| j jjjrZt j d| j jjj d| j jjj | dd�gS g S )NzIField defines a relation with the model '%s', which has been swapped out.z.Update the relation to point at 'settings.%s'.z fields.E301rX ) rM r8 ri r rj r. r/ r0 rk r r` �label� swappablerN r2 r2 r3 rT � s$ � � � � ��� z0RelatedField._check_referencing_to_swapped_modelc s� ddl m} g }� jj}t� jj|�s*g S � jjj}� j�� }� j�� }� �� }d|j � j f }|j |j } | D ]�} d|j | j f } |s�| j |kr�|� tjd|j� d|� d|� d| � d� d | |f � d d �� | j |krp|� tjd || f d | |f � d d �� qp� fdd�|jD �} | D ]�} d| jjj | jj f } |�s�| �� |k�r�|� tjd|j� d|� d|� d| � d� d|| f � dd �� | �� |k�r|� tjd|| f d|| f � dd �� �q|S )z.Check accessor and reverse query name clashes.r )� ModelBaser, zReverse accessor 'r+ z' for 'z' clashes with field name 'z'.zZRename field '%s', or add/change a related_name argument to the definition for field '%s'.z fields.E302rX z9Reverse query name for '%s' clashes with field name '%s'.z fields.E303c 3 s | ]}|j � ur|V qd S r; ��field)r5 �rrN r2 r3 r= - r: z.RelatedField._check_clashes.<locals>.<genexpr>z%' clashes with reverse accessor for 'zIAdd or change a related_name argument to the definition for '%s' or '%s'.z fields.E304zEReverse query name for '%s' clashes with reverse query name for '%s'.z fields.E305)Zdjango.db.models.baserp r8 r0 r. rM rd �get_accessor_namerI rn rb �fields� many_to_manyre r r` ra Zrelated_objectsrO rr ) r* rp rg ri Zrel_optsZ rel_is_hiddenZrel_namerf � field_nameZpotential_clashesZ clash_fieldZ clash_namer2 rN r3 rU � s� ����� ��������������zRelatedField._check_clashesc C s d S r; r2 �r* r r2 r2 r3 �db_typeU s zRelatedField.db_typec s� t � j||fd|i|�� |j| _|jjs�| jjr<| jj}n| jj}|rv||j� � |jj � � |jj � � d�; }|| j_| jj r�| jj |j� � |jj � � d� }|| j_ dd� }t ||| jj| d� d S )N� private_only)�classrm r1 )r{ r1 c S s ||j _|�|| � d S r; )rM r8 �do_related_class)r8 �relatedrr r2 r2 r3 �resolve_related_classs s z?RelatedField.contribute_to_class.<locals>.resolve_related_classrq )rF �contribute_to_classr0 ri �abstractrM rH Zdefault_related_name�__name__�lowerrm r1 rI rA r8 )r* �clsrb rz r? rH rI r~ rK r2 r3 r Z s. � � �z RelatedField.contribute_to_classc sV t � �� \}}}}| jr"| j|d< | jd ur6| j|d< | jd urJ| j|d< ||||fS )NrJ rH rI )rF � deconstructrE rC rD �r* rb �path�argsr? rK r2 r3 r� { s zRelatedField.deconstructc s � �fdd��j D �S )a> Return the keyword arguments that when supplied to self.model.object.filter(), would select all instances related through this field to the remote obj. This is used to build the querysets returned by related descriptors. obj is an instance of self.related_field.model. c s* i | ]"\}}d �j |j f t� |j��qS )z%s__%s)rb �getattr�attname)r5 rc �rh_field�rZ r* r2 r3 � <dictcomp>� s �z;RelatedField.get_forward_related_filter.<locals>.<dictcomp>��related_fields�r* rZ r2 r� r3 �get_forward_related_filter� s �z'RelatedField.get_forward_related_filterc sP t �� fdd�| jD ��}| �� �}t|t�r@|t f i |��@ S |rL||@ S |S )a% Complement to get_forward_related_filter(). Return the keyword arguments that when passed to self.related_field.model.object.filter() select all instances of self.related_field.model related through this field to obj. obj is an instance of self.model. c s" g | ]\}}|j t� |j �f�qS r2 )r� r� )r5 Zlh_fieldr� �rZ r2 r3 r9 � s �z;RelatedField.get_reverse_related_filter.<locals>.<listcomp>)r �creater� �get_extra_descriptor_filterr. �dict)r* rZ Zbase_qZdescriptor_filterr2 r� r3 �get_reverse_related_filter� s �� z'RelatedField.get_reverse_related_filterc C s8 | j r4t| jjt�r | jj}n | jjjj}t�|�S dS )z� Get the setting that this is powered from for swapping, or None if it's not swapped in / marked with swappable=False. N) ro r. rM r8 r/ r0 rn r Zget_swappable_settings_name)r* Z to_stringr2 r2 r3 �swappable_setting� s z RelatedField.swappable_settingc C sL | j p"| jjjjd | jjjjj | _ | jd u r>| jjjj| _| j�� d S )Nrc )rb rM r8 r0 rm �pk� verbose_nameZset_field_namerN r2 r2 r3 �set_attributes_from_rel� s � �� z$RelatedField.set_attributes_from_relc C s | � � | �|| j� d S r; )r� �contribute_to_related_classrM )r* �otherr� r2 r2 r3 r| � s z RelatedField.do_related_classc C s t | jj�r| j�� S | jjS )z� Return ``limit_choices_to`` for this model field. If it is a callable, it will be invoked and the result will be returned. )�callablerM rJ rN r2 r2 r3 �get_limit_choices_to� s z!RelatedField.get_limit_choices_toc sB i }t | jd�r&| jj}|�d|i� |�|� t� jf i |��S )z� Pass ``limit_choices_to`` to the field being constructed. Only passes it if there is a type that supports related fields. This is a similar strategy used to pass the ``queryset`` to the field being constructed. Zget_related_fieldrJ )�hasattrrM rJ �updaterF � formfield)r* r? �defaultsrJ rK r2 r3 r� � s �� zRelatedField.formfieldc C s | j jp| j jp| jjS )zu Define the name that can be used to identify this related object in a table-spanning query. )rM rI rH ri rm rN r2 r2 r3 rI � s ��z RelatedField.related_query_namec C s* | j d j}t|�dkr"t�d��|d S )z� When filtering against this relation, return the field on the remote model against which the filtering should happen. ���r zSThe relation has multiple target fields, but only single target field was asked forr )� path_infos� target_fields�lenr � FieldError)r* r� r2 r2 r3 � target_field� s �zRelatedField.target_fieldc C s | j S r; �rb rN r2 r2 r3 �get_cache_name� s zRelatedField.get_cache_name)NNN)F) r� � __module__� __qualname__�__doc__� one_to_many� one_to_onerv � many_to_onerG r rO rP rQ rR rS rT rU ry r r� r� r� �propertyr� r� r| r� r� rI r� r� � __classcell__r2 r2 rK r3 rB Y s@ � !s! rB c sR e Zd ZdZdZdZdZdZdZe Z e Z e Zd:� fdd� Z� fdd�Z� fd d �Zd d � Zd d� Z� fdd�Zdd� Zedd� �Zedd� �Zedd� �Zedd� �Zdd � Zd d � Z e d d � �Z � fd!d"�Z d;d#d$�Z d%d&� Z!d'd(� Z"d)d*� Z#d<d+d,�Z$ed-d.� �Z%d=d/d0�Z&ed1d2� �Z'e(e)j*dd3�d4d5� ��Z+d>� fd6d7� Z,d8d9� Z-� Z.S )?� ForeignObjectzS Abstraction of the ForeignKey relation to support multi-column relations. FTNc sR |d u r | j | ||||| |d�}t� jf ||||d�| �� || _|| _| | _d S )N�rH rI rJ � parent_link� on_delete)r6 rH rI rJ )� rel_classrF rG � from_fields� to_fieldsro ) r* �tor� r� r� r6 rH rI rJ r� ro r? rK r2 r3 rG s* � ��zForeignObject.__init__c s* t � �� }|j�dd � |j�dd � |S )Nr� �reverse_path_infos)rF �__copy__�__dict__�popr� rK r2 r3 r� 6 s zForeignObject.__copy__c s& g t � jf i |���| �� �| �� �S r; )rF rP �_check_to_fields_exist�_check_unique_targetrV rK r2 r3 rP = s ���zForeignObject.checkc C sz t | jjt�rg S g }| jD ]X}|r z| jjj�|� W q tjyr |� t j d|| jjjj f | dd�� Y q 0 q |S )Nz:The to_field '%s' doesn't exist on the related model '%s'.z fields.E312rh ) r. rM r8 r/ r� r0 � get_fieldr �FieldDoesNotExistre r r` rn )r* rg �to_fieldr2 r2 r3 r� D s$ ��� z$ForeignObject._check_to_fields_existc sR t | jjt�}|s| js g S z | j W n tjy> g Y S 0 | jsJg S dd� | jjj� � D �}|� dd� | jjjj D �� |� dd� | jjjj D �� dd� | jD �� t � fdd�|D ��}|�st| j�dk�rd �d d� | jD ��}| jjj}tjd ||f d | d d�gS |�sJ| jd j}| jjj}tjd||f d| dd�gS g S d S )Nc S s$ h | ] }t |d d�rt|jg��qS )�uniqueF)r� � frozensetrb �r5 �fr2 r2 r3 � <setcomp>g s �z5ForeignObject._check_unique_target.<locals>.<setcomp>c S s h | ] }t |��qS r2 )r� )r5 �utr2 r2 r3 r� m r: c S s h | ]}t |j��qS r2 )r� ru )r5 Zucr2 r2 r3 r� p s �c S s h | ] }|j �qS r2 r� r� r2 r2 r3 r� u r: c 3 s | ]}|� kV qd S r; r2 )r5 �u�Zforeign_fieldsr2 r3 r= v r: z5ForeignObject._check_unique_target.<locals>.<genexpr>r �, c s s | ]}d |j V qdS )z'%s'Nr� )r5 Z rel_fieldr2 r2 r3 r= y s z3No subset of the fields %s on model '%s' is unique.z�Mark a single field as unique=True or add a set of fields to a unique constraint (via unique_together or a UniqueConstraint (without condition) in the model Meta.constraints).z fields.E310rX r zA'%s.%s' must be unique because it is referenced by a foreign key.zjAdd unique=True to this field or add a UniqueConstraint (without condition) in the model Meta.constraints.z fields.E311)r. rM r8 r/ �requires_unique_target�foreign_related_fieldsr r� r0 Z get_fieldsr� �unique_togetherZtotal_unique_constraints�anyr� �joinr� r r` rb )r* rl Zunique_foreign_fieldsZhas_unique_constraintZfield_combinationrm rw r2 r� r3 r� Z sb �� �� � ��� ���z"ForeignObject._check_unique_targetc s t � �� \}}}}| jj|d< | j|d< | j|d< | jjrF| jj|d< t| jjt �r�d| jjv r�| jj� d�\}}d||� � f |d< q�| jj� � |d< n| jjj j |d< | j}|d ur�t|d d�r�|d j|kr�td |d j|f ��t|d |�|d< ||||fS ) Nr� r� r� r� r+ r, r� � setting_namezoCannot deconstruct a ForeignKey pointing to a model that is swapped in place of more than one model (%s and %s))rF r� rM r� r� r� r� r. r8 r/ �splitr� r0 � label_lowerr� r� r� � ValueErrorr �r* rb r� r� r? r1 rm r� rK r2 r3 r� � s4 ���zForeignObject.deconstructc C s� | j rt| j �t| j�kr"td��t| jjt�r@td| jj ��g }tt| j ��D ]b}| j | }| j| }|t krv| n | j � |�}|d u r�| jjj j n| jjj � |�}|�||f� qR|S )NzBForeign Object from and to fields must be the same non-zero lengthz#Related model %r cannot be resolved)r� r� r� r� r. rM r8 r/ �ranger- ri r� r0 r� re )r* r� �indexZfrom_field_name� to_field_name� from_fieldr� r2 r2 r3 �resolve_related_fields� s, � � � ���z$ForeignObject.resolve_related_fieldsc C s | � � S r; )r� rN r2 r2 r3 r� � s z ForeignObject.related_fieldsc C s dd� | j D �S )Nc S s g | ]\}}||f�qS r2 r2 �r5 Z lhs_fieldZ rhs_fieldr2 r2 r3 r9 � r: z8ForeignObject.reverse_related_fields.<locals>.<listcomp>r� rN r2 r2 r3 �reverse_related_fields� s z$ForeignObject.reverse_related_fieldsc C s t dd� | jD ��S )Nc s s | ]\}}|V qd S r; r2 r� r2 r2 r3 r= � r: z5ForeignObject.local_related_fields.<locals>.<genexpr>��tupler� rN r2 r2 r3 �local_related_fields� s z"ForeignObject.local_related_fieldsc C s t dd� | jD ��S )Nc s s | ]\}}|r|V qd S r; r2 r� r2 r2 r3 r= � s z7ForeignObject.foreign_related_fields.<locals>.<genexpr>r� rN r2 r2 r3 r� � s �z$ForeignObject.foreign_related_fieldsc C s | � || j�S r; )� get_instance_value_for_fieldsr� �r* �instancer2 r2 r3 �get_local_related_value� s z%ForeignObject.get_local_related_valuec C s | � || j�S r; )r� r� r� r2 r2 r3 �get_foreign_related_value� s z'ForeignObject.get_foreign_related_valuec C sb g }| j }|D ]J}|jrF|�|j�}|r8|js8|jj jrF|�| j� q|�t| |j�� qt |�S r; ) r0 Z primary_keyZget_ancestor_linkr8 r� re r� r� r� r� )r� ru �retri rr Zpossible_parent_linkr2 r2 r3 r� � s ��� z+ForeignObject.get_instance_value_for_fieldsc s t � �� \}}|d fS r; )rF �get_attname_column�r* r� �columnrK r2 r3 r� s z ForeignObject.get_attname_columnc C s" |r | j n| j}tdd� |D ��S )Nc s s | ]\}}|j |j fV qd S r; )r� r� r2 r2 r3 r= s z4ForeignObject.get_joining_columns.<locals>.<genexpr>)r� r� r� )r* � reverse_join�sourcer2 r2 r3 �get_joining_columns s �z!ForeignObject.get_joining_columnsc C s | j dd�S )NT)r� )r� rN r2 r2 r3 �get_reverse_joining_columns s z)ForeignObject.get_reverse_joining_columnsc C s i S )a� Return an extra filter condition for related object fetching when user does 'instance.fieldname', that is the extra filter is used in the descriptor of the field. The filter should be either a dict usable in .filter(**kwargs) call or a Q-object. The condition will be ANDed together with the relation's joining columns. A parallel method is get_extra_restriction() which is used in JOIN and subquery conditions. r2 r� r2 r2 r3 r� s z)ForeignObject.get_extra_descriptor_filterc C s dS )a� Return a pair condition used for joining and subquery pushdown. The condition is something that responds to as_sql(compiler, connection) method. Note that currently referring both the 'alias' and 'related_alias' will not work in some conditions, like subquery pushdown. A parallel method is get_extra_descriptor_filter() which is used in instance.fieldname related object fetching. Nr2 )r* �aliasZ related_aliasr2 r2 r3 �get_extra_restriction# s z#ForeignObject.get_extra_restrictionc C s, | j jj}| jj}t||| j| dd|d�gS )z.Get path from this field to the related model.FT�� from_opts�to_optsr� Z join_fieldZm2m�direct�filtered_relation)rM r8 r0 r r� �r* r� ri r� r2 r2 r3 � get_path_info1 s ��zForeignObject.get_path_infoc C s | � � S r; �r� rN r2 r2 r3 r� A s zForeignObject.path_infosc C s4 | j j}| jj j}t|||jf| j| j d|d�gS )z6Get path from the related model to this field's model.Fr� )r8 r0 rM r r� r� r� r2 r2 r3 �get_reverse_path_infoE s ��z#ForeignObject.get_reverse_path_infoc C s | � � S r; �r� rN r2 r2 r3 r� U s z ForeignObject.reverse_path_infos)�maxsizec C s8 t �| �}|d |�t�d � }dd� |D �}| �|�S )Nr c S s g | ]}|j �d i ��qS )� class_lookups)r� �get)r5 �parentr2 r2 r3 r9 ^ r: z3ForeignObject.get_class_lookups.<locals>.<listcomp>)�inspect�getmror� r� Z merge_dicts)r� �basesr� r2 r2 r3 �get_class_lookupsY s z ForeignObject.get_class_lookupsc s2 t � j||fd|i|�� t|| j| �| �� d S )Nrz )rF r �setattrrb � forward_related_accessor_class)r* r� rb rz r? rK r2 r3 r a s z!ForeignObject.contribute_to_classc C sL | j �� sH|jjjsHt|jj|�� | �|�� | j j rH|jj � | j j � d S r; ) rM rd rO r0 rk r �concrete_modelrt �related_accessor_classrJ Zrelated_fkey_lookupsre �r* r� r} r2 r2 r3 r� e s ����z)ForeignObject.contribute_to_related_class)NNNNFT)F)N)N)F)/r� r� r� r� rv r� r� r� r� r r r r r& r� rG r� rP r� r� r� r� r r� r� r� r� r� r� � staticmethodr� r� r� r� r� r� r� r� r� r� � classmethod� functools� lru_cacher r r� r� r2 r2 rK r3 r� sd �% D # r� c s< e Zd ZdZeZdZdZdZdZ e Z dZ de d�iZe d�Zd9� fdd � Zd d � Z� fd d �Zdd� Zdd� Z� fdd�Zdd� Zedd� �Z� fdd�Z� fdd�Zd d � Zd d � Z � fd d!�Z d"d#� Z d:d$d%�Z d&d'� Z � fd(d)�Z!dd*�� fd+d,� Z"d-d.� Z#d/d0� Z$d1d2� Z%d3d4� Z&� fd5d6�Z'd;� fd7d8� Z(� Z)S )<� ForeignKeyz� Provide a many-to-one relation by adding a column to the local model to hold the remote value. By default ForeignKey will target the pk of the remote model but this behavior can be changed by using the ``to_field`` argument. FT�invalidz;%(model)s instance with %(field)s %(value)r does not exist.z.Foreign Key (type determined by related field)Nc s� z |j j W n2 ty> t|t�s:td| jj|tf ��Y n0 |pT|j j oT|j j j }t |�sftd��| j | |||||||d�| d< | � dd� t� j||f|||tg|gd�| �� || _d S )Nzg%s(%r) is invalid. First parameter to ForeignKey must be either a model, a model name, or the string %rzon_delete must be callable.r� r6 �db_indexT)rH rI rJ r� r� )r0 rm �AttributeErrorr. r/ � TypeErrorrL r� r- r� rb r� r� � setdefaultrF rG � db_constraint) r* r� r� rH rI rJ r� r� r r? rK r2 r3 rG � sN ��� � ��� zForeignKey.__init__c O s | S r; r2 )r� r� r? r2 r2 r3 �__class_getitem__� s z ForeignKey.__class_getitem__c s& g t � jf i |���| �� �| �� �S r; )rF rP �_check_on_delete� _check_uniquerV rK r2 r3 rP � s ���zForeignKey.checkc C s\ t | jdd �}|tkr0| js0tjdd| dd�gS |tkrT| �� sTtjdd| dd�gS g S d S ) Nr� z7Field specifies on_delete=SET_NULL, but cannot be null.zBSet null=True argument on the field, or change the on_delete rule.z fields.E320rX z@Field specifies on_delete=SET_DEFAULT, but has no default value.z2Set a default value, or change the on_delete rule.z fields.E321)r� rM r �nullr r` r Z has_default)r* r� r2 r2 r3 r � s$ �� �� zForeignKey._check_on_deletec K s | j rtjdd| dd�gS g S )NzQSetting unique=True on a ForeignKey has the same effect as using a OneToOneField.zDForeignKey(unique=True) is usually better served by a OneToOneField.z fields.W342rX )r� r �WarningrV r2 r2 r3 r � s ��� �zForeignKey._check_uniquec s� t � �� \}}}}|d= |d= | jr,|d= nd|d< | jdurH| j|d< t| jjdd �}| jjr�|rz|jr�| jj|jj kr�| jj|d< ||||fS ) Nr� r� r FTr r0 r� ) rF r� r r r� rM r8 rw r� rb )r* rb r� r� r? Zto_metarK r2 r3 r� s$ ��� zForeignKey.deconstructc C s | j �|�S r; )r� � to_python�r* �valuer2 r2 r3 r s zForeignKey.to_pythonc C s | j d S )Nr )r� rN r2 r2 r3 r� ! s zForeignKey.target_fieldc s� | j jr d S t� �||� |d u r&d S tj| j j|d�}| j jj�|�j f i | j j |i��}|� | � � �}|� � s�tj| jd d| j jjj|| j j |d�d��d S )N)r� r )r8 r� rr r )�code�params)rM r� rF �validater Z db_for_readr8 Z _base_manager�using�filterrw Zcomplex_filterr� �existsr ZValidationErrorZerror_messagesr0 r� )r* r Zmodel_instancer �qsrK r2 r3 r % s( � ��zForeignKey.validatec s^ t � �� }|D ]J\}}|r|j| jjjjkrt�d| jjj| j |j | jjjjjjf ��q|S )Nz>'%s.%s' refers to field '%s' which is not local to model '%s'.) rF r� r8 rM r0 r r r� rn rb )r* r� r� r� rK r2 r3 r� = s ����� z!ForeignKey.resolve_related_fieldsc C s d| j S )Nz%s_idr� rN r2 r2 r3 � get_attnameP s zForeignKey.get_attnamec C s | � � }| jp|}||fS r; )r Z db_columnr� r2 r2 r3 r� S s z ForeignKey.get_attname_columnc s* t � �� }t|| jj�r&t|| jj�S |S )z6Return the to_field if the default value is an object.)rF � get_defaultr. rM r8 r� r� r� )r* Z field_defaultrK r2 r3 r! X s zForeignKey.get_defaultc C s8 |d u s |dkr$| j jr |jjr$d S | j j||d�S d S )N� �r )r� �empty_strings_allowed�features�!interprets_empty_strings_as_nulls�get_db_prep_save)r* r r r2 r2 r3 r' _ s ���zForeignKey.get_db_prep_savec C s | j �|||�S r; )r� �get_db_prep_value)r* r r �preparedr2 r2 r3 r( k s z ForeignKey.get_db_prep_valuec C s | j �|�S r; )r� �get_prep_valuer r2 r2 r3 r* n s zForeignKey.get_prep_valuec s, t � �||� | jjd u r(|jjj| j_d S r; )rF r� rM rw r0 r� rb r rK r2 r3 r� q s z&ForeignKey.contribute_to_related_class�r c s^ t | jjt�r$td| j| jjf ��t� jf i tj | jjj � |�| jj d�|�d| j i���S )NzYCannot create form field for %r yet, because its related model %r has not been loaded yet)� form_class�querysetr� �blank)r. rM r8 r/ r� rb rF r� r ZModelChoiceField�_default_managerr rw r. )r* r r? rK r2 r3 r� v s �� ����zForeignKey.formfieldc C s d S r; r2 rx r2 r2 r3 �db_check� s zForeignKey.db_checkc C s | j j|d�S )Nr# )r� Z rel_db_typerx r2 r2 r3 ry � s zForeignKey.db_typec C s* | j �|�}| �|�| �|�|�d�d�S )N� collation)�typerP r1 )r� � db_parametersry r0 r� )r* r Ztarget_db_parametersr2 r2 r3 r3 � s �zForeignKey.db_parametersc C s |st |t�rd S |S r; )r. r/ )r* r � expressionr r2 r2 r3 �convert_empty_strings� s z ForeignKey.convert_empty_stringsc s$ t � �|�}|jjr || jg7 }|S r; )rF �get_db_convertersr% r& r5 )r* r � convertersrK r2 r3 r6 � s z ForeignKey.get_db_convertersc s> |d u r0| j }t|t�r0|j }|| u rtd��qt� �||�S )Nz Cannot resolve output_field.)r� r. r r� rF �get_col)r* r� Z output_fieldrK r2 r3 r8 � s zForeignKey.get_col)NNNFNT)F)N)*r� r� r� r� r Zdescriptor_classrv r� r� r� r( r� r$ rc Zdefault_error_messages� descriptionrG r rP r r r� r r� r� r r� r r� r! r' r( r* r� r� r0 ry r3 r5 r6 r8 r� r2 r2 rK r3 r � sT � �9 r c sn e Zd ZdZdZdZdZdZeZ e Z e Z ed�Zd� fdd� Z� fdd �Z� fd d �Zd d � Zdd� Z� ZS )� OneToOneFielda A OneToOneField is essentially the same as a ForeignKey, with the exception that it always carries a "unique" constraint with it and the reverse relation always returns the object pointed to (since there will only ever be one), rather than returning a list. FTzOne-to-one relationshipNc s& d|d< t � j||fd|i|�� d S )NTr� r� )rF rG )r* r� r� r� r? rK r2 r3 rG � s zOneToOneField.__init__c s, t � �� \}}}}d|v r |d= ||||fS )Nr� )rF r� r� rK r2 r3 r� � s zOneToOneField.deconstructc s | j jr d S t� jf i |��S r; )rM r� rF r� rV rK r2 r3 r� � s zOneToOneField.formfieldc C sF t || jj�r t|| j|� n$t|| j|� |d u rBt|| j|� d S r; )r. rM r8 r rb r� �r* r� �datar2 r2 r3 �save_form_data� s z OneToOneField.save_form_datac K s g S r; r2 rV r2 r2 r3 r � s zOneToOneField._check_unique)N)r� r� r� r� rv r� r� r� r r r r r) r� rc r9 rG r� r� r= r r� r2 r2 rK r3 r: � s r: c C s ddl m} dd� }t|| jj�}d|jj| jf }t||||� t |�d }|jj }||krnd| }d| }t d d | � |j�||jj |jj||ftd �||d � td �||d � | jjjd��}t ||jfd |d|j||j|d| | j| jjtd�||j|d| | j| jjtd�i�S )Nr )r@ c S s | j jp|j j|j _d S r; )r0 �managed)r8 r} �throughr2 r2 r3 � set_managed� s z;create_many_to_many_intermediary_model.<locals>.set_managed�%s_%sr zto_%szfrom_%sZMetar2 z %(from)s-%(to)s relationship)�fromr� z %(from)s-%(to)s relationships)�db_table� auto_createdr1 � db_tablespacer� r� Zverbose_name_pluralr r� z%s+)rH rE r r� )� django.dbr@ r4 rM r8 r0 ra rb rA r rm r2 �_get_m2m_db_tabler1 rE rc r ZModelr� r r r ) rr �klassr@ r@ �to_modelrb r� Zfrom_�metar2 r2 r3 �&create_many_to_many_intermediary_model� s` ��������rK c s e Zd ZdZdZdZdZdZeZ e d�Z d7� fdd� Z � fdd �Z d d � Zd d � Zd8dd�Zdd� Z� fdd�Zd9dd�Zd:dd�Zedd� �Zd;dd�Zed d � �Zd d � Zd d!� Zd"d#� Z� fd$d%�Z d&d'� Z d(d)� Z d*d+� Z d,d-� Z dd.�� fd/d0� Z!d1d2� Z"d3d4� Z#d5d6� Z$� Z%S )<�ManyToManyFieldaK Provide a many-to-many relation by using an intermediary model that holds two ForeignKey fields pointed at the two sides of the relation. Unless a ``through`` model was provided, ManyToManyField will use the create_many_to_many_intermediary_model factory to automatically generate the intermediary model. TFzMany-to-many relationshipNc s� z |j W n2 ty< t|t�s8td| jj|tf ��Y n0 |d u rN|tk}|d urf| d urftd��| j | ||||||||d� | d< d| v | _ t � j f |||d�| �� | | _ | | _d S )Nzl%s(%r) is invalid. First parameter to ManyToManyField must be either a model, a model name, or the string %rz;Cannot specify a db_table if an intermediary model is used.)rH rI rJ � symmetricalr? �through_fieldsr r6 r )rH rI rJ )r0 r r. r/ r rL r� r- r� r� � has_null_argrF rG rC ro ) r* r� rH rI rJ rM r? rN r rC ro r? rK r2 r3 rG ) sN ��� �� ��zManyToManyField.__init__c sV g t � jf i |���| jf i |���| jf i |���| jf i |���| jf i |���S r; )rF rP r �_check_relationship_model�_check_ignored_options�_check_table_uniquenessrV rK r2 r3 rP d s �����zManyToManyField.checkc K s | j rtjd| dd�gS g S )Nz"ManyToManyFields cannot be unique.z fields.E330rh )r� r r` rV r2 r2 r3 r m s ��z ManyToManyField._check_uniquec K s� g }| j r |�tjd| dd�� | jr<|�tjd| dd�� | jjr`| jr`|�tjd| dd�� | jr||�tjd| d d�� |S ) Nz&null has no effect on ManyToManyField.z fields.W340rh z,ManyToManyField does not support validators.z fields.W341z^related_name has no effect on ManyToManyField with a symmetrical relationship, e.g. to "self".z fields.W345z,db_comment has no effect on ManyToManyField.z fields.W346) rO re r r Z _validatorsrM rM rC Z db_comment)r* r? �warningsr2 r2 r3 rQ x sD ��������z&ManyToManyField._check_ignored_optionsc s� t | jjd�r*d| jjjj| jjjf }n| jj}g }| jj| jjjdd�vrl|� t j d| | dd�� �n�� d us|J d��t � | jj ��� jj}t�t�r��}n�jj}| jjjj}� �k}|�r t� fd d �| jjjjD ��} | d k�r| jj�s|� t j d | |f d | jjdd�� n�t� fdd �| jjjjD ��} t�fdd �| jjjjD ��} | dk�r�| jj�s�|� t j d| |f dt|f | dd�� | dk�r�| jj�s�|� t j d| |f dt|f | dd�� | dk�s�| dk�r|� t j d| ||f | jjdd�� | jjd u�r�t| jj�d k�rD| jjd �rD| jjd �sd|� t j d| d | d d�� �nN� d u�svJ d��� | jj| jj } } }| jjd d � \}}|| f||ffD ]�\}}g }| jjD ]2}t |d ��r�t|jd d �|k�r�|� |j� �q�|�rd |jjd!�|�f }nd }z| j�|�}W n6 tj�yb |� t j d"||f || d#d�� Y nL0 t |d ��r�t|jd d �|k�s�|� t j d$| jj||jjf || d%d�� �q�|S )&Nr0 r, T�Zinclude_auto_createdzYField specifies a many-to-many relation through model '%s', which has not been installed.z fields.E331rh zvManyToManyField with intermediate tables cannot be checked if you don't pass the model where the field is attached to.c 3 s | ]}� t |jd d�kV qdS �r8 N�r� rM �r5 rr �� from_modelr2 r3 r= � s �z<ManyToManyField._check_relationship_model.<locals>.<genexpr>� z�The model is used as an intermediate model by '%s', but it has more than two foreign keys to '%s', which is ambiguous. You must specify which two foreign keys Django should use via the through_fields keyword argument.zGUse through_fields to specify which two foreign keys Django should use.z fields.E333rX c 3 s | ]}� t |jd d�kV qdS rU rV rW rX r2 r3 r= � s �c 3 s | ]}� t |jd d�kV qdS rU rV rW )rI r2 r3 r= � s �r z�The model is used as an intermediate model by '%s', but it has more than one foreign key from '%s', which is ambiguous. You must specify which foreign key Django should use via the through_fields keyword argument.zXIf you want to create a recursive relationship, use ManyToManyField("%s", through="%s").z fields.E334z�The model is used as an intermediate model by '%s', but it has more than one foreign key to '%s', which is ambiguous. You must specify which foreign key Django should use via the through_fields keyword argument.z fields.E335r zgThe model is used as an intermediate model by '%s', but it does not have a foreign key to '%s' or '%s'.z fields.E336z�Field specifies 'through_fields' but does not provide the names of the two link fields that should be used for the relation through model '%s'.zMMake sure you specify 'through_fields' as through_fields=('field1', 'field2')z fields.E337rM r8 z;Did you mean one of the following foreign keys to '%s': %s?r� z.The intermediary model '%s' has no field '%s'.z fields.E338z%'%s.%s' is not a foreign key to '%s'.z fields.E339) r� rM r? r0 r1 r� ri r rj re r r` r4 r8 ra r. r/ �sumru rN r- r� r� rb r� r� r r� )r* rY r? Zqualified_model_namerg Zfrom_model_nameZ to_model_nameZrelationship_model_nameZself_referentialZ seen_selfZ seen_fromZseen_tor� r? �targetZsource_field_nameZtarget_field_namerw rO Zpossible_field_namesr� rY rr r2 )rY rI r3 rP � sP ����� � ���� � �� ������������ � � ���� �� �� ����� ��� � ������z)ManyToManyField._check_relationship_modelc s� t � jjt�s� jjjjs g S � fdd�� jjjdd�D �}� � � }|� |�}|r�|jj � jjjj kr�|jj r�dd� }|jj j}d|j ||�f }n|jj }tjr�tjd }} d | } ntjd }} d } |d ||f � | | d �gS g S ) Nc s* i | ]"}|� j jkr|jjr|jj|�qS r2 )rM r? r0 r> rC )r5 r8 rN r2 r3 r� � s �z;ManyToManyField._check_table_uniqueness.<locals>.<dictcomp>TrT c S s, | j jj jD ]}|jj| u r |j S q d S r; )r0 rD rv rM r? rb )r8 rr r2 r2 r3 �_get_field_name� s z@ManyToManyField._check_table_uniqueness.<locals>._get_field_namer, z fields.W344zvYou have configured settings.DATABASE_ROUTERS. Verify that the table of %r is correctly routed to a separate database.z fields.E340zHThe field's intermediary table '%s' clashes with the table name of '%s'.)rZ rY r[ )r. rM r? r/ r0 r> ri r rj � m2m_db_tabler� r rD rn r ZDATABASE_ROUTERSr r r` ) r* r? Zregistered_tablesr^ r8 r] ri Z clashing_objZ error_classZerror_idZ error_hintr2 rN r3 rR � sN � � � � �� �� ��� z'ManyToManyField._check_table_uniquenessc sP t � �� \}}}}| jd ur&| j|d< | jjdur>| jj|d< t| jjt�r�d| jjv r�| jj�d�\}}d||� � f |d< q�| jj� � |d< n| jjj j |d< t | jdd �d ur�t| jj t�r�| jj |d< n | jj j js�| jj j j|d< | j}|d u�rDt|d d��r2|d j|k�r2td |d j|f ��t|d |�|d< ||||fS ) NrC Tr r+ r, r� r? r� ztCannot deconstruct a ManyToManyField pointing to a model that is swapped in place of more than one model (%s and %s))rF r� rC rM r r. r8 r/ r� r� r0 r� r� r? rD rn r� r� r� r� r r� rK r2 r3 r� � s< ���zManyToManyField.deconstructc C s� | j j}|j�| �� �}|j�| �� �}|rJ|j}|rB|�|�}qf|j}n |j}|r`|�|�}n|j}|d j }|d j } || u r�g } n(t |j | j �r�|� | j �} n | �|j �} g |�| �|�S )z1Called by both direct and indirect m2m traversal.r� r )rM r? r0 r� �m2m_field_name�m2m_reverse_field_namer� r� r� r� r� � issubclassr8 Zget_path_to_parentZget_path_from_parent) r* r� r� Z int_modelZ linkfield1Z linkfield2Z join1infosZ join2infosZ join1_finalZ join2_initialZintermediate_infosr2 r2 r3 �_get_path_info� s( z ManyToManyField._get_path_infoc C s | j d|d�S )NT�r� r� �rb �r* r� r2 r2 r3 r� s z ManyToManyField.get_path_infoc C s | � � S r; r� rN r2 r2 r3 r� s zManyToManyField.path_infosc C s | j d|d�S )NFrc rd re r2 r2 r3 r� s z%ManyToManyField.get_reverse_path_infoc C s | � � S r; r� rN r2 r2 r3 r� s z"ManyToManyField.reverse_path_infosc C sP | j jdur| j jjjS | jr$| jS dt�|j�| jf }t�|tj � � �S dS )zg Function that can be curried to provide the m2m table name for this relation. NrA ) rM r? r0 rC r � strip_quotesrb Z truncate_namer �opsZmax_name_length)r* ri Zm2m_table_namer2 r2 r3 rG s z!ManyToManyField._get_m2m_db_tablec C s� d| }t | |�r t| |�S | jjdur6| jjd }nd}| jjjjD ]J}|jrF|jj|j krF|du sp||j krFt | |t||�� t| |� S qFdS )zz Function that can be curried to provide the source accessor or DB column name for the m2m table. z _m2m_%s_cacheNr ) r� r� rM rN r? r0 ru � is_relationr8 rO rb r )r* r} �attr� cache_attr�link_field_namer� r2 r2 r3 � _get_m2m_attr s" � ���z ManyToManyField._get_m2m_attrc C s� d| }t | |�r t| |�S d}| jjdur:| jjd }nd}| jjjjD ]v}|jrJ|jj|jkrJ|du r�|j |jkr�|r�t | |t||�� q�q�d}qJ|du s�||j krJt | |t||�� q�qJt| |�S )z{ Function that can be curried to provide the related accessor or DB column name for the m2m table. z_m2m_reverse_%s_cacheFNr T) r� r� rM rN r? r0 ru rh r8 rO r rb )r* r} ri rj �foundrk r� r2 r2 r3 �_get_m2m_reverse_attr1 s$ z%ManyToManyField._get_m2m_reverse_attrc s� | j jr2| j jtks$| j j|jjkr2d| | j _n&| j �� rXd|jj|j � � |f | j _t � j ||fi |�� |jj s�| j jr�dd� }t||| j j| d� n|jjs�t| |�| j _t|| jt| j dd�� t| j|j�| _d S )Nz%s_rel_+z _%s_%s_%s_+c S s ||j _d S r; )rM r? )rc r8 rr r2 r2 r3 �resolve_through_modelo s zBManyToManyField.contribute_to_class.<locals>.resolve_through_modelrq F��reverse)rM rM r8 r- r0 ra rH rd r1 r� r� rF r r� r? rA rk rK r rb r r rG r^ )r* r� rb r? ro rK r2 r3 r O s2 �� � ��z#ManyToManyField.contribute_to_classc s� | j �� s.|jjjs.t||�� t| j dd�� t| j |d�| _ t| j |d�| _ t| j |d�| _ t| j |d�| _t| j |d�� � fdd�| _t| j |d���fdd�| _d S ) NTrp r� rb rM c s � � j S r; �rw r2 )� get_m2m_relr2 r3 �<lambda>� r: z=ManyToManyField.contribute_to_related_class.<locals>.<lambda>c s � � j S r; rr r2 )�get_m2m_reverse_relr2 r3 rt � r: )rM rd rO r0 rk r rt r r rl Zm2m_column_namern Zm2m_reverse_namer_ r` Zm2m_target_field_nameZ m2m_reverse_target_field_namer r2 )rs ru r3 r� � s* �� ���z+ManyToManyField.contribute_to_related_classc C s d S r; r2 rN r2 r2 r3 r� � s z'ManyToManyField.set_attributes_from_relc C s" |j d u rg S tt|| j��� �S r; )r� �listr� r� �allr� r2 r2 r3 �value_from_object� s z!ManyToManyField.value_from_objectc C s t || j��|� d S r; )r� r� �setr; r2 r2 r3 r= � s z ManyToManyField.save_form_datar+ c sd t j| jjj�|�d�|�}|�d�d urR|d }t|�r@|� }dd� |D �|d< t� j f i |��S )N)r, r- �initialc S s g | ] }|j �qS r2 )r� )r5 �ir2 r2 r3 r9 � r: z-ManyToManyField.formfield.<locals>.<listcomp>) r ZModelMultipleChoiceFieldrM r8 r/ r r� r� rF r� )r* r r? r� rz rK r2 r3 r� � s ��zManyToManyField.formfieldc C s d S r; r2 rx r2 r2 r3 r0 � s zManyToManyField.db_checkc C s d S r; r2 rx r2 r2 r3 ry � s zManyToManyField.db_typec C s d d d�S )N)r2 rP r2 rx r2 r2 r3 r3 � s z ManyToManyField.db_parameters) NNNNNNTNT)N)FN)N)N)&r� r� r� r� rv r� r� r� r' r� rc r9 rG rP r rQ rP rR r� rb r� r r� r� r� rG rl rn r r� r� rx r= r� r0 ry r3 r� r2 r2 rK r3 rL sV �; ( g4 ( 1 rL )Er r� r �djangor Z django.appsr Z django.confr r Z django.corer r rF r r Zdjango.db.backendsr Zdjango.db.modelsr Zdjango.db.models.constantsr Zdjango.db.models.deletionr r r Z django.db.models.query_utilsr Zdjango.db.models.utilsr Zdjango.utils.functionalr Zdjango.utils.translationr rc r" r Zmixinsr Zrelated_descriptorsr r r r r r Zrelated_lookupsr r r! r" r# r$ r% Zreverse_relatedr& r' r( r) r- r4 rA rB r� Zregister_lookupr r: rK rL r2 r2 r2 r3 �<module> sV $ + { )29