OwlCyberSecurity - MANAGER
Edit File: options.cpython-39.pyc
a ���eA� � @ s d dl Z d dlZd dlZd dlZd dlmZ d dlmZ d dlm Z d dl m Z m Z d dl mZ d dlmZmZmZmZ d dlmZ d d lmZmZ d d lmZ d d lm Z d d l m Z d d l m Z m!Z! d dl"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)�RemovedInDjango51Warning)�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�db_table_comment�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 sh zL| s W dS t | ttf�s t�| d }t |ttf�s:| f} tdd� | D ��W S tyb | Y S 0 dS )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)�.0Zotr r �Y/home/gouroczh/virtualenv/pat/3.9/lib/python3.9/site-packages/django/db/models/options.py� <genexpr>L � z%normalize_together.<locals>.<genexpr>N)� isinstancer1 �list� TypeError)Zoption_togetherZ first_elementr r r3 �normalize_together= s r9 c C s t |t| d�S )N)�warning)r �IMMUTABLE_WARNING)�name�datar r r3 �make_immutable_fields_listS s r> c @ s� e Zd Zh d�Zh d�ZeZd\dd�Zedd� �Z edd � �Z ed d � �Z d d � Z dd� Z dd� Zdd� Zdd� Zd]dd�Zdd� Zdd � Zd d � Zd d � Zd!d"� Zed#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$d=d>� Z%d?d@� Z&dAdB� Z'dCdD� Z(dEdF� Z)dGdH� Z*dIdJ� Z+edKdL� �Z,d^dNdO�Z-d_dPdQ�Z.d`dRdS�Z/edTdU� �Z0edVdW� �Z1edXdY� �Z2edZd[� �Z3dS )a�Options> � managers_map�concrete_fields� many_to_many�default_manager�managers� _non_pk_concrete_field_names�_forward_fields_map� base_manager�fields�local_concrete_fields> �related_objects�_relation_tree� fields_mapNc C s i | _ g | _g | _g | _g | _d | _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)�addZchange�delete�viewT)-�_get_fields_cache� local_fields�local_many_to_many�private_fields�local_managersr, r- � model_namer r r r r �_ordering_clashr. r/ r r& r( r' r � object_namer r r r ZDEFAULT_TABLESPACEr r* r+ �meta�pkZ auto_fieldr! r" r# �proxy_for_model�concrete_modelr$ �parentsr% Zrelated_fkey_lookups� default_appsr r) )�selfrY r r r r3 �__init__h sT zOptions.__init__c C s d| j | jf S �N�%s.%s)r rX �r_ r r r3 �label� s z Options.labelc C s d| j | jf S ra )r rV rc r r r3 � label_lower� s zOptions.label_lowerc C s | j j�| j�S r0 )r Z app_configs�getr rc r r r3 � app_config� s zOptions.app_configc C s� ddl m} ddlm} | |_|| _|j| _| j�� | _ t | j�| _ i | _ | j �r�| j j�� }| j jD ]}|�d�rf||= qftD ]`}||v r�t| ||�|�� t| |�| j |< q�t| j |�r�t| |t| j |�� t| |�| j |< q�t| j�| _t| j�| _| j�rt�d| j�d�t � t|jdd��sTd D ]&}t| |g �}t| || � ||�� �q,| j d u �rnt d | j �| _ t | j!�o|| j"�| _#|i k�r�t$d d �%|� ��nt d | j �| _ | ` | j&�s�d | j'| j f | _&|| j&|j(�)� �| _&d S )Nr �� connection)� truncate_name�_z6'index_together' is deprecated. Use 'Meta.indexes' in z instead.r! F> r/ r. z{}sz)'class Meta' got invalid attribute(s): %s�,z%s_%s)*� django.dbri Zdjango.db.backends.utilsrj �_meta�model�__name__rX �lowerrV r r Zoriginal_attrsrY �__dict__�copy� startswith� DEFAULT_NAMES�setattr�pop�getattr�hasattrr9 r r& �warnings�warnrd r �_format_names_with_classr r �boolr r rW r8 �joinr r �opsZmax_name_length)r_ �clsr< ri rj Z meta_attrs� attr_name�objsr r r3 �contribute_to_class� s^ �� � �zOptions.contribute_to_classc C sD g }|D ]6}|� � }|j|jj�� |j�� d� |_|�|� q|S )z4App label/class name interpolation for object names.)r �class)�cloner< rn r rq rp �append)r_ r� r� Znew_objs�objr r r3 r| � s � z Options._format_names_with_classc C s� t | jdtj�}| jr>| jjr>t| j�}|j� d|j� d�}nd}|sTt|� d���z t |�}W n> t y� } z&|� d|� d�}t|�|�W Y d }~n d }~0 0 t |t �s�t d|� d |� d ���|S ) NZdefault_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.)rx rg r r� Z!_is_default_auto_field_overridden�type� __module__� __qualname__r r � ImportError� issubclassr � ValueError)r_ Z pk_class_pathZapp_config_class�source�pk_class�e�msgr r r3 �_get_default_pk_class s2 � �� � �z Options._get_default_pk_classc s | j r�| j �z$t�fdd�| jdd�D ��| _ W n$ tyT td| j�f ��Y n0 d| _tdd� |jj D ��s�|� dt � � nd | _ | j d u r�| j r�tt| j �� ��� � fd d �| j D �}|r�|d � d � _| �� � n"| �� }|d d d d�}|� d|� d S )Nc 3 s& | ] }|j � ks|j� kr|V qd S r0 )r< �attname�r2 �f)�queryr r3 r4 ' s �z#Options._prepare.<locals>.<genexpr>F��reverse�%s has no field named '%s')�_orderc s s | ]}t |t�V qd S r0 )r6 r �r2 �fieldr r r3 r4 2 s r� c s g | ]}|j � j kr|�qS r �r< )r2 Zfld)r� r r3 � <listcomp>A s z$Options._prepare.<locals>.<listcomp>r TZID)r � primary_keyr% �id)r �next� _get_fields� StopIterationr rX r �anyrn rR Z add_to_classr rZ r] �iter�valuesr� �setup_pkr� )r_ ro Zalready_createdr� �autor )r� r� r3 �_prepare! s: � � � � zOptions._preparec C s | j �|� | �� d S r0 )rU r� � _expire_cache)r_ �managerr r r3 � add_managerM s zOptions.add_managerFc C s� |r| j �|� n4|jr.|jr.t�| j|� nt�| j|� | �|� |jr�t |j d�r�|j j r�z|j j j j dd� W n ty� Y n0 | � � n | j dd� d S )Nro F)�forwardr� )rT r� � is_relationrB �bisect�insortrS rR r� ry � remote_fieldro rn r� �AttributeError)r_ r� �privater r r3 � add_fieldQ s$ � �� zOptions.add_fieldc C s | j s|jr|| _ d|_d S )NF)rZ r� � serialize)r_ r� r r r3 r� s 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)rn rZ r[ r )r_ �targetr r r3 � setup_proxyx s zOptions.setup_proxyc C s d| j S )Nz<Options for %s>)rX rc r r r3 �__repr__� s zOptions.__repr__c C s | j S r0 )re rc r r r3 �__str__� s zOptions.__str__c s\ | j s| js| jsdS t� t�r(t� � | jr:| j� jkS | jrXt � 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)rx �features)r2 Zfeatrh r r3 r4 � s �z&Options.can_migrate.<locals>.<genexpr>T) r# �swappedr" r6 �strr r+ �vendorr* �all)r_ ri r rh r3 � can_migrate� s �zOptions.can_migratec C s6 t d�� t| j�W d � S 1 s(0 Y dS )z%Return the untranslated verbose name.N)r r� r rc r r r3 �verbose_name_raw� s zOptions.verbose_name_rawc C s` | j r\tt| j d�}|r\z|�d�\}}W n ty@ | Y S 0 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� rb )r$ rx r �splitr� rq re )r_ Z swapped_forZ swapped_labelZswapped_objectr r r3 r� � s ��zOptions.swappedc C s� g }t � }dd� | j�� D �}t|�D ]R\}}|jjD ]@}|j|v rFq6t�|�}| j|_|�|j� |� ||j |f� q6q&t ddd� t |�D ��S )Nc s s | ]}t |d �r|V qdS )rn N)ry )r2 �br r r3 r4 � r5 z#Options.managers.<locals>.<genexpr>rD c s s | ]}|d V qdS )� Nr )r2 �mr r r3 r4 � r5 ) �setro �mro� enumeratern rU r< rs rN r� Zcreation_counterr> �sorted)r_ rD Z seen_managers�bases�depth�baser� r r r3 rD � s �zOptions.managersc C s dd� | j D �S )Nc S s i | ] }|j |�qS r r� )r2 r� r r r3 � <dictcomp>� r5 z(Options.managers_map.<locals>.<dictcomp>)rD rc r r r3 r@ � s zOptions.managers_mapc C s� | j }|sD| j�� dd � D ]&}t|d�r |jjdkr>|jj} qDq |rzz | j| W S tyx td| j |f ��Y n0 t � }d|_| j|_d|_ |S )N� rn � _base_manager�%s has no manager named %rT) r, ro r� ry r� r< r@ �KeyErrorr� rX r r% )r_ r, �parentr� r r r3 rG � s. ��� zOptions.base_managerc C s� | j }|s>| js>| j�� dd � D ]}t|d�r"|jj } q>q"|rtz | j| W S tyr td| j |f ��Y n0 | j r�| j d S d S )Nr� rn r� r ) r- rU ro r� ry rn r@ r� r� rX rD )r_ r- r� r r r3 rC � 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 s | j o | j S r0 �r� rB �r� r r r3 �is_not_an_m2m_field s z+Options.fields.<locals>.is_not_an_m2m_fieldc S s | j o | j S r0 )r� Z one_to_manyr� r r r3 �is_not_a_generic_relation s z1Options.fields.<locals>.is_not_a_generic_relationc S s$ | j o | jo t| jd�o | jj S )Nro )r� Z many_to_onery r� ro r� r r r3 � is_not_a_generic_foreign_key! s ��z4Options.fields.<locals>.is_not_a_generic_foreign_keyrH c 3 s* | ]"}�|�r�|�r� |�r|V qd S r0 r r� �r� r� r� r r3 r4 * s �z!Options.fields.<locals>.<genexpr>Fr� �r> r� rc r r� r3 rH s ��zOptions.fieldsc C s 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. rA c s s | ]}|j r|V qd S r0 �Zconcreter� r r r3 r4 = r5 z*Options.concrete_fields.<locals>.<genexpr>)r> rH rc r r r3 rA 3 s �zOptions.concrete_fieldsc C s t ddd� | jD ��S )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 s | ]}|j r|V qd S r0 r� r� r r r3 r4 J r5 z0Options.local_concrete_fields.<locals>.<genexpr>)r> rR rc r r r3 rI @ s �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. rB c s s | ]}|j r|jr|V qd S r0 r� r� r r r3 r4 X s �z'Options.many_to_many.<locals>.<genexpr>Fr� r� rc r r r3 rB M 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_hiddenrJ c s s | ]}|j r|jjr|V qd S r0 )�hiddenr� rB )r2 r� r r r3 r4 o s �z*Options.related_objects.<locals>.<genexpr>)r� r> )r_ Zall_related_fieldsr r r3 rJ _ s ���zOptions.related_objectsc C sJ i }| j dd�}|D ]0}|||j< z|||j< W q tyB Y q0 q|S )NFr� �r� r< r� r� �r_ �resrH r� r r r3 rF v s zOptions._forward_fields_mapc C sL i }| j ddd�}|D ]0}|||j< z|||j< W q tyD Y q0 q|S )NFT)r� r� r� r� r r r3 rL � s zOptions.fields_mapc C sp z | j | W S ty8 | jjs4td| j|f ��Y n0 z | j| W S tyj td| j|f ��Y n0 dS )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� N)rF r� r Z models_readyr rX rL )r_ � field_namer r r3 � get_field� s �� �zOptions.get_fieldc C sN | j s g S || j v r|gS | j D ](}|j�|�}|r |�d|� | S q g 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] rn �get_base_chain�insert)r_ ro r� r� r r r3 r� � s zOptions.get_base_chainc C s8 t | j�}| jD ] }|j�� D ]}|�|� q qt|�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] rn �get_parent_listrN r7 )r_ �resultr� �ancestorr r r3 r� � s zOptions.get_parent_listc C sF || j v r| j | S | j D ]&}|j�|�}|r| j | p:| S qdS )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] rn �get_ancestor_link)r_ r� r� � parent_linkr r r3 r� � s zOptions.get_ancestor_linkc C s| | j |u rg S | j}g }| }| �|�D ]P}||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)Z from_optsZto_optsZ target_fieldsZ join_fieldZm2m�directZfiltered_relation) ro r\ r� rn r] r� Zget_related_fieldr� r )r_ r� Z proxied_model�path�optsZ int_modelZ final_field�targetsr r r3 �get_path_to_parent� s. �� zOptions.get_path_to_parentc C sx | j |u rg S | j}|j�|�}|�� |�|� g }t|dd� �D ],\}}||d }|j�|�}|�|j � qF|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� ) ro r\ rn r� r� r� r� r� �extendZreverse_path_infos) r_ r� ro �chainr� �ir� �child�linkr r r3 �get_path_from_parent� s z Options.get_path_from_parentc C s� t t�}| jjdd�}|D ]`}|j}|jr,qdd� |jddd�D �}|D ]0}t|jj t �sH|jj jj jj }|| � |� qHq|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)Zinclude_auto_createdc s s" | ]}|j r|jd ur|V qd S r0 )r� Z related_modelr� r r r3 r4 % s �z<Options._populate_directed_relation_graph.<locals>.<genexpr>F)r� �include_parentsrK )r r7 r Z get_modelsrn r! r� r6 r� ro r� r\ rd r� rr rf �EMPTY_RELATION_TREE) r_ Zrelated_objects_graphZ all_modelsro r� Zfields_with_relationsr� Z remote_labelrJ r r r3 �!_populate_directed_relation_graph s& � �z)Options._populate_directed_relation_graphc C s | � � S r0 )r� rc r r r3 rK = s zOptions._relation_treeTc C sX |r$| j D ]}|| jv r t| |� q |rN| jsN| jD ]}|| jv r4t| |� q4i | _d S r0 )�FORWARD_PROPERTIESrr �delattrr! �REVERSE_PROPERTIESrQ )r_ r� r� � cache_keyr r r3 r� A s zOptions._expire_cachec C s |du r t }| 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� )r_ r� r� r r r3 � get_fieldsN s �zOptions.get_fieldsc C sZ |ddt fvr td|f ��|du }|r.t� }|�| j� |||||f}z | j| W S tyf Y n0 g }|dur�| jD ]d} | |v r�qz| jj | j kr�|t kr�qz| jj |||||d�D ]&} t | dd�r�| j| j kr�|� | � q�qz|�r| j �s| j} | D ] } |�s | jjs�|� | j� q�|�rB|| j7 }|| j7 }|�rB|| 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())r� r8 r� rN ro rQ r� r] rn r\ r� rx r� r# rK r� r� rR rS rT r> ) r_ r� r� r� r� r� Z topmost_callr� rH r� r� Z all_fieldsr� r r r3 r� ^ s` � ��� � � zOptions._get_fieldsc C s dd� | j D �S )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|js|�qS r0 )r6 r � conditionZcontains_expressions)r2 � constraintr r r3 r� � s �z4Options.total_unique_constraints.<locals>.<listcomp>)r/ rc r r r3 �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.)�dirro �inspect�getattr_staticr6 �propertyr� � frozenset)r_ �namesr< �attrr r r3 �_property_names� s zOptions._property_namesc C sB g }| j D ].}|js |�|j� |j|jkr |�|j� q t|�S )zW Return a set of the non-pk concrete field names defined on the model. )rA r� r� r< r� r )r_ r r� r r r3 rE � s z$Options._non_pk_concrete_field_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 )Z db_returningF)rx r� r r r3 r� � s �z/Options.db_returning_fields.<locals>.<listcomp>TF)r� r� r� )r� r� rc r r r3 �db_returning_fields� s ��zOptions.db_returning_fields)N)F)TT)TF)TTTFN)4rp r� r� r� r� r r^ r` r rd re rg r� r| r� r� r� r� r� r� r� r� r� r� r� r rD r@ rG rC rH rA rI rB rJ rF rL r� r� r� r� r� r� r� rK r� r� r� r r rE r r r r r3 r? W s� : G , " ) ( � e r? ),r� rs r rz � collectionsr Z django.appsr Z django.confr Zdjango.core.exceptionsr r rm r Zdjango.db.modelsr r r r Z django.db.models.query_utilsr Zdjango.utils.datastructuresr r Zdjango.utils.deprecationr Zdjango.utils.functionalr Zdjango.utils.module_loadingr Zdjango.utils.textr r Zdjango.utils.translationr �objectr� r� r; ru r9 r> r? r r r r3 �<module> s0 �