File: //lib/python3/dist-packages/django/db/models/fields/__pycache__/related.cpython-310.pyc
o
3�a2 � @ 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�rd|vrd| 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)� scope_model�relation� r4 �A/usr/lib/python3/dist-packages/django/db/models/fields/related.py�resolve_relation% s
r6 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 r4 )r6 )�.0�rel��modelr4 r5 �
<listcomp>M s z*lazy_related_operation.<locals>.<listcomp>c s s � | ]}t |�V qd S �Nr )r7 �mr4 r4 r5 � <genexpr>N � � z)lazy_related_operation.<locals>.<genexpr>)r0 r �lazy_model_operationr )�functionr: �related_models�kwargs�models�
model_keysr r4 r9 r5 �lazy_related_operation> s rF c s� e Zd ZdZdZdZdZdZedd� �Z � fdd�Z
dd� Z d d
� Z d d � Z
d
d� Zdd� Zdd� Zd+� fdd� Z� fdd�Zdd� Zdd� Zedd � �Zd d � Zd d � Zd!d"� Z� fd#d$�Zd%d&� Zed'd(� �Z d)d*� Z � Z S ),� RelatedFieldz3Base class that all relational fields inherit from.Fc C s t �� | jjS r< )r �check_models_ready� remote_fieldr: �r* r4 r4 r5 �
related_model\ s zRelatedField.related_modelc s> g t � jdi |���| �� �| �� �| �� �| �� �| �� �S �Nr4 )�super�check� _check_related_name_is_valid�"_check_related_query_name_is_valid� _check_relation_model_exists�#_check_referencing_to_swapped_model�_check_clashes�r* rC �� __class__r4 r5 rN b s ������zRelatedField.checkc C sl dd l }| jj}|d u rg S |�|� o|�� }|s4|�d�s4tjd| 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) �keywordrI � related_name� iskeyword� isidentifier�endswithr �Errorr: r0 � object_name�name)r* r\ r] � is_valid_idr4 r4 r5 rO l s$ ����
z)RelatedField._check_related_name_is_validc C sl | j �� rg S | �� }g }|�d�r |�tjd| d| dd�� t|v r4|�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)rI � is_hidden�related_query_namer` �appendr ra r
)r* �rel_query_name�errorsr4 r4 r5 rP s6
���
���
z/RelatedField._check_related_query_name_is_validc C sh | j j| jj�� v}t| j jt�}|r| j jn| j jjj}|r2|s'| j jjj s2t
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[ ) rI r: �optsr �
get_modelsr. r/ r0 rb �swappedr ra )r* �rel_is_missing�
rel_is_string�
model_namer4 r4 r5 rQ � s ���z)RelatedField._check_relation_model_existsc C s^ | j j| jj�� vr-t| j jt�s-| j jjjr-t 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 )
rI r: rl r rm r. r/ r0 rn r ra �label� swappablerJ r4 r4 r5 rR � s �
�
��� z0RelatedField._check_referencing_to_swapped_modelc s� ddl m} g }� jj}t� jj|�sg S � jjj}� j�� }� j�� }� �� }d|j � j
f }|j |j } | D ]>}
d|j |
j
f } |s]|
j
|kr]|�
tjd|| f d| |f � dd�� |
j
|krv|�
tjd|| f d| |f � d d�� q8� fd
d �|jD �} | D ]C}
d|
jjj |
jj
f } |s�|
�� |kr�|�
tjd || f d
|| f � dd�� |
�� |kr�|�
tjd|| f d
|| f � dd�� q�|S )z.Check accessor and reverse query name clashes.r )� ModelBaser, z7Reverse accessor for '%s' clashes with field name '%s'.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)r7 �rrJ r4 r5 r> � s � z.RelatedField._check_clashes.<locals>.<genexpr>zAReverse accessor for '%s' clashes with reverse accessor for '%s'.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)�django.db.models.basert r: r0 r. rI rf �get_accessor_namerg rr rc �fields� many_to_manyrh r ra �related_objectsrK rv ) r* rt rj rl �rel_opts�
rel_is_hidden�rel_nameri �
field_name�potential_clashes� clash_field�
clash_namer4 rJ r5 rS � s�
���
����
�
���
����� zRelatedField._check_clashesc C � d S r< r4 �r* r r4 r4 r5 �db_type � zRelatedField.db_typec s� t � j||fd|i|�� |j| _|jjsc| jjr | jj}n| jj}|r;||j� � |jj
� � |jj � � d� }|| j_| jj rS| jj |j� � |jj � � d� }|| j_ dd� }t
||| jj| d� d S d S )N� private_only)�classrq r1 )r� r1 c S s ||j _|�|| � d S r< )rI r: �do_related_class)r: �relatedrv r4 r4 r5 �resolve_related_class; s z?RelatedField.contribute_to_class.<locals>.resolve_related_classru )rM �contribute_to_classr0 rl �abstractrI r] �default_related_name�__name__�lowerrq r1 rg rF r: )r* �clsrc r� rC r] rg r� rU r4 r5 r� ! s,
�
��z RelatedField.contribute_to_classc sb t � �� \}}}}| jjr| jj|d< | jjd ur | jj|d< | jjd ur+| jj|d< ||||fS )N�limit_choices_tor] rg )rM � deconstructrI r� r] rg �r* rc �path�argsrC rU r4 r5 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)rc �getattr�attname)r7 re �rh_field�rZ r* r4 r5 �
<dictcomp>R s ��z;RelatedField.get_forward_related_filter.<locals>.<dictcomp>��related_fields�r* rZ r4 r� r5 �get_forward_related_filterJ s �z'RelatedField.get_forward_related_filterc sX � fdd�| j D �}| �� �}tdi |��}t|t�r$|tdi |��@ S |r*||@ 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 i | ] \}}|j t� |j ��qS r4 )r� r� )r7 �lh_fieldr� �rZ r4 r5 r� ^ s ��z;RelatedField.get_reverse_related_filter.<locals>.<dictcomp>Nr4 )r� �get_extra_descriptor_filterr r. �dict)r* rZ � base_filter�descriptor_filter�base_qr4 r� r5 �get_reverse_related_filterW s
�
z'RelatedField.get_reverse_related_filterc C s8 | j rt| 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) rs r. rI r: r/ r0 rr r �get_swappable_settings_name)r* � to_stringr4 r4 r5 �swappable_settingj s
z RelatedField.swappable_settingc C sL | j p| jjjjd | jjjjj | _ | jd u r | jjjj| _| j�� d S )Nre )rc rI r: r0 rq �pk� verbose_name�set_field_namerJ r4 r4 r5 �set_attributes_from_rely s �
z$RelatedField.set_attributes_from_relc C s | � � | �|| j� d S r< )r� �contribute_to_related_classrI )r* �otherr� r4 r4 r5 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.
)�callablerI r� rJ r4 r4 r5 �get_limit_choices_to� s
z!RelatedField.get_limit_choices_toc sB i }t | jd�r| jj}|�d|i� |�|� t� jdi |��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.
�get_related_fieldr� Nr4 )�hasattrrI r� �updaterM � formfield)r* rC �defaultsr� rU r4 r5 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.
)rI rg r] rl rq rJ r4 r4 r5 rg � s z RelatedField.related_query_namec C s, | � � d j}t|�dkrt�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 )�
get_path_info�
target_fields�lenr �
FieldError)r* r� r4 r4 r5 � target_field� s �zRelatedField.target_fieldc C s | j S r< �rc rJ r4 r4 r5 �get_cache_name� s zRelatedField.get_cache_name�F) r� �
__module__� __qualname__�__doc__� one_to_many�
one_to_oner{ � many_to_oner rK rN rO rP rQ rR rS r� r� r� r� r� �propertyr� r� r� r� r� rg r� r� �
__classcell__r4 r4 rU r5 rG S s:
b
rG c s4 e Zd ZdZdZdZdZdZdZe Z
e Z e
Z d4� fdd� Z� fdd�Zd d
� Zd d � Z� fd
d�Zdd� Zedd� �Zedd� �Zedd� �Zedd� �Zdd� Zdd � Ze d d � �Z � fd d �Z d5d!d"�Z d#d$� Z d%d&� Z!d'd(� Z"d6d)d*�Z#d6d+d,�Z$e%e&j'dd-�d.d/� ��Z(d5� fd0d1� Z)d2d3� Z*� Z+S )7�
ForeignObjectzS
Abstraction of the ForeignKey relation to support multi-column relations.
FTNc sL |d u r| j | ||||| |d�}t� jdd|i| �� || _|| _|
| _d S )N�r] rg r� � parent_link� on_deleter8 r4 )� rel_classrM �__init__� from_fields� to_fieldsrs ) r* �tor� r� r� r8 r] rg r� r� rs rC rU r4 r5 r� � s �
zForeignObject.__init__c �& g t � jdi |���| �� �| �� �S rL )rM rN �_check_to_fields_exist�_check_unique_targetrT rU r4 r5 rN � � ���zForeignObject.checkc C sz t | jjt�r g S g }| jD ],}|r:z
| jjj�|� W q tjy9 |� t
j d|| jjjj f | dd�� Y qw q|S )Nz:The to_field '%s' doesn't exist on the related model '%s'.z fields.E312rk )
r. rI r: r/ r� r0 � get_fieldr �FieldDoesNotExistrh r ra rr )r* rj �to_fieldr4 r4 r5 r� � s(
�����
z$ForeignObject._check_to_fields_existc sH t | jjt�}|s | jsg S z| j W n tjy g Y S w | js%g S dd� | jjj� � D �}|�
dd� | jjjj D �� |�
dd� | jjjj D �� dd� | jD �� t
� fdd�|D ��}|s�t| j�dkr�d �d
d� | jD ��}| jjj}tjd ||f d | d
d�gS |s�| jd j}| jjj}tjd||f d| dd�gS g S )Nc S s$ h | ]}t |d d�rt|jg��qS )�uniqueF)r� � frozensetrc �r7 �fr4 r4 r5 � <setcomp>
s
�
�z5ForeignObject._check_unique_target.<locals>.<setcomp>c S s h | ]}t |��qS r4 )r� )r7 �utr4 r4 r5 r� s ��c S s h | ]}t |j��qS r4 )r� rz )r7 �ucr4 r4 r5 r� s ��c S s h | ]}|j �qS r4 r� r� r4 r4 r5 r� � c 3 s � | ]}|� kV qd S r< r4 )r7 �u��foreign_fieldsr4 r5 r> r? z5ForeignObject._check_unique_target.<locals>.<genexpr>r �, c s s � | ]}d |j V qdS )z'%s'Nr� )r7 � rel_fieldr4 r4 r5 r> 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. rI r: r/ �requires_unique_target�foreign_related_fieldsr r� r0 �
get_fieldsr� �unique_together�total_unique_constraints�anyr� �joinr� r ra rc )r* rp �unique_foreign_fields�has_unique_constraint�field_combinationrq r� r4 r� r5 r� � s`
� �
�
�
�
���
���z"ForeignObject._check_unique_targetc s t � �� \}}}}| jj|d< | j|d< | j|d< | jjr#| jj|d< t| jjt �rMd| jjv rD| jj�
d�\}}d||� � f |d< n| jj� � |d< n| jjj j
|d< | j}|d ur~t|d d�ru|d j|krutd |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))rM r� rI r� r� r� r� r. r: r/ �splitr� r0 � label_lowerr� r� r� �
ValueErrorr )r* rc r� r� rC r1 rq r� rU r4 r5 r� @ s4
��� zForeignObject.deconstructc C s� | j r
t| j �t| j�krtd��t| jjt�r td| jj ��g }tt| j ��D ]1}| j | }| j| }|t kr;| n| j
� |�}|d u rK| jjj j
n| jjj � |�}|�||f� q)|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. rI r: r/ �ranger- rl r� r0 r� rh )r* r� �index�from_field_name�
to_field_name�
from_fieldr� r4 r4 r5 �resolve_related_fieldsc s"
�
��z$ForeignObject.resolve_related_fieldsc C s | � � S r< )r� rJ r4 r4 r5 r� v s z ForeignObject.related_fieldsc C s dd� | j D �S )Nc S s g | ]\}}||f�qS r4 r4 �r7 � lhs_field� rhs_fieldr4 r4 r5 r; | s z8ForeignObject.reverse_related_fields.<locals>.<listcomp>r� rJ r4 r4 r5 �reverse_related_fieldsz s z$ForeignObject.reverse_related_fieldsc C � t dd� | jD ��S )Nc s s � | ]\}}|V qd S r< r4 r� r4 r4 r5 r> � r? z5ForeignObject.local_related_fields.<locals>.<genexpr>��tupler� rJ r4 r4 r5 �local_related_fields~ � z"ForeignObject.local_related_fieldsc C r� )Nc s s � | ] \}}|r|V qd S r< r4 r� r4 r4 r5 r> � s � z7ForeignObject.foreign_related_fields.<locals>.<genexpr>r rJ r4 r4 r5 r� � r z$ForeignObject.foreign_related_fieldsc C � | � || j�S r< )� get_instance_value_for_fieldsr �r* �instancer4 r4 r5 �get_local_related_value� � z%ForeignObject.get_local_related_valuec C r r< )r r� r r4 r4 r5 �get_foreign_related_value� r z'ForeignObject.get_foreign_related_valuec C sb g }| j }|D ]%}|jr#|�|j�}|r |js |jj jr#|�| j� q|�t| |j�� qt |�S r< )
r0 � primary_key�get_ancestor_linkr: r� rh r� r� r� r )r rz �retrl rv �possible_parent_linkr4 r4 r5 r � s �� z+ForeignObject.get_instance_value_for_fieldsc s t � �� \}}|d fS r< )rM �get_attname_column�r* r� �columnrU r4 r5 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� r4 r4 r5 r> � s � z4ForeignObject.get_joining_columns.<locals>.<genexpr>)r� r� r )r* � reverse_join�sourcer4 r4 r5 �get_joining_columns� s z!ForeignObject.get_joining_columnsc C s | j dd�S )NT)r )r rJ r4 r4 r5 �get_reverse_joining_columns� � 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.
r4 r r4 r4 r5 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.
Nr4 )r* � where_class�alias�
related_aliasr4 r4 r5 �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� �
join_field�m2m�direct�filtered_relation)rI r: r0 r r� �r* r! rl r r4 r4 r5 r� � s
�zForeignObject.get_path_infoc C �4 | j j}| jj j}t|||jf| j| j d|d�gS �z6Get path from the related model to this field's model.Fr �r: r0 rI r r� r� r" r4 r4 r5 �get_reverse_path_info� �
�z#ForeignObject.get_reverse_path_info)�maxsizec C s8 t �| �}|d |�t�d � }dd� |D �}| �|�S )Nr c S s g | ] }|j �d i ��qS )�
class_lookups)�__dict__�get)r7 �parentr4 r4 r5 r; � s z-ForeignObject.get_lookups.<locals>.<listcomp>)�inspect�getmror� r� � merge_dicts)r� �basesr) r4 r4 r5 � get_lookups� s
zForeignObject.get_lookupsc s2 t � j||fd|i|�� t|| j| �| �� d S )Nr� )rM r� �setattrrc � forward_related_accessor_class)r* r� rc r� rC rU r4 r5 r� � s z!ForeignObject.contribute_to_classc C sX | j �� s&|jjjs(t|jj|�� | �|�� | j j r*|jj
� | j j � d S d S d S d S r< ) rI rf rK r0 rn r2 �concrete_modelry �related_accessor_classr� �related_fkey_lookupsrh �r* r� r� r4 r4 r5 r� � s �z)ForeignObject.contribute_to_related_class)NNNNFTr� r< ),r� r� r� r� r{ r� r� r� r� r r5 r r3 r& r� r� rN r� r� r� r� r r� r� r r� r r
� staticmethodr r r r r� r r� r& � classmethod� functools� lru_cacher1 r� r� r� r4 r4 rU r5 r� � sV � C#
r� c sD e Zd ZdZeZdZdZdZdZ e
Z dZ de
d�iZe
d�Z d9� fdd � Z� fd
d �Zd d
� Zdd� Z� fdd�Zdd� Zedd� �Zd:dd�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 n ty t|t�s J d| jj|tf ��Y n w |p*|j jo*|j jj }t
|�s3t d��| j | |||||||d�| d< | �
dd� t� j||ftg|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� r8 �db_indexT)r� r� )r0 rq �AttributeErrorr. r/ rV r� r- r� rc r� � TypeErrorr� �
setdefaultrM r� �
db_constraint)
r* r� r� r] rg r� r� r� rB rC rU r4 r5 r� sB ����
� ���
zForeignKey.__init__c r� rL )rM rN �_check_on_delete�
_check_uniquerT rU r4 r5 rN B r� zForeignKey.checkc C sX t | jdd �}|tkr| jstjdd| dd�gS |tkr*| �� s*tjdd| dd�gS g 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� rI r �nullr ra r � has_default)r* r� r4 r4 r5 rC I s$ ���� zForeignKey._check_on_deletec K s | j r
tjdd| 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 �WarningrT r4 r4 r5 rD ` s ����zForeignKey._check_uniquec s� t � �� \}}}}|d= |d= | jr|d= nd|d< | jdur$| j|d< t| jjdd �}| jjrC|r=|jrC| jj|jj krC| jj|d< ||||fS ) Nr� r� r> FTrB r0 r� )
rM r� r> rB r� rI r: r� r� rc )r* rc r� r� rC �to_metarU r4 r5 r� j s"
�� zForeignKey.deconstructc C � | j �|�S r< )r� � to_python�r* �valuer4 r4 r5 rJ | r zForeignKey.to_pythonc C s
| j d S )Nr )r� rJ r4 r4 r5 r� s
zForeignKey.target_fieldc C r# r$ r% r" r4 r4 r5 r& � r' z ForeignKey.get_reverse_path_infoc s� | j jrd S t� �||� |d u rd S tj| j j|d�}| j jj�|�j di | j j
|i��}|� | � � �}|�
� sOtj| jd d| j jjj|| j j
|d�d��d S )N)r r= )r: r� rv rL )�code�paramsr4 )rI r� rM �validater
� db_for_readr: �
_base_manager�using�filterr� �complex_filterr� �existsr �ValidationError�error_messagesr0 r� )r* rL �model_instancerR �qsrU r4 r5 rO � s&
� ���zForeignKey.validatec s^ t � �� }|D ]%\}}|r,|j| jjjjkr,t�d| jjj| j |j | jjjjjjf ��q|S )Nz>'%s.%s' refers to field '%s' which is not local to model '%s'.)
rM r� r: rI r0 r4 r r� rr rc )r* r� r� r� rU r4 r5 r� � s
���� z!ForeignKey.resolve_related_fieldsc C s
d| j S )Nz%s_idr� rJ r4 r4 r5 � get_attname� �
zForeignKey.get_attnamec C s | � � }| jp|}||fS r< )rZ � db_columnr r4 r4 r5 r � s
z ForeignKey.get_attname_columnc s* t � �� }t|| jj�rt|| jj�S |S )z6Return the to_field if the default value is an object.)rM � get_defaultr. rI r: r� r� r� )r* �
field_defaultrU r4 r5 r] � s
zForeignKey.get_defaultc C s4 |d u s|dkr| j jr|jjrd S | j j||d�S )N� �r )r� �empty_strings_allowed�features�!interprets_empty_strings_as_nulls�get_db_prep_save)r* rL r r4 r4 r5 rd � s ��zForeignKey.get_db_prep_savec C s | j �|||�S r< )r� �get_db_prep_value)r* rL r �preparedr4 r4 r5 re � s z ForeignKey.get_db_prep_valuec C rI r< )r� �get_prep_valuerK r4 r4 r5 rg � r zForeignKey.get_prep_valuec s0 t � �||� | jjd u r|jjj| j_d S d S r< )rM r� rI r� r0 r� rc r7 rU r4 r5 r� � s �z&ForeignKey.contribute_to_related_class�rR c s^ t | jjt�rtd| j| jjf ��t� jdi 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� �blankr4 )r. rI r: r/ r� rc rM r� r �ModelChoiceField�_default_managerrR r� rk )r* rR rC rU r4 r5 r� � s �
��
�zForeignKey.formfieldc C � g S r< r4 r� r4 r4 r5 �db_check� � zForeignKey.db_checkc C s | j j|d�S )Nr` )r� � rel_db_typer� r4 r4 r5 r� � r zForeignKey.db_typec C s | � |�| �|�d�S �N)�typerN )r� ro r� r4 r4 r5 �
db_parameters� � zForeignKey.db_parametersc C s |s t |t�r d S |S r< )r. r/ )r* rL �
expressionr r4 r4 r5 �convert_empty_strings� s z ForeignKey.convert_empty_stringsc s$ t � �|�}|jjr|| jg7 }|S r< )rM �get_db_convertersrb rc rw )r* r �
convertersrU r4 r5 rx � s z ForeignKey.get_db_convertersc sF |d u r | j }t|t�r |j }|| u rtd��t|t�s t� �||�S )Nz Cannot resolve output_field.)r� r. r< r� rM �get_col)r* r � output_fieldrU r4 r5 rz � s
�zForeignKey.get_col)NNNFNTr< r� )*r� r� r� r� r �descriptor_classr{ r� r� r� r( r� ra re �default_error_messages� descriptionr� rN rC rD r� rJ r� r� r& rO r� rZ r r] rd re rg r� r� ro r� rt rw rx rz r� r4 r4 rU r5 r< sP �� (
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� )rM r� )r* r� r� r� rC rU r4 r5 r� s zOneToOneField.__init__c s, t � �� \}}}}d|v r|d= ||||fS )Nr� )rM r� r� rU r4 r5 r� s zOneToOneField.deconstructc s | j jrd S t� jdi |��S rL )rI r� rM r� rT rU r4 r5 r� ! s zOneToOneField.formfieldc C sL t || jj�rt|| j|� d S t|| j|� |d u r$t|| j|� d S d S r< )r. rI r: r2 rc r� �r* r �datar4 r4 r5 �save_form_data& s �z OneToOneField.save_form_datac K rn r< r4 rT r4 r4 r5 rD 0 s zOneToOneField._check_uniquer< )r� r� r� r� r{ r� r� r� r r5 r r3 r) r� re r~ r� r� r� r� rD r� r4 r4 rU r5 r s
r c C s ddl m} dd� }t|| jj�}d|jj| jf }t||||� t |�d }|jj
}||kr7d| }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 )rD c S s | j jp|j j|j _d S r< )r0 �managed)r: r� �throughr4 r4 r5 � set_managed8 s z;create_many_to_many_intermediary_model.<locals>.set_managed�%s_%sr zto_%szfrom_%s�Metar4 z %(from)s-%(to)s relationship)�fromr� z %(from)s-%(to)s relationships)�db_table� auto_createdr1 �
db_tablespacer� r� �verbose_name_pluralr r� z%s+)r] r� rB r� )� django.dbrD r6 rI r: r0 rb rc rF r rq rs �_get_m2m_db_tabler1 r� re r �Modelr� r< rB r ) rv �klassrD r� �to_modelrc r� �from_�metar4 r4 r5 �&create_many_to_many_intermediary_model5 sL
�
���r� c s e Zd ZdZdZdZdZdZeZ e
d�Z d3� fdd� Z � fdd �Z
d
d � Zd d
� Zd4dd�Zdd� Z� fdd�Zd5dd�Zd4dd�Zd4dd�Zdd� Zd d � Zd d � Z� fd d!�Zd"d#� Zd$d%� Zd&d'� Z d(d)� Z dd*�� fd+d,�
Z d-d.� Z d/d0� Z d1d2� Z!� Z"S )6�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 n ty t|t�s J d| jj|tf ��Y nw |d u r'|tk}|d ur3| d u s3J d��| j| ||||||||d� | d< d| v | _t � j
di | �� | | _ |
| _ 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.)r] rg r� � symmetricalr� �through_fieldsrB r8 rE r4 )
r0 r? r. r/ rV r� r- r� � has_null_argrM r� r� rs ) r* r� r] rg r� r� r� r� rB r� rs rC rU r4 r5 r� x s:
���
�
�
zManyToManyField.__init__c sV g t � jdi |���| jdi |���| jdi |���| jdi |���| jdi |���S rL )rM rN rD �_check_relationship_model�_check_ignored_options�_check_table_uniquenessrT rU r4 r5 rN � s �����zManyToManyField.checkc K s | j r tjd| dd�gS g S )Nz"ManyToManyFields cannot be unique.z fields.E330rk )r� r ra rT r4 r4 r5 rD � s ��z ManyToManyField._check_uniquec K sr g }| j r|�tjd| dd�� | jr |�tjd| dd�� | jjr7| jjr7| jjjj s7|�tjd| dd�� |S )Nz&null has no effect on ManyToManyField.z fields.W340rk z,ManyToManyField does not support validators.z fields.W341zGlimit_choices_to has no effect on ManyToManyField with a through model.z fields.W343)
r� rh r rG � _validatorsrI r� r� r0 r� )r* rC �warningsr4 r4 r5 r� � s8 ����
��� z&ManyToManyField._check_ignored_optionsc s� t | jjd�rd| jjjj| jjjf }n| jj}g }| jj| jjjdd�vr5|� t
j d| | dd�� nň d us=J d��t � | jj
��� jj}t�t�rP�}n�jj}| jjjj}� �k}|r�t� fd d
�| jjjjD ��} | d kr�| jjs�|� t
j d | |f d
| jjdd�� npt� fdd
�| jjjjD ��}
t�fdd
�| jjjjD ��} |
dkr�| jjs�|� t
j d| |f dt|f | dd�� | dkr�| jjs�|� t
j d| |f dt|f | dd�� |
dks�| dkr�|� t
j d| ||f | jjdd�� | jjd u�r�t| jj�d k�r| jjd �r| jjd �s(|� t
j d| d | d d�� |S � d u�s1J d��� | jj| jj
} }
}| jjd d � \}}|| f||ffD ]�\}}g }|
jjD ]}t |d ��rqt|jd d �|k�rq|� |j� �qY|�r�d |jjd!�|�f }nd }z|
j�|�}W n tj�y� |� t
j d"||f || d#d�� Y �qOw t |d ��r�t|jd d �|k�s�|� t
j d$|
jj||jjf || d%d�� �qO|S )&Nr0 r, T��include_auto_createdzYField specifies a many-to-many relation through model '%s', which has not been installed.z fields.E331rk zvManyToManyField with intermediate tables cannot be checked if you don't pass the model where the field is attached to.c 3 �" � | ] }� t |jd d�kV qdS �r: N�r� rI �r7 rv ��
from_modelr4 r5 r> � �
� �
�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 r� r� r� r� r� r4 r5 r>
r� c 3 r� r� r� r� )r� r4 r5 r> r� 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.E337rI r: 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� rI r� r0 r1 r� rl r rm rh r ra r6 r: rb r. r/ �sumrz r� r- r� r� rc r� r� r r� )r* r� rC �qualified_model_namerj �from_model_name�
to_model_name�relationship_model_name�self_referential� seen_self� seen_from�seen_tor r� �target�source_field_name�target_field_namer� rK �possible_field_namesr� rY rv r4 )r� r� r5 r� � s4 ����
�
�����
�
���������������
�
����B �� � ����
�� ���� z)ManyToManyField._check_relationship_modelc s� t � jjt�s
� jjjjsg S � fdd�� jjjdd�D �}� � � }|�
|�}|rq|jj � jjjj krq|jj rJdd� }|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 r4 )rI r� r0 r� r� )r7 r: rJ r4 r5 r� � s
�z;ManyToManyField._check_table_uniqueness.<locals>.<dictcomp>Tr� c S s, | j jj jD ]
}|jj| u r|j S qd S r< )r0 r� r{ rI r� rc )r: rv r4 r4 r5 �_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. rI r� r/ r0 r� rl r rm � m2m_db_tabler+ r4 r� rr r �DATABASE_ROUTERSr rG ra ) r* rC �registered_tablesr� r: r� rl � clashing_obj� error_class�error_id�
error_hintr4 rJ r5 r� � s>
�
�� ��� z'ManyToManyField._check_table_uniquenessc s t � �� \}}}}| jd ur| j|d< | jjdur | jj|d< t| jjt�r-| jj|d< n| jjjj |d< t
| jdd �d urZt| jj t�rL| jj |d< n| jj jj sZ| jj jj |d< | j
}|d ur�t|d d�rz|d j|krztd|d j|f ��t|d |�|d< ||||fS )Nr� TrB r� r� r� ztCannot deconstruct a ManyToManyField pointing to a model that is swapped in place of more than one model (%s and %s))rM r� r� rI rB r. r: r/ r0 rr r� r� r� r� r� r� r� r )r* rc r� r� rC r� rU r4 r5 r� � s6
��� zManyToManyField.deconstructc C s� | j j}|j�| �� �}|j�| �� �}|r |�� }|�|�}n |�� }|�|�}|d j}|d j } || u r:g }
nt
|j | j �rH|� | j �}
n| �
|j �}
g |�|
�|�S )z1Called by both direct and indirect m2m traversal.r� r )rI r� r0 r� �m2m_field_name�m2m_reverse_field_namer& r� r r �
issubclassr: �get_path_to_parent�get_path_from_parent) r* r r! � int_model�
linkfield1�
linkfield2�
join1infos�
join2infos� join1_final�
join2_initial�intermediate_infosr4 r4 r5 �_get_path_info� s
z ManyToManyField._get_path_infoc C � | j d|d�S )NT�r r! �r� �r* r! r4 r4 r5 r� � r z ManyToManyField.get_path_infoc C r� )NFr� r� r� r4 r4 r5 r& r z%ManyToManyField.get_reverse_path_infoc C sL | j jdur | j jjjS | jr| jS dt�|j�| jf }t�|tj �
� �S )zg
Function that can be curried to provide the m2m table name for this
relation.
Nr� ) rI r� r0 r� r � strip_quotesrc �
truncate_namer �ops�max_name_length)r* rl �m2m_table_namer4 r4 r5 r� s z!ManyToManyField._get_m2m_db_tablec C s� d| }t | |�rt| |�S | jjdur| jjd }nd}| jjjjD ]%}|jrH|jj|j krH|du s8||j
krHt | |t||�� t| |� S q#dS )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� rI r� r� r0 rz � is_relationr: rK rc r2 )r* r� �attr�
cache_attr�link_field_namer� r4 r4 r5 �
_get_m2m_attr s
��z ManyToManyField._get_m2m_attrc C s� d| }t | |�rt| |�S d}| jjdur | jjd }nd}| jjjjD ]:}|jr_|jj|jkr_|du rK|j |jkrK|rHt
| |t||�� nd}q%|du sT||j kr_t
| |t||�� nq%t| |�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� rI r� r� r0 rz r� r: rK r2 rc )r* r� r� r� �foundr� r� r4 r4 r5 �_get_m2m_reverse_attr" s&
�
z%ManyToManyField._get_m2m_reverse_attrc s� | j jr| j jtks| j j|jjkrd| | j _n| j �� r,d|jj|j �
� |f | j _t � j ||fi |�� |jj
sY| j jrNdd� }t||| j j| d� n |jjsYt| |�| j _t|| jt| j dd�� t| j|j�| _d S )Nz%s_rel_+z _%s_%s_%s_+c S s ||j _d S r< )rI r� )re r: rv r4 r4 r5 �resolve_through_model_ r zBManyToManyField.contribute_to_class.<locals>.resolve_through_modelru F��reverse)rI r� r: r- r0 rb r] rf r1 r� r� rM r� r� r� rF rn r� r2 rc r r r� r� )r* r� rc rC r� rU r4 r5 r� @ s&
�z#ManyToManyField.contribute_to_classc s� | j �� s|jjjst||�� 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 ) NTr� r rc rI c � � � j S r< �r� r4 )� get_m2m_relr4 r5 �<lambda>y � z=ManyToManyField.contribute_to_related_class.<locals>.<lambda>c r� r< r� r4 )�get_m2m_reverse_relr4 r5 r� { r� )rI rf rK r0 rn r2 ry r r r� �m2m_column_namer� �m2m_reverse_namer� r� �m2m_target_field_name� m2m_reverse_target_field_namer7 r4 )r� r� r5 r� k s z+ManyToManyField.contribute_to_related_classc C r� r< r4 rJ r4 r4 r5 r� } rp z'ManyToManyField.set_attributes_from_relc C s" |j d u rg S tt|| j��� �S r< )r� �listr� r� �allr� r4 r4 r5 �value_from_object� s "z!ManyToManyField.value_from_objectc C s t || j��|� d S r< )r� r� �setr� r4 r4 r5 r� � ru z ManyToManyField.save_form_datarh c sd t j| jjj�|�d�|�}|�d�d ur)|d }t|�r |� }dd� |D �|d< t� j di |��S )N)ri rj �initialc S s g | ]}|j �qS r4 )r� )r7 �ir4 r4 r5 r; � r� z-ManyToManyField.formfield.<locals>.<listcomp>r4 )
r �ModelMultipleChoiceFieldrI r: rm rR r+ r� rM r� )r* rR rC r� r� rU r4 r5 r� � s ��zManyToManyField.formfieldc C r� r< r4 r� r4 r4 r5 ro � rp zManyToManyField.db_checkc C r� r< r4 r� r4 r4 r5 r� � r� zManyToManyField.db_typec C s
d d d�S rr r4 r� r4 r4 r5 rt � r[ z ManyToManyField.db_parameters) NNNNNNTNTr< )FN)#r� r� r� r� r{ r� r� r� r' r� re r~ r� rN rD r� r� r� r� r� r� r& r� r� r� r� r� r� r� r� r� ro r� rt r� r4 r4 rU r5 r� d sF
� &
! B +
$
+r� )Er: r- r �djangor � django.appsr � django.confr r � django.corer r r� r r
�django.db.backendsr �django.db.modelsr �django.db.models.constantsr
�django.db.models.deletionr r r � django.db.models.query_utilsr �django.db.models.utilsr �django.utils.functionalr �django.utils.translationr re r_ r �mixinsr �related_descriptorsr r r r r r �related_lookupsr r r! r" r# r$ r% �reverse_relatedr& r' r( r) r- r6 rF rG r� �register_lookupr< r r� r� r4 r4 r4 r5 �<module> sV $ k
@
2/