XF(@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@seZdZdZdZdZdZdZdZdddddddZ e ddZ e d d Z e d d Ze d dZe ddZe ddZe ddZe ddZe ddZe ddZddZddZe dd Zd!d"Zded#d$Zd%d&Zd'd(Zd)d*Zd+d,Zdd-d.Z d/d0Z!d1d2Z"dS)3ForeignObjectRelz 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. TFNcCsg||_||_||_||_|dkr6in||_||_||_d|_d|_dS)NFT) fieldmodel related_namerelated_query_namelimit_choices_to parent_link on_delete symmetricalmultiple)selfr tor r rrrrU/home/ubuntu/projects/ifolica/build/django/django/db/models/fields/reverse_related.py__init__*s       zForeignObjectRel.__init__cCstjdtd|jS)Nz\Usage of ForeignObjectRel.to attribute has been deprecated. Use the model attribute instead.)warningswarnrr )rrrrr;s zForeignObjectRel.tocCs |jS)N) is_hidden)rrrrhiddenCszForeignObjectRel.hiddencCs |jjS)N)r r )rrrrnameGszForeignObjectRel.namecCs|jS)N)r )rrrr remote_fieldKszForeignObjectRel.remote_fieldcCs?|jdj}t|dkr7tjdn|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_fieldOszForeignObjectRel.target_fieldcCs%|jjstdn|jjS)NzVThis property can't be accessed before self.field.contribute_to_class has been called.)r r AttributeError)rrrr related_modelZs  zForeignObjectRel.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__{s  zForeignObjectRel.__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. cSs(g|]}|jt|fqSr)Z _get_pk_valr).0xrrr s z0ForeignObjectRel.get_choices..)r%Z_default_managerall)rZ include_blankZ blank_choicerrr get_choicesszForeignObjectRel.get_choicescCs t|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_namecCs||r|jn |jj}|p'|j}|jrR|jrR||jkrRdSn|jrb|jS|j|jrwdndS)NZ_set)r0r%rrr r r1)rr optsrrrget_accessor_names  z"ForeignObjectRel.get_accessor_namecCsd|jS)Nz _%s_cache)rA)rrrrget_cache_nameszForeignObjectRel.get_cache_namecCs |jjS)N)r Zget_reverse_path_info)rrrrr szForeignObjectRel.get_path_info)#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[eZdZdZdddddfddZddZdd Zd d ZS) 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 sDtt|j||d|d|d|d|d|||_dS)Nr r rrr)superrJrr=) rr rr=r r rrr) __class__rrrs zManyToOneRel.__init__cCs#|jj}|jdd|S)Nr%)__dict__copypop)rstaterrr __getstate__szManyToOneRel.__getstate__cCs>|jjj|j}|js:tjd|jn|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_fields zManyToOneRel.get_related_fieldcCs"|jp|jjjj|_dS)N)r=r r0pkr)rrrrr>szManyToOneRel.set_field_name)r/rCrDrErrQrSr>rr)rLrrJs   rJcs7eZdZdZdddddfddZS) 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 sGtt|j|||d|d|d|d|d|d|_dS)Nr r rrrF)rKrUrr) rr rr=r r rrr)rLrrrs zOneToOneRel.__init__)r/rCrDrErrr)rLrrUs rUc sIeZdZdZdddddddfddZddZS) 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 stt|j||d|d|d||rG| rGtdn||_|rl| rltdn||_||_| |_dS)Nr r rz4Can't supply a through model and db_constraint=Falsez5Cannot specify through_fields without a through model)rKrVr ValueErrorthroughthrough_fieldsr db_constraint) rr rr r rrrXrYrZ)rLrrrs      zManyToManyRel.__init__cCs{|jj}|jr.|j|jd}nBx?|jD]4}t|dd}|r8|j|jkr8Pq8q8W|jdS)z Return the field in the 'to' object to which this relationship is tied. Provided for symmetry with ManyToOneRel. rrN)rXr0rYrRfieldsgetattrr Zforeign_related_fields)rr@r relrrrrSs  zManyToManyRel.get_related_field)r/rCrDrErrSrr)rLrrVs  rV)rE __future__rrZ django.corerZdjango.utils.deprecationrZdjango.utils.encodingrZdjango.utils.functionalrr?robjectr rJrUrVrrrr s .