3 (hF(@sdZddlmZddlZddlmZddlmZddlm Z ddl m Z dd l m Z Gd d d eZGd d d eZGdddeZGdddeZdS)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. )unicode_literalsN) exceptions)RemovedInDjango20Warning) smart_text)cached_property)BLANK_CHOICE_DASHc@seZdZdZdZdZdZdZdZd3ddZ e ddZ e d d Z e d d Ze d dZe ddZe ddZe ddZe ddZe ddZe ddZddZddZe dd Zd!d"Zdefd#d$Zd%d&Zd'd(Zd)d*Zd+d,Zd4d-d.Z d/d0Z!d1d2Z"dS)5ForeignObjectRelz 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. TFNcCsF||_||_||_||_|dkr$in||_||_||_d|_d|_dS)NFT) fieldmodel related_namerelated_query_namelimit_choices_to parent_link on_delete symmetricalmultiple)selfr tor r rrrrK/tmp/pip-install-q3hcpn_q/Django/django/db/models/fields/reverse_related.py__init__*szForeignObjectRel.__init__cCstjdtd|jS)Nz\Usage of ForeignObjectRel.to attribute has been deprecated. Use the model attribute instead.)warningswarnrr )rrrrr;szForeignObjectRel.tocCs|jS)N) is_hidden)rrrrhiddenCszForeignObjectRel.hiddencCs |jjS)N)r r )rrrrnameGszForeignObjectRel.namecCs|jS)N)r )rrrr remote_fieldKszForeignObjectRel.remote_fieldcCs,|jdj}t|dkr$tjd|dS)z When filtering against this relation, returns the field on the remote model against which the filtering should happen. rz1Can't use target_field for multicolumn relations.r) get_path_info target_fieldslenrZ FieldError)rr!rrr target_fieldOs  zForeignObjectRel.target_fieldcCs|jjstd|jjS)NzVThis property can't be accessed before self.field.contribute_to_class has been called.)r r AttributeError)rrrr related_modelZszForeignObjectRel.related_modelcCs|jjS)N)r many_to_many)rrrrr&aszForeignObjectRel.many_to_manycCs|jjS)N)r one_to_many)rrrr many_to_oneeszForeignObjectRel.many_to_onecCs|jjS)N)r r()rrrrr'iszForeignObjectRel.one_to_manycCs|jjS)N)r one_to_one)rrrrr)mszForeignObjectRel.one_to_onecCs |jj|S)N)r get_lookup)r lookup_namerrrr*qszForeignObjectRel.get_lookupcCs |jjS)N)r get_internal_type)rrrrr,tsz"ForeignObjectRel.get_internal_typecCs|jjS)N)r db_type)rrrrr-wszForeignObjectRel.db_typecCs dt|j|jjj|jjjfS)Nz <%s: %s.%s>)type__name__r%_metaZ app_label model_name)rrrr__repr__{szForeignObjectRel.__repr__cCs"|r|ngdd|jjjDS)a Return choices with a default blank choices included, for use as SelectField choices for this field. Analog of django.db.models.fields.Field.get_choices(), provided initially for utilization by RelatedFieldListFilter. cSsg|]}|jt|fqSr)Z _get_pk_valr).0xrrr sz0ForeignObjectRel.get_choices..)r%Z_default_managerall)rZ include_blankZ blank_choicerrr get_choicess zForeignObjectRel.get_choicescCst|jo|jddkS)z$Should the related object be hidden?r+r)boolr )rrrrrszForeignObjectRel.is_hiddencCs |jjS)N)r Zget_reverse_joining_columns)rrrrget_joining_columnssz$ForeignObjectRel.get_joining_columnscCs|jj|||S)N)r get_extra_restriction)rZ where_classaliasZ related_aliasrrrr;sz&ForeignObjectRel.get_extra_restrictioncCs 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_name)rrrrset_field_nameszForeignObjectRel.set_field_namecCsV|r |jn|jj}|p|j}|jr6|jr6||jkr6dS|jrB|jS|j|jrPdndS)NZ_set)r0r%rrr r r1)rr optsrrrget_accessor_names z"ForeignObjectRel.get_accessor_namecCs d|jS)Nz _%s_cache)rA)rrrrget_cache_nameszForeignObjectRel.get_cache_namecCs |jjS)N)r Zget_reverse_path_info)rrrrr szForeignObjectRel.get_path_info)NNNFN)N)#r/ __module__ __qualname____doc__Z auto_createdconcreteeditableZ is_relationnullrpropertyrrrrrr#r%r&r(r'r)r*r,r-r2rr7rr:r;r>rArBr rrrrr s<             r cs:eZdZdZd fdd ZddZdd Zd d ZZS) 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(tt|j|||||||d||_dS)N)r r rrr)superrJrr=) rr rr=r r rrr) __class__rrrs zManyToOneRel.__init__cCs|jj}|jdd|S)Nr%)__dict__copypop)rstaterrr __getstate__s  zManyToOneRel.__getstate__cCs*|jjj|j}|js&tjd|j|S)zY Return the Field in the 'to' object to which this relationship is tied. zNo related field named '%s')r r0 get_fieldr=rFrZFieldDoesNotExist)rr rrrget_related_fieldszManyToOneRel.get_related_fieldcCs|jp|jjjj|_dS)N)r=r r0pkr)rrrrr>szManyToOneRel.set_field_name)NNNFN) r/rCrDrErrQrSr> __classcell__rr)rLrrJs    rJcs"eZdZdZdfdd ZZS) 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*tt|j||||||||dd|_dS)N)r r rrrF)rKrVrr) rr rr=r r rrr)rLrrrs zOneToOneRel.__init__)NNNFN)r/rCrDrErrUrr)rLrrVsrVcs*eZdZdZdfdd ZddZZS) 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 sZtt|j|||||d|r,| r,td||_|rD| rDtd||_||_| |_dS)N)r r rz4Can't supply a through model and db_constraint=Falsez5Cannot specify through_fields without a through model)rKrWr ValueErrorthroughthrough_fieldsr db_constraint) rr rr r rrrYrZr[)rLrrrs   zManyToManyRel.__init__cCsX|jj}|jr |j|jd}n.x,|jD]"}t|dd}|r(|j|jkr(Pq(W|jdS)z Return the field in the 'to' object to which this relationship is tied. Provided for symmetry with ManyToOneRel. rrN)rYr0rZrRfieldsgetattrr Zforeign_related_fields)rr@r relrrrrSs  zManyToManyRel.get_related_field)NNNTNNT)r/rCrDrErrSrUrr)rLrrWs rW)rE __future__rrZ django.corerZdjango.utils.deprecationrZdjango.utils.encodingrZdjango.utils.functionalrr?robjectr rJrVrWrrrr s      #.