_V@sddlmZddlZddlmZddlmZmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZmZddlmZddlmZm Z m!Z!ddl"m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)m*Z*e+Z,e-Z.dZ/d4Z0Gd,d-d-e+Z1d.d/Z2d0d1Z3e Gd2d3d3e+Z4dS)5)unicode_literalsN)bisect) OrderedDict defaultdict)chain)apps)settings)FieldDoesNotExist) connections) AutoField)OrderWrt)ManyToManyField)six) ImmutableList OrderedSet)RemovedInDjango110Warning) force_textpython_2_unicode_compatible smart_text)cached_property) lru_cache)camel_case_to_spaces)override string_concatzyThe return type of '%s' should never be mutated. If you want to manipulate this list for your own use, make a copy first. verbose_nameverbose_name_pluraldb_tableorderingunique_together permissions get_latest_byorder_with_respect_to app_label db_tablespaceabstractmanagedproxy swappable auto_createdindex_togetherrdefault_permissionsselect_on_savedefault_related_namerequired_db_featuresrequired_db_vendorc@s(eZdZddZddZdS)raise_deprecationcCs ||_dS)N)suggested_alternative)selfr0r2:/tmp/pip-build-ghmbqnp_/Django/django/db/models/options.py__init__-szraise_deprecation.__init__csfdd}|S)Ncs3tjdjjftdd||S)NzZ'%s is an unofficial API that has been deprecated. You may be able to replace it with '%s' stacklevel)warningswarn__name__r0r)argskwargs)fnr1r2r3wrapper1s   z+raise_deprecation.__call__..wrapperr2)r1r<r=r2)r<r1r3__call__0s zraise_deprecation.__call__N)r9 __module__ __qualname__r4r>r2r2r2r3r/,s  r/c Csyv|s fSt|ttfs+tntt|}t|ttfs^|f}ntdd|DSWntk r|SYnXdS)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. css|]}t|VqdS)N)tuple).0Zotr2r2r3 Msz%normalize_together..N) isinstancerAlist TypeErrornextiter)Zoption_togetherZ first_elementr2r2r3normalize_together>s   rIcCst|dt|S)Nwarning)rIMMUTABLE_WARNING)namedatar2r2r3make_immutable_fields_listTsrNc@sjeZdZdhZdiZd d d Zed d d dZed d ddZe ddZ e ddZ e ddZ e ddZ e ddZe ddZddZdd Zd!d"d#Zd$d%Zd&d'Zd(d)Zd*d+Zd,d-Ze d.d/Ze d0d1Zed2d3Zed4d5Zed6d7Zed8d9d:d;Zed8d9d<d=Z ed>d?Z!ed@dAZ"ed8d9dBdCZ#edDdEZ$edFdGZ%d dHdIZ&ed8dJdKdLZ'ed8d9dMdNZ(ed8d9d!d!d!dOdPZ)ed8d9d!d!d!dQdRZ*ed8d9d!dSdTZ+ed8d9dUdVZ,dWdXZ-dYdZZ.d[d\Z/d]d^Z0ed_d`Z1dadadbdcZ2dad!dddeZ3dadadad!d dfdgZ4d S)jOptionsfields many_to_manyconcrete_fieldslocal_concrete_fields_forward_fields_maprelated_objects fields_map_relation_treeNcCsii|_g|_g|_g|_g|_d|_d|_d|_d|_g|_ d|_ g|_ g|_ d|_ d|_g|_d|_||_d|_d|_tj|_g|_d|_||_d|_d|_d|_d|_d|_d|_d|_ d|_!d|_"t#|_$d|_%g|_&g|_'t(|_(d|_)dS)NFaddchangedeleteT)zaddrZzdelete)*_get_fields_cacheproxied_children local_fieldslocal_many_to_manyvirtual_fields model_namerrrr_ordering_clashrr)r+r*r object_namer"r r!rZDEFAULT_TABLESPACEr#r-r.metapkZhas_auto_fieldZ auto_fieldr$r%r&proxy_for_modelconcrete_modelr'rparentsr(managersZrelated_fkey_lookupsrr,)r1rdr"r2r2r3r4^sN                                      zOptions.__init__maxsizecCs1|jjj}||jkr'd}n||fS)N)model_metarg)r1linkrkr2r2r3 _map_models zOptions._map_modelcCs\|j p|j}|jjj}||jkr:d}n|joI|j}||||fS)N)r(concreterkrlrg is_relationrQ)r1rmdirectrkZm2mr2r2r3_map_model_detailss  zOptions._map_model_detailscCsd|j|jfS)Nz%s.%s)r"rc)r1r2r2r3labelsz Options.labelcCsd|j|jfS)Nz%s.%s)r"ra)r1r2r2r3 label_lowerszOptions.label_lowercCs|jjj|jS)N)rZ app_configsgetr")r1r2r2r3 app_configszOptions.app_configcCs |jdk S)N)rv)r1r2r2r3 installedszOptions.installedcCsdd|jDS)NcSs1g|]'\}}}|r||j|fqSr2)rL)rBcounterinstancer$r2r2r3 s z-Options.abstract_managers..)ri)r1r2r2r3abstract_managerss zOptions.abstract_managerscCsdd|jDS)NcSs1g|]'\}}}|s||j|fqSr2)rL)rBrxryr$r2r2r3rzs z-Options.concrete_managers..)ri)r1r2r2r3concrete_managerss zOptions.concrete_managerscCsEddlm}ddlm}||_||_|j|_|jj|_ t |j|_ i|_ |j r|j jj}x-|j jD]}|jdr||=qqWxtD]}||krt|||j|t|||j |.reverseFz%s has no field named %r_ordercss|]}t|tVqdS)N)rDr )rBfieldr2r2r3rCscs(g|]}|jjkr|qSr2)rL)rBZfld)rr2r3rz$s z$Options._prepare..rTrZID primary_keyr(id)r)r!rG _get_fields StopIterationr rcranyrlr^Z add_to_classr rerhr itervaluesrsetup_pkr )r1rkZalready_createdZautor2)rrr3_prepare s,  /       zOptions._prepareFc Cs|r|jj|n`|jrM|jrM|jjt|j||n,|jjt|j|||j||jrt |j dr|j j ry|j j j j ddWntk rYnX|j n|j dddS)NrkforwardFr)r`appendrprQr_insertrr^rr remote_fieldrkrl _expire_cacheAttributeError)r1rZvirtualr2r2r3 add_field.s" '  zOptions.add_fieldcCs,|j r(|jr(||_d|_ndS)NF)rer serialize)r1rr2r2r3rLs zOptions.setup_pkcCs+|jj|_||_|jj|_dS)zd Does the internal setup so that the current model is a proxy for "target". N)rlrerfr)r1targetr2r2r3 setup_proxyQs zOptions.setup_proxycCs d|jS)Nz)rc)r1r2r2r3__repr__ZszOptions.__repr__cCs dt|jt|jfS)Nz%s.%s)rr"ra)r1r2r2r3__str__]szOptions.__str__cs|js|js|j r dSttjr?tn|jrX|jjkS|j rt fdd|j DSdS)z Return True if the model can/should be migrated on the `connection`. `connection` can be either a real connection or a connection alias. Fc3s$|]}tj|dVqdS)FN)rfeatures)rBZfeat)r}r2r3rClsz&Options.can_migrate..T) r&swappedr%rDr string_typesr r.vendorr-all)r1r}r2)r}r3 can_migrate`s   zOptions.can_migratec Cs$tdt|jSWdQXdS)z There are a few places where the untranslated verbose name is needed (so that we get the same value regardless of currently active locale). N)rrr)r1r2r2r3verbose_name_rawps zOptions.verbose_name_rawc Cs|jrtt|jd}|ry|jd\}}Wntk rU|SYnXd||jf|jkr||SqndS)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. N.z%s.%s)r'rrsplit ValueErrorrrt)r1Z swapped_forZ swapped_labelZswapped_objectr2r2r3rzs    zOptions.swappedcsVddddddtdfdd|jdd DS) a2 Returns 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. cSs|jo|j S)N)rprQ)rr2r2r3sz Options.fields..cSs|jo|j S)N)rpZ one_to_many)rr2r2r3rscSs0|jo.|jo.t|jdo-|jj S)Nrk)rp many_to_onerrrk)rr2r2r3rsrPc3s9|]/}|r|r|r|VqdS)Nr2)rBr)is_not_a_generic_foreign_keyis_not_a_generic_relationis_not_an_m2m_fieldr2r3rCsz!Options.fields..rF)rNr)r1r2)rrrr3rPs    zOptions.fieldscCstddd|jDS)a Returns 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. rRcss|]}|jr|VqdS)N)ro)rBrr2r2r3rCsz*Options.concrete_fields..)rNrP)r1r2r2r3rRs zOptions.concrete_fieldscCstddd|jDS)z Returns 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. rScss|]}|jr|VqdS)N)ro)rBrr2r2r3rCsz0Options.local_concrete_fields..)rNr^)r1r2r2r3rSs zOptions.local_concrete_fieldsr0z get_fields()csfddjDS)Ncsg|]}j|qSr2)rn)rBr)r1r2r3rzs z1Options.get_fields_with_model..) get_fields)r1r2)r1r3get_fields_with_modelszOptions.get_fields_with_modelcsfddjDS)Ncsg|]}j|qSr2)rn)rBr)r1r2r3rzs z:Options.get_concrete_fields_with_model..)rR)r1r2)r1r3get_concrete_fields_with_modelsz&Options.get_concrete_fields_with_modelcCs&tddd|jddDS)a  Returns 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. rQcss'|]}|jr|jr|VqdS)N)rprQ)rBrr2r2r3rCsz'Options.many_to_many..rF)rNr)r1r2r2r3rQs zOptions.many_to_manycCs8|jdddddd}tddd|DS) ax Returns 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. rFrTinclude_hiddenrUcss+|]!}|j s|jjr|VqdS)N)hiddenrrQ)rBobjr2r2r3rCsz*Options.related_objects..)rrN)r1Zall_related_fieldsr2r2r3rUs zOptions.related_objectscsfddjDS)Ncsg|]}j|qSr2)rn)rBr)r1r2r3rzs z.Options.get_m2m_with_model..)rQ)r1r2)r1r3get_m2m_with_modelszOptions.get_m2m_with_modelc Cs`i}|jdd}xA|D]9}|||j.c3s$|]}|k r|jVqdS)N)rW)rBc)r1r2r3rCksc3s4|]*}s%|jjjj r|jVqdS)N)rrZ is_hidden)rBr)rr2r3rCns) PROXY_PARENTSrr from_iterablergrlr]rE)r1 local_onlyrinclude_proxy_eqrrPchildrenZ relationsr2)rr1r3get_all_related_objects_s   zOptions.get_all_related_objectscs/fddjd|d|d|DS)Ncsg|]}j|qSr2)rn)rBr)r1r2r3rzws z>Options.get_all_related_objects_with_model..rrr)r)r1rrrr2)r1r3"get_all_related_objects_with_modelssz*Options.get_all_related_objects_with_modelc CsM|dk rdnt}|jddddd|dd}dd|DS) NTrFrrrcSs(g|]}t|jtr|qSr2)rDrr )rBrr2r2r3rzs z@Options.get_all_related_many_to_many_objects..)rr)r1rrrPr2r2r3$get_all_related_many_to_many_objects~s   z,Options.get_all_related_many_to_many_objectscs5jdddddd}fdd|DS)NrFrTrcs1g|]'}t|jtrj|qSr2)rDrr rn)rBr)r1r2r3rzs zBOptions.get_all_related_m2m_objects_with_model..)r)r1rPr2)r1r3&get_all_related_m2m_objects_with_modelsz.Options.get_all_related_m2m_objects_with_modelcCsg|js gS||jkr#|gSx=|jD]2}|jj|}|r-|jd||Sq-WgS)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)rhrlget_base_chainr)r1rkparentrr2r2r3rs zOptions.get_base_chaincCsTt|j}x8|jD]-}x$|jjD]}|j|q/WqWt|S)z Returns all the ancestors of this model as a list ordered by MRO. Useful for determining if something is an ancestor, regardless of lineage. )rrhrlget_parent_listrYrE)r1resultrancestorr2r2r3rs zOptions.get_parent_listcCs[||jkr|j|Sx:|jD]/}|jj|}|r$|j|pR|Sq$WdS)a^ Returns 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. Returns None if the model isn't an ancestor of this one. N)rhrlget_ancestor_link)r1rr parent_linkr2r2r3rs  zOptions.get_ancestor_linkcCstt}|jjdd}x|D]}|jjr@q(ndd|jjddddD}xC|D];}t|jj t j so||jj jj |qoqoWq(Wx+|D]#}||j}||jj d.rFrrW)rrErZ get_modelsrlr$rrDrrkrrrrruEMPTY_RELATION_TREE)r1Zrelated_objects_graphZ all_modelsrkZfields_with_relationsrrUr2r2r3!_populate_directed_relation_graphs   ( %  z)Options._populate_directed_relation_graphcCs |jS)N)r)r1r2r2r3rWszOptions._relation_treeTc Csg}|r|j|jn|rB|j rB|j|jnx4|D],}yt||WqItk rtYqIXqIWi|_dS)N)extendFORWARD_PROPERTIESr$REVERSE_PROPERTIESdelattrrr\)r1rrZproperties_to_expire cache_keyr2r2r3rs   zOptions._expire_cachecCs+|dkrt}n|jd|d|S)a Returns a list of fields associated to the model. By default, includes 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 "+" Frr)rr)r1rrr2r2r3rs  zOptions.get_fieldsc Cs|ddtfkr+td|fnd}|dkrOt}d}n|j|j|||||f}y|j|SWntk rYnXg}|dk r]x|jD]} | |krqn| jj |j kr|tkrqnx`| jj d|d|d|d|d |D]1} t | d rE| j rEq!n|j | q!WqWn|r|j} x7| D],} |s| jj rs|j | jqsqsWn|r|jd d t|j|jD|r|jd d |jDqntd|}||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: %sNrrrr seen_modelsrcss|] }|VqdS)Nr2)rBrr2r2r3rCGsz&Options._get_fields..css|] }|VqdS)Nr2)rBrr2r2r3rCPsz get_fields())rrFrrYrkr\rrhrlrgrrrrrWrrrrr^r_r`rN) r1rrrrrZ topmost_callrrPrrZ all_fieldsrr2r2r3rsP          # zOptions._get_fields)zfieldsz many_to_manyzconcrete_fieldszlocal_concrete_fieldsz_forward_fields_map)zrelated_objectsz fields_mapz_relation_tree)5r9r?r@rrr4rrnrrpropertyrsrtrvrwr{r|rrrrrrrrrrrrPrRrSr/rrrQrUrrTrVrrrrrrrrrrrrWrrrr2r2r2r3rOXsj <  7 %       3      # rO)z verbose_namezverbose_name_pluralzdb_tablezorderingzunique_togetherz permissionsz get_latest_byzorder_with_respect_toz app_labelz db_tablespacezabstractzmanagedzproxyz swappablez auto_createdzindex_togetherzappszdefault_permissionszselect_on_savezdefault_related_namezrequired_db_featureszrequired_db_vendor)5 __future__rr7r collectionsrr itertoolsrZ django.appsrZ django.confrZdjango.core.exceptionsr rr Zdjango.db.models.fieldsr Zdjango.db.models.fields.proxyr Zdjango.db.models.fields.relatedr Z django.utilsrZdjango.utils.datastructuresrrZdjango.utils.deprecationrZdjango.utils.encodingrrrZdjango.utils.functionalrZdjango.utils.lru_cacherZdjango.utils.textrZdjango.utils.translationrrobjectrrArrKrr/rIrNrOr2r2r2r3sD