File: //lib/python3/dist-packages/django/db/models/__pycache__/options.cpython-310.pyc
o
3�a�� � @ s� d dl Z d dlZd dlZd dlmZ d dlmZ d dlmZ d dl m
Z
m Z d dl m
Z
d dlmZmZmZmZ d dlmZ d d lmZmZ d d
lmZ d d lmZ d d l m Z m Z d d
l m Z e!� Z"dZ#dZ$dZ%dd� Z&dd� Z'G dd� d�Z(dS )� N)� defaultdict)�apps)�settings)�FieldDoesNotExist�ImproperlyConfigured)� connections)� AutoField�Manager�OrderWrt�UniqueConstraint)�PathInfo)�
ImmutableList�
OrderedSet)�cached_property)�
import_string)�camel_case_to_spaces� format_lazy)�override� zyThe return type of '%s' should never be mutated. If you want to manipulate this list for your own use, make a copy first.)� verbose_name�verbose_name_plural�db_table�ordering�unique_together� permissions�
get_latest_by�order_with_respect_to� app_label�
db_tablespace�abstract�managed�proxy� swappable� auto_created�index_togetherr �default_permissions�select_on_save�default_related_name�required_db_features�required_db_vendor�base_manager_name�default_manager_name�indexes� constraintsc C sd z&| sW dS t | ttf�st�| d }t |ttf�s | f} tdd� | D ��W S ty1 | Y S w )z�
option_together can be either a tuple of tuples, or a single
tuple of two strings. Normalize it to a tuple of tuples, so that
calling code can uniformly expect that.
r r c s s � | ]}t |�V qd S �N)�tuple)�.0�otr r �:/usr/lib/python3/dist-packages/django/db/models/options.py� <genexpr>5 � � z%normalize_together.<locals>.<genexpr>)�
isinstancer/ �list� TypeError)�option_together�
first_elementr r r2 �normalize_together& s �r: c C s t |t| d�S )N)�warning)r
�IMMUTABLE_WARNING)�name�datar r r2 �make_immutable_fields_list< s r? c @ s� e Zd Zh d�Zh d�ZeZd\dd�Zedd� �Z edd � �Z
ed
d � �Z ed d
� �Z dd� Z
dd� Zdd� Zdd� Zdd� Zd]dd�Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zed%d&� �Zed'd(� �Zed)d*� �Zed+d,� �Z ed-d.� �Z ed/d0� �Z ed1d2� �Z ed3d4� �Z ed5d6� �Z!ed7d8� �Z"ed9d:� �Z#ed;d<� �Z$ed=d>� �Z%d?d@� Z&dAdB� Z'dCdD� Z(dEdF� Z)dGdH� Z*dIdJ� Z+dKdL� Z,edMdN� �Z-d^dPdQ�Z.d_dRdS�Z/ d`dTdU�Z0edVdW� �Z1edXdY� �Z2edZd[� �Z3dS )a�Options> �fields�managers� base_manager� managers_map� many_to_many�concrete_fields�default_manager�_forward_fields_map�local_concrete_fields> �
fields_map�_relation_tree�related_objectsNc C s� i | _ g | _g | _g | _g | _d | _d | _d | _d | _d | _ d| _
g | _ d| _ g | _
g | _g | _g | _d| _d| _g | _d | _|| _d | _d | _tj| _g | _d | _ || _ d | _ d | _ d| _ d| _!d| _"d | _#d | _$d | _%i | _&d| _'g | _(| j)| _*d | _+d S )N� F)�add�change�delete�viewT),�_get_fields_cache� local_fields�local_many_to_many�private_fields�local_managersr* r+ �
model_namer r r r �_ordering_clashr, r- r r$ r& r% r � object_namer r r r �DEFAULT_TABLESPACEr r( r) �meta�pk�
auto_fieldr r r! �proxy_for_model�concrete_modelr" �parentsr# �related_fkey_lookups� default_appsr r' )�selfr[ r r r r2 �__init__J sR
zOptions.__init__c C � d| j | jf S �N�%s.%s)r rY �rc r r r2 �label� � z
Options.labelc C re rf )r rW rh r r r2 � label_lower� rj zOptions.label_lowerc C s | j j�| j�S r. )r � app_configs�getr rh r r r2 �
app_config� s zOptions.app_configc C s
| j d uS r. )rn rh r r r2 � installed� s
zOptions.installedc C s� ddl m} ddlm} | |_|| _|j| _| j�� | _ t
| j�| _ i | _ | j
r�| j
j�� }| j
jD ]
}|�d�r<||= q2tD ]0}||v rWt| ||�|�� t| |�| j |< q?t| j
|�rot| |t| j
|�� t| |�| j |< q?t| j�| _t| j�| _t|jdd�s�dD ]}t| |g �}t| || �||�� q�| jd u r�td| j �| _t | j o�| j �| _ |i kr�t d d
�!|� ��ntd| j �| _| `
| j"s�d | j#| j f | _"|| j"|j$�%� �| _"d S d S ) Nr ��
connection)�
truncate_name�_r F> r, r- z{}sz)'class Meta' got invalid attribute(s): %s�,z%s_%s)&� django.dbrq �django.db.backends.utilsrr �_meta�model�__name__rY �lowerrW r r �original_attrsr[ �__dict__�copy�
startswith�
DEFAULT_NAMES�setattr�pop�getattr�hasattrr: r r$ �_format_names_with_classr r �boolr r rX r7 �joinr r �ops�max_name_length)rc �clsr= rq rr �
meta_attrs� attr_name�objsr r r2 �contribute_to_class� sP
� �
��zOptions.contribute_to_classc C sD g }|D ]}|� � }|j|jj�� |j�� d� |_|�|� q|S )z4App label/class name interpolation for object names.)r �class)�cloner= rw r rz ry �append)rc r� r� �new_objs�objr r r2 r� � s
� z Options._format_names_with_classc
C s� t | jdtj�}| jr | jjr t| j�}|j� d|j� d�}nd}|s*t|� d���zt |�}W n t
yI } z
|� d|� d�}t|�|�d }~ww t |t �sZt
d|� d |� d
���|S ) N�default_auto_field�.z.default_auto_field�DEFAULT_AUTO_FIELDz must not be empty.z refers to the module 'z ' that could not be imported.z
Primary key 'z' referred by z must subclass AutoField.)r� rn r r� �!_is_default_auto_field_overridden�type�
__module__� __qualname__r r � ImportError�
issubclassr �
ValueError)rc �
pk_class_path�app_config_class�source�pk_class�e�msgr r r2 �_get_default_pk_class� s6 �
�� �
��
�z Options._get_default_pk_classc s | j r?| j �zt�fdd�| jdd�D ��| _ W n ty( td| j�f ��w d| _tdd� |jj D ��s>|�
dt � � nd | _ | j d u r�| j
rmtt| j
�� ��� � fd d
�| j D �}|rc|d � d � _| �� � d S | �� }|d
d d d�}|�
d|� d S d S )Nc 3 s( � | ]}|j � ks|j� kr|V qd S r. )r= �attname�r0 �f)�queryr r2 r3 s � ��z#Options._prepare.<locals>.<genexpr>F��reverse�%s has no field named '%s')�_orderc s s � | ]}t |t�V qd S r. )r5 r
�r0 �fieldr r r2 r3
� � r� c s g | ]
}|j � j kr|�qS r �r= )r0 �fld)r� r r2 �
<listcomp> s z$Options._prepare.<locals>.<listcomp>r T�ID)r � primary_keyr# �id)r �next� _get_fields�
StopIterationr rY r �anyrw rS � add_to_classr
r\ r` �iter�valuesr� �setup_pkr� )rc rx �already_createdr� �autor )r� r� r2 �_prepare� s4
� ��
�zOptions._preparec C s | j �|� | �� d S r. )rV r� �
_expire_cache)rc �managerr r r2 � add_manager! s zOptions.add_managerFc C s� |r | j �|� n|jr|jrt�| j|� n t�| j|� | �|� |jrKt |j
d�rK|j
j rKz |j
j j j
dd� W n tyD Y nw | �
� d S | j
dd� d S )Nrx F)�forwardr� )rU r� � is_relationrE �bisect�insortrT rS r� r� � remote_fieldrx rw r� �AttributeError)rc r� �privater r r2 � add_field% s
� zOptions.add_fieldc C s$ | j s|jr|| _ d|_d S d S d S )NF)r\ r� � serialize)rc r� r r r2 r� C s
�zOptions.setup_pkc C s |j j| _|| _|j j| _dS )zb
Do the internal setup so that the current model is a proxy for
"target".
N)rw r\ r^ r )rc �targetr r r2 � setup_proxyH s
zOptions.setup_proxyc C s
d| j S )Nz<Options for %s>)rY rh r r r2 �__repr__Q s
zOptions.__repr__c C s | j S r. )rk rh r r r2 �__str__T s zOptions.__str__c s\ | j s | js | js dS t� t�rt� � | jr | j� jkS | jr,t � fdd�| jD ��S dS )z�
Return True if the model can/should be migrated on the `connection`.
`connection` can be either a real connection or a connection alias.
Fc 3 s � | ]
}t � j|d �V qdS )FN)r� �features)r0 �featrp r r2 r3 c s � �z&Options.can_migrate.<locals>.<genexpr>T)
r! �swappedr r5 �strr r) �vendorr( �all)rc rq r rp r2 � can_migrateW s
�zOptions.can_migratec C s6 t d��
t| j�W d � S 1 sw Y dS )z%Return the untranslated verbose name.N)r r� r rh r r r2 �verbose_name_rawg s
$�zOptions.verbose_name_rawc C s` | j r.tt| j d�}|r.z |�d�\}}W n ty | Y S w d||�� f | jkr.|S dS )a!
Has this model been swapped out for another? If so, return the model
name of the replacement; otherwise, return None.
For historical reasons, model name lookups using get_model() are
case insensitive, so we make sure we are case insensitive here.
Nr� rg )r" r� r �splitr� rz rk )rc � swapped_for�
swapped_label�swapped_objectr r r2 r� m s �zOptions.swappedc C s� g }t � }dd� | j�� D �}t|�D ])\}}|jjD ] }|j|v r#qt�|�}| j|_|�|j� |� ||j
|f� qqt ddd� t |�D ��S )Nc s s � | ]
}t |d �r|V qdS )rw N)r� )r0 �br r r2 r3 � s � z#Options.managers.<locals>.<genexpr>rB c s s � | ]}|d V qdS )� Nr )r0 �mr r r2 r3 � r4 )
�setrx �mro� enumeraterw rV r= r} rN r� �creation_counterr? �sorted)rc rB �
seen_managers�bases�depth�baser� r r r2 rB � s
� �zOptions.managersc C � dd� | j D �S )Nc S s i | ]}|j |�qS r r� )r0 r� r r r2 �
<dictcomp>� s z(Options.managers_map.<locals>.<dictcomp>)rB rh r r r2 rD � rj zOptions.managers_mapc C s� | j }|s"| j�� dd � D ]}t|d�r!|jjdkr |jj} nq|r;z| j| W S ty: td| j |f ��w t
� }d|_| j|_d|_ |S )N� rw �
_base_manager�%s has no manager named %rT) r* rx r� r� r� r= rD �KeyErrorr� rY r r# )rc r* �parentr� r r r2 rC � s0
� ���zOptions.base_managerc C s� | j }|s | js | j�� dd � D ]
}t|d�r |jj } nq|r8z| j| W S ty7 td| j |f ��w | j
r@| j
d S d S )Nr� rw r� r ) r+ rV rx r� r� rw rD r� r� rY rB )rc r+ r� r r r2 rG � s*
� ���
�zOptions.default_managerc s< dd� �dd� �dd� � t d� ��fdd �| jd
d �D ��S ) a1
Return a list of all forward fields on the model and its parents,
excluding ManyToManyFields.
Private API intended only to be used by Django itself; get_fields()
combined with filtering of field properties is the public API for
obtaining this field list.
c S � | j o| j S r. �r� rE �r� r r r2 �is_not_an_m2m_field� � z+Options.fields.<locals>.is_not_an_m2m_fieldc S r� r. )r� � one_to_manyr� r r r2 �is_not_a_generic_relation� r� z1Options.fields.<locals>.is_not_a_generic_relationc S s$ | j o| jot| jd�o| jj S )Nrx )r� � many_to_oner� r� rx r� r r r2 � is_not_a_generic_foreign_key� s �z4Options.fields.<locals>.is_not_a_generic_foreign_keyrA c 3 s, � | ]}�|�r�|�r� |�r|V qd S r. r r� �r� r� r� r r2 r3 � s � ���z!Options.fields.<locals>.<genexpr>Fr� �r? r� rh r r� r2 rA � s �zOptions.fieldsc C � t ddd� | jD ��S )a
Return a list of all concrete fields on the model and its parents.
Private API intended only to be used by Django itself; get_fields()
combined with filtering of field properties is the public API for
obtaining this field list.
rF c s � � | ]}|j r|V qd S r. ��concreter� r r r2 r3 � r� z*Options.concrete_fields.<locals>.<genexpr>)r? rA rh r r r2 rF � � �zOptions.concrete_fieldsc C r� )z�
Return a list of all concrete fields on the model.
Private API intended only to be used by Django itself; get_fields()
combined with filtering of field properties is the public API for
obtaining this field list.
rI c s r� r. r� r� r r r2 r3 r� z0Options.local_concrete_fields.<locals>.<genexpr>)r? rS rh r r r2 rI r� z Options.local_concrete_fieldsc C s t ddd� | jdd�D ��S )a
Return a list of all many to many fields on the model and its parents.
Private API intended only to be used by Django itself; get_fields()
combined with filtering of field properties is the public API for
obtaining this list.
rE c s s � | ] }|j r|jr|V qd S r. r� r� r r r2 r3 s � z'Options.many_to_many.<locals>.<genexpr>Fr� r� rh r r r2 rE s �zOptions.many_to_manyc C s$ | j dddd�}tddd� |D ��S )aw
Return all related objects pointing to the current model. The related
objects can come from a one-to-one, one-to-many, or many-to-many field
relation type.
Private API intended only to be used by Django itself; get_fields()
combined with filtering of field properties is the public API for
obtaining this field list.
FT)r� r� �include_hiddenrL c s s" � | ] }|j r |jjr|V qd S r. )�hiddenr� rE )r0 r� r r r2 r3 * s � z*Options.related_objects.<locals>.<genexpr>)r� r? )rc �all_related_fieldsr r r2 rL s
�zOptions.related_objectsc C sH i }| j dd�}|D ]}|||j< z|||j< W q
ty! Y q
w |S )NFr� �r� r= r� r� �rc �resrA r� r r r2 rH - s
�zOptions._forward_fields_mapc C sJ i }| j ddd�}|D ]}|||j< z|||j< W q ty" Y q w |S )NFT)r� r� r r r r r2 rJ < s
�zOptions.fields_mapc C sh z| j | W S ty | jjstd| j|f ��Y nw z| j| W S ty3 td| j|f ��w )zW
Return a field instance given the name of a forward or reverse field.
z�%s has no field named '%s'. The app cache isn't ready yet, so if this is an auto-created related field, it won't be available yet.r� )rH r� r � models_readyr rY rJ )rc �
field_namer r r2 � get_fieldK s ����
�zOptions.get_fieldc C sN | j sg S || j v r
|gS | j D ]}|j�|�}|r$|�d|� | S qg S )z�
Return a list of parent classes leading to `model` (ordered from
closest to most distant ancestor). This has to handle the case where
`model` is a grandparent or even more distant relation.
r )r` rw �get_base_chain�insert)rc rx r� r r r r2 r d s
�zOptions.get_base_chainc C s8 t | j�}| jD ]}|j�� D ]}|�|� qqt|�S )z�
Return all the ancestors of this model as a list ordered by MRO.
Useful for determining if something is an ancestor, regardless of lineage.
)r r` rw �get_parent_listrN r6 )rc �resultr� �ancestorr r r2 r
u s
�zOptions.get_parent_listc C sF || j v r
| j | S | j D ]}|j�|�}|r | j | p | S q
dS )a\
Return the field on the current model which points to the given
"ancestor". This is possible an indirect link (a pointer to a parent
model, which points, eventually, to the ancestor). Used when
constructing table joins for model inheritance.
Return None if the model isn't an ancestor of this one.
N)r` rw �get_ancestor_link)rc r r� � parent_linkr r r2 r
� s
��zOptions.get_ancestor_linkc C s| | j |u rg S | j}g }| }| �|�D ](}||u r |j}q|j| }|j�� f}|j}|�t|j j|||dddd�� q|S )z�
Return a list of PathInfos containing the path from the current
model to the parent model, or an empty list if parent is not a
parent of the current model.
FTN)� from_opts�to_opts�
target_fields�
join_field�m2m�direct�filtered_relation) rx r_ r rw r` r� �get_related_fieldr� r )rc r� �
proxied_model�path�opts� int_model� final_field�targetsr r r2 �get_path_to_parent� s*
� zOptions.get_path_to_parentc C sz | j |u rg S | j}|j�|�}|�� |�|� g }t|dd� �D ]\}}||d }|j�|�}|�|� � � q#|S )z�
Return a list of PathInfos containing the path from the parent
model to the current model, or an empty list if parent is not a
parent of the current model.
N���r� )
rx r_ rw r r� r� r� r
�extend�get_reverse_path_info) rc r� rx �chainr �ir �child�linkr r r2 �get_path_from_parent� s
z Options.get_path_from_parentc C s� t t�}| jjdd�}|D ]0}|j}|jrq
dd� |jddd�D �}|D ]}t|jj t
�s<|jj jj jj }|| �
|� q$q
|D ]}||jj jj }||jjd< q@| j�dt�S )a%
This method is used by each model to find its reverse objects. As this
method is very expensive and is accessed frequently (it looks up every
field in a model, in every app), it is computed on first access and then
is set as a property on every model.
T)�include_auto_createdc s s$ � | ]
}|j r|jd ur|V qd S r. )r� �
related_modelr� r r r2 r3 � s � �
��z<Options._populate_directed_relation_graph.<locals>.<genexpr>F)r� �include_parentsrK )r r6 r �
get_modelsrw r r� r5 r� rx r� r_ ri r� r| rm �EMPTY_RELATION_TREE) rc �related_objects_graph�
all_modelsrx r �fields_with_relationsr� � remote_labelrL r r r2 �!_populate_directed_relation_graph� s& ���z)Options._populate_directed_relation_graphc C s | � � S r. )r/ rh r r r2 rK � s zOptions._relation_treeTc C sX |r| j D ] }|| jv rt| |� q|r'| js'| jD ] }|| jv r&t| |� qi | _d S r. )�FORWARD_PROPERTIESr| �delattrr �REVERSE_PROPERTIESrR )rc r� r� � cache_keyr r r2 r� � s
�
�
zOptions._expire_cachec C s |du rt }| j||d�S )a�
Return a list of fields associated to the model. By default, include
forward and reverse fields, fields derived from inheritance, but not
hidden fields. The returned fields can be changed using the parameters:
- include_parents: include fields derived from inheritance
- include_hidden: include fields that have a related_name that
starts with a "+"
F)r( r� )�
PROXY_PARENTSr� )rc r( r� r r r2 �
get_fields� s
zOptions.get_fieldsc
C sP |ddt fvrtd|f ��|du }|rt� }|�| j� |||||f}z| j| W S ty3 Y nw g }|durp| jD ]2} | |v rDq=| jj | j krP|t krPq=| jj
|||||d�D ]}
t |
dd�ri|
j| j krn|� |
� q[q=|r�| j
s�| j} | D ]} |s�| jjs�|� | j� qz|r�|| j7 }|| j7 }|r�|| j7 }td|�}|| j|< |S )a�
Internal helper function to return fields of the model.
* If forward=True, then fields defined on this model are returned.
* If reverse=True, then relations pointing to this model are returned.
* If include_hidden=True, then fields with is_hidden=True are returned.
* The include_parents argument toggles if fields from parent models
should be included. It has three values: True, False, and
PROXY_PARENTS. When set to PROXY_PARENTS, the call will return all
fields defined for the current model or any of its parents in the
parent chain to the model's concrete model.
TFz(Invalid argument for include_parents: %sN)r� r� r( r� � seen_modelsr z get_fields())r4 r7 r� rN rx rR r� r` rw r_ r� r� r� r! rK r� r rS rT rU r? )
rc r� r� r( r� r6 � topmost_callr3 rA r� r� �
all_fieldsr� r r r2 r� sT
�
�
��
�
zOptions._get_fieldsc C r� )z�
Return a list of total unique constraints. Useful for determining set
of fields guaranteed to be unique for all rows.
c S s$ g | ]}t |t�r|jd u r|�qS r. )r5 r � condition)r0 �
constraintr r r2 r� f s �
�z4Options.total_unique_constraints.<locals>.<listcomp>)r- rh r r r2 �total_unique_constraints` s �z Options.total_unique_constraintsc C s> g }t | j�D ]}t�| j|�}t|t�r|�|� qt|�S )zAReturn a set of the names of the properties defined on the model.)�dirrx �inspect�getattr_staticr5 �propertyr� � frozenset)rc �namesr= �attrr r r2 �_property_namesl s
�zOptions._property_namesc C s dd� | j ddtd�D �S )z
Private API intended only to be used by Django itself.
Fields to be returned after a database insert.
c S s g | ]
}t |d d�r|�qS )� db_returningF)r� r� r r r2 r� | s
��z/Options.db_returning_fields.<locals>.<listcomp>TF)r� r� r( )r� r4 rh r r r2 �db_returning_fieldsv s �zOptions.db_returning_fieldsr. )F)TT)TF)TTTFN)4ry r� r� r0 r2 r rb rd r? ri rk rn ro r� r� r� r� r� r� r� r� r� r� r� r� r� r rB rD rC rG rA rF rI rE rL rH rJ r r r
r
r r% r/ rK r� r5 r� r; rC rE r r r r2 r@ @ s�
9
= %
!
%
�T
r@ ))r� r} r= � collectionsr � django.appsr � django.confr �django.core.exceptionsr r ru r �django.db.modelsr r r
r � django.db.models.query_utilsr �django.utils.datastructuresr
r �django.utils.functionalr �django.utils.module_loadingr �django.utils.textr r �django.utils.translationr �objectr4 r* r< r r: r? r@ r r r r2 �<module> s. �