h+dZddlmZddlmZddlmZmZddlm Z ddl m Z ddl m Z dd lmZGd d eZGd d eZGddej(e Zy)z4 Seamless Polymorphic Inheritance for Django Models ) ContentType)models)ForwardManyToOneDescriptorReverseOneToOneDescriptor)DEFAULT_DB_ALIAS)PolymorphicModelBase)PolymorphicManagertranslate_polymorphic_Q_objectc eZdZy)PolymorphicTypeUndefinedN__name__ __module__ __qualname__B/home/dcms/DCMS/lib/python3.12/site-packages/polymorphic/models.pyrrrrc eZdZy)PolymorphicTypeInvalidNrrrrrrrrrceZdZdZdZdZejeddejdZ dgZ e Z GddZed Zefd Zde_fd Zde_d Zd ZdZdZfdZdZxZS)PolymorphicModela# Abstract base class that provides polymorphic behaviour for any model directly or indirectly derived from it. PolymorphicModel declares one field for internal use (:attr:`polymorphic_ctype`) and provides a polymorphic manager as the default manager (and as 'objects'). TFz(polymorphic_%(app_label)s.%(class)s_set+)nulleditable on_delete related_namepolymorphic_ctypeceZdZdZdZy)PolymorphicModel.MetaTobjectsN)rrrabstractbase_manager_namerrrMetar!:s %rr%ct||SNr )clsqs rr z/PolymorphicModel.translate_polymorphic_Q_object>s-c155rc|js6tjj|j |d|_yy)z[ Make sure the ``polymorphic_ctype`` value is correctly set on this model. Ffor_concrete_modelN)polymorphic_ctype_idrr" db_manager get_for_modelr)selfusings rpre_save_polymorphicz%PolymorphicModel.pre_save_polymorphicBsA((%0%8%8%C%CE%J%X%X&Y&D ")rc|jd|jjxst}|j |t ||i|S)z7Calls :meth:`pre_save_polymorphic` and saves the model.r1)r1)get_statedbrr2supersave)r0argskwargsr1 __class__s rr8zPolymorphicModel.saveRsF 7DKKNN$F6FG !!!.w|T,V,,rc H|j0td|jjd|jdt j j|jjj|jj}|t||jss|jjj*t||jjjs)td|jd|d|jd|S)z Return the actual model type of the object. If a non-polymorphic manager (like base_objects) has been used to retrieve objects, then the real class/type of these objects may be determined using this method. z The model #z does not have a `polymorphic_ctype_id` value defined. If you created models outside polymorphic, e.g. through an import or migration, make sure the `polymorphic_ctype_id` field points to the ContentType ID of the model subclass.z ContentType z for z #z does not point to a subclass!)r-rr;rpkrr"r.r5r6 get_for_id model_class issubclass_metaproxy_for_modelr)r0models rget_real_instance_classz(PolymorphicModel.get_real_instance_classZs  $ $ ,*T^^445Qtwwi@qr     * *4;;>> : Z11 2 []   udnn5$$44<!%)=)=)M)MN)t889ugRyPno  rc|j}|ytjj|jj j |djSNTr+)rErr"r.r5r6r/r>r0r@s r#get_real_concrete_instance_class_idz4PolymorphicModel.get_real_concrete_instance_class_idsM224      * *4;;>> : ];4] @ R rc|j}|ytjj|jj j |djSrG)rErr"r.r5r6r/r@rHs r get_real_concrete_instance_classz1PolymorphicModel.get_real_concrete_instance_classsO224      * *4;;>> : ];4] @ [] rc|j}||jk(r|S|jj|jj j |jS)a Upcast an object to it's actual type. If a non-polymorphic manager (like base_objects) has been used to retrieve objects, then the complete object with it's real class/type and all fields may be retrieved with this method. .. note:: Each method call executes one db query (if necessary). Use the :meth:`~polymorphic.managers.PolymorphicQuerySet.get_real_instances` to upcast a complete list in a single efficient query. r>)rEr;r"r.r5r6r4r>)r0 real_models rget_real_instancez"PolymorphicModel.get_real_instancesT113  'K!!,,T[[^^<@@DGG@LLrc t||i||jjryd|j_d}|j }|j D]c\}}t |j|d}tt|ttfs=t|j|t|||ey)aKReplace Django's inheritance accessor member functions for our model (self.__class__) with our own versions. We monkey patch them until a patch can be added to Django (which would probably be very small and make all of this obsolete). If we have inheritance of the form ModelA -> ModelB ->ModelC then Django creates accessors like this: - ModelA: modelb - ModelB: modela_ptr, modelb, modelc - ModelC: modela_ptr, modelb, modelb_ptr, modelc These accessors allow Django (and everyone else) to travel up and down the inheritance tree for the db object at hand. The original Django accessors use our polymorphic manager. But they should not. So we replace them with our own accessors that use our appropriate base_objects manager. NTcfd}|S)Ncntdj}|j|j}|S)N _base_objectsrM)getattrr"r4r>)r0r"attrrDs raccessor_functionz`PolymorphicModel.__init__..create_accessor_function_for_model..accessor_functions.!%%--H{{dgg{. rr)rD accessor_namerVs` r"create_accessor_function_for_modelzEPolymorphicModel.__init__..create_accessor_function_for_models  % $r) r7__init__r;(polymorphic_super_sub_accessors_replaced+_get_inheritance_relation_fields_and_modelsitemsrTrAtyperrsetattrproperty) r0r9r:rX%subclasses_and_superclasses_accessorsnamerD orig_accessorr;s rrYzPolymorphicModel.__init__s& $)&) >> B B BF? %150`0`0b-@FFH KD%#DNND$?M]#*,FGNN?tLM rcdfdfdfd}i}j||j||S)zxhelper function for __init__: determine names of all Django inheritance accessor member functions for type(self)c|||<yr'r)rD field_nameresults r add_modelzOPolymorphicModel._get_inheritance_relation_fields_and_models..add_models !&F: rct|tjr9|tjk7r%|jk7r|tk7r |||yyyyyr')rArModelr;r)rDrerfrgr0s radd_model_if_regularzZPolymorphicModel._get_inheritance_relation_fields_and_models..add_model_if_regularsR5&,,/V\\)T^^+--%V4.,*0rc|jjjD]'\}}| |j}|||||)yr')rBparentsr\ra)rDrf super_clsfield_to_superreadd_all_super_modelsrjs rrozZPolymorphicModel._get_inheritance_relation_fields_and_models..add_all_super_modelssS-2[[-@-@-F-F-H <) >!-"0!4!4J(JG(F; .add_all_sub_modelss$335 U 5 55%,]]%:%:9%EN%15C5P5P25BBJ4;4D4D4J4J4L15O4[4[1,W6KVT Urr;)r0rwrfrorgrjs` @@@rr[z>62 r)rrr__doc__polymorphic_model_marker"polymorphic_query_multiline_outputr ForeignKeyrCASCADEr!polymorphic_internal_model_fieldsr r"r% classmethodr rr2 alters_datar8rErIrKrOrYr[ __classcell__rxs@rrrs $*/&*)) ..? *=(=%!"G&&66*: (,$- D(T  M$.`0rr) metaclassN)ry"django.contrib.contenttypes.modelsr django.dbrdjango.db.models.fields.relatedrrdjango.db.utilsrbaser managersr query_translater LookupErrorr RuntimeErrorrrirrrrrsN;a,&(;  {  \ pv||/Cpr