|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/django/db/models/fields/__pycache__/ |
Upload File : |
o
3�a�+ � @ s� d Z ddlmZ ddlmZ ddlmZ ddlmZ ddl m
Z
G dd � d e
�Z G d
d � d e �Z G d d
� d
e �Z
G dd� de �ZdS )al
"Rel objects" for related fields.
"Rel objects" (for lack of a better name) carry information about the relation
modeled by a related field and provide some utility functions. They're stored
in the ``remote_field`` attribute of the field.
They also act as reverse fields for the purposes of the Meta API because
they're the closest concept currently available.
� )�
exceptions)�cached_property)�
make_hashable� )�BLANK_CHOICE_DASH)�FieldCacheMixinc @ s0 e Zd ZdZdZdZdZdZdZdZ d8dd�Z
e dd� �Z e d d
� �Z
ed d � �Zed
d� �Ze dd� �Ze dd� �Ze dd� �Ze dd� �Ze dd� �Zdd� Zdd � Zed d � �Zd d � Zed!d"� �Zd#d$� Zd%d&� Z de dd'fd(d)�Z d*d+� Z d,d-� Z d.d/� Z!d0d1� Z"d9d2d3�Z#d9d4d5�Z$d6d7� Z%dS ):�ForeignObjectRelz�
Used by ForeignObject to store information about the relation.
``_meta.get_fields()`` returns this class to provide access to the field
flags for the reverse relation.
TFNc C sF || _ || _|| _|| _|d u ri n|| _|| _|| _d| _d| _d S )NFT) �field�model� related_name�related_query_name�limit_choices_to� parent_link� on_delete� symmetrical�multiple)�selfr �tor r r
r r � r �I/usr/lib/python3/dist-packages/django/db/models/fields/reverse_related.py�__init__' s
zForeignObjectRel.__init__c C � | � � S �N)� is_hidden�r r r r �hidden8 � zForeignObjectRel.hiddenc C �
| j �� S r )r r r r r r �name< s
zForeignObjectRel.namec C s | j S r )r r r r r � remote_field@ s z ForeignObjectRel.remote_fieldc 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 z1Can't use target_field for multicolumn relations.r )�
get_path_info�
target_fields�lenr �
FieldError)r r" r r r � target_fieldD s
z ForeignObjectRel.target_fieldc C s | j jstd��| j jS )NzVThis property can't be accessed before self.field.contribute_to_class has been called.)r r
�AttributeErrorr r r r �
related_modelO s
�z ForeignObjectRel.related_modelc C � | j jS r )r � many_to_manyr r r r r) V r z ForeignObjectRel.many_to_manyc C r( r )r � one_to_manyr r r r � many_to_oneZ r z ForeignObjectRel.many_to_onec C r( r )r r+ r r r r r* ^ r z ForeignObjectRel.one_to_manyc C r( r )r �
one_to_oner r r r r, b r zForeignObjectRel.one_to_onec C � | j �|�S r )r �
get_lookup)r � lookup_namer r r r. f � zForeignObjectRel.get_lookupc C r r )r �get_internal_typer r r r r1 i �
z"ForeignObjectRel.get_internal_typec C r( r )r �db_typer r r r r3 l r zForeignObjectRel.db_typec C s dt | �j| jjj| jjjf S )Nz <%s: %s.%s>)�type�__name__r' �_meta� app_label�
model_namer r r r �__repr__p s
�zForeignObjectRel.__repr__c C s, | j | j| j| jt| j�| j| j| j| j f S r )
r r
r r r r
r r r r r r r r �identityw s �zForeignObjectRel.identityc C s t || j�stS | j|jkS r )�
isinstance� __class__�NotImplementedr: )r �otherr r r �__eq__� s zForeignObjectRel.__eq__c C s
t | j�S r )�hashr: r r r r �__hash__� r2 zForeignObjectRel.__hash__r c C s@ |p| j }| jj�|�}|r|j|� }|r|ng dd� |D � S )a
Return choices with a default blank choices included, for use
as <select> choices for this field.
Analog of django.db.models.fields.Field.get_choices(), provided
initially for utilization by RelatedFieldListFilter.
c S s g | ] }|j t|�f�qS r )�pk�str)�.0�xr r r �
<listcomp>� s �z0ForeignObjectRel.get_choices.<locals>.<listcomp>)r
r' �_default_manager�complex_filter�order_by)r �
include_blank� blank_choicer
�ordering�qsr r r � get_choices� s
�z ForeignObjectRel.get_choicesc C s t | j�o | jd dkS )z$Should the related object be hidden?r �+)�boolr r r r r r � s zForeignObjectRel.is_hiddenc C r r )r �get_reverse_joining_columnsr r r r �get_joining_columns� r2 z$ForeignObjectRel.get_joining_columnsc C s | j �|||�S r )r �get_extra_restriction)r � where_class�alias�
related_aliasr r r rS � s z&ForeignObjectRel.get_extra_restrictionc C s
d| _ dS )z�
Set the related field's name, this is not available until later stages
of app loading, so set_field_name is called from
set_attributes_from_rel()
N)�
field_namer r r r �set_field_name� s
z ForeignObjectRel.set_field_namec C sX |r|j n| jj }|p
| j}| jr| jr|| jkrd S | jr!| jS |j| jr)d S d S )N�_set� )r6 r' r r r
r r8 )r r
�optsr r r �get_accessor_name� s
z"ForeignObjectRel.get_accessor_namec C r- r )r �get_reverse_path_info)r �filtered_relationr r r r! � r0 z ForeignObjectRel.get_path_infoc C r )z�
Return the name of the cache key to use for storing an instance of the
forward model on the reverse model.
)r\ r r r r �get_cache_name� s z ForeignObjectRel.get_cache_name�NNNFNr )&r5 �
__module__� __qualname__�__doc__� auto_created�concrete�editable� is_relation�null�empty_strings_allowedr r r r �propertyr r% r' r) r+ r* r, r. r1 r3 r9 r: r? rA r rN r rR rS rX r\ r! r_ r r r r r s`
�
�
r c sN e Zd ZdZ d� fdd� Zdd� Ze� fdd ��Zd
d � Zd d
� Z � Z
S )� ManyToOneRela+
Used by the ForeignKey field to store information about the relation.
``_meta.get_fields()`` returns this class to provide access to the field
flags for the reverse relation.
Note: Because we somewhat abuse the Rel objects by using them as reverse
fields we get the funny situation where
``ManyToOneRel.many_to_one == False`` and
``ManyToOneRel.one_to_many == True``. This is unfortunate but the actual
ManyToOneRel class is a private API and there is work underway to turn
reverse relations into actual fields.
NFc s$ t � j|||||||d� || _d S )N�r r r
r r )�superr rW � r r r rW r r r
r r �r< r r r � s �
zManyToOneRel.__init__c C s | j �� }|�dd � |S )Nr' )�__dict__�copy�pop)r �stater r r � __getstate__� s
zManyToOneRel.__getstate__c s t � j| jf S r )rm r: rW r ro r r r: � s zManyToOneRel.identityc C s* | j j�| j�}|jst�d| j ��|S )zY
Return the Field in the 'to' object to which this relationship is tied.
zNo related field named '%s')r
r6 � get_fieldrW re r �FieldDoesNotExist)r r r r r �get_related_field� s z ManyToOneRel.get_related_fieldc C s | j p| jjjj| _ d S r )rW r
r6 rB r r r r r rX � s zManyToOneRel.set_field_namer` ) r5 ra rb rc r rt rj r: rw rX �
__classcell__r r ro r rk � s �
rk c s& e Zd ZdZ d� fdd� Z� ZS )� OneToOneRelz�
Used by OneToOneField to store information about the relation.
``_meta.get_fields()`` returns this class to provide access to the field
flags for the reverse relation.
NFc
s& t � j||||||||d� d| _d S )Nrl F)rm r r rn ro r r r
s �
zOneToOneRel.__init__r` )r5 ra rb rc r rx r r ro r ry s
�ry c s@ e Zd ZdZ d
� fdd� Ze� fdd��Zdd � Z� ZS ) �
ManyToManyRelz�
Used by ManyToManyField to store information about the relation.
``_meta.get_fields()`` returns this class to provide access to the field
flags for the reverse relation.
NTc
sR t � j|||||d� |r| std��|| _|r |s td��|| _|| _| | _d S )N)r r r
z4Can't supply a through model and db_constraint=Falsez5Cannot specify through_fields without a through model)rm r �
ValueError�through�through_fieldsr �
db_constraint)
r r r r r r
r r| r} r~ ro r r r s �
zManyToManyRel.__init__c s t � j| jt| j�| jf S r )rm r: r| r r} r~ r ro r r r: 5 s
�zManyToManyRel.identityc C sV | j j}| jr|�| jd �}n|jD ]}t|dd�}|r%|j| jkr% nq|jd S )z�
Return the field in the 'to' object to which this relationship is tied.
Provided for symmetry with ManyToOneRel.
r r N)r| r6 r} ru �fields�getattrr
�foreign_related_fields)r r[ r �relr r r rw = s
�
z ManyToManyRel.get_related_field)NNNTNNT) r5 ra rb rc r rj r: rw rx r r ro r rz s �rz N)rc � django.corer �django.utils.functionalr �django.utils.hashabler rZ r �mixinsr r rk ry rz r r r r �<module> s =2