a JcfO@sddlZddlZddlZddlmZddlmZddlmZm Z ddl m Z ddl m Z ddlmZddlmZmZdd lmZmZdd lmZdd lmZdd lmZdd lmZddlmZddlm Z!dddDZ"dde"#DZ$edd%dde$DZ&Gddde'Z(ddZ)dHddZ*dd Z+d!d"Z,d#d$Z-d%d&Z.d'd(Z/Gd)d*d*e Z0d+d,Z1dId-d.Z2dJd/d0Z3d1d2Z4dKd4d5Z5d6d7Z6d8d9Z7dLd:d;Z8Gdd?Z:d@dAZ;dBdCZdS)MN) defaultdict)FieldDoesNotExist)modelsrouter) LOOKUP_SEP) Collector) pretty_name)NoReverseMatchreverse)formatstimezone) make_hashable) format_html)_lazy_re_compile)capfirst)ngettext)overridecCsi|]}|d|qS)z_%02X).0irrW/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/django/contrib/admin/utils.py rs":/_#?;@&=+$,"[]<>% \cCsi|]\}}|t|qSr)chr)rkvrrrrrz_(?:%s)|cCsg|]}|ddqS)Nr)rxrrr rrc@seZdZdZdS)FieldIsAForeignKeyColumnNamez/A field is a foreign key attname, i.e. _id.N)__name__ __module__ __qualname____doc__rrrrr sr c Cs|t}|D]l}|dkr"|jj}z||}WntyFYqYq0t|dr|j}|dj}t dd|DrdSqdS)zA Return True if the given lookup path spawns duplicates. pk path_infoscss|] }|jVqdSN)Zm2m)rpathrrr 2rz+lookup_spawns_duplicates..TF) splitrr%name get_fieldrhasattrr&to_optsany)optsZ lookup_pathZ lookup_fields field_namefieldZ path_inforrrlookup_spawns_duplicatess     r4,cCs0|dr||}n|dr,|dv}|S)zJ Return a lookup value prepared to be used in queryset filtering. Z__inZ__isnull)false0)endswithr+lower)keyvalue separatorrrrprepare_lookup_value9s     r>cCst|tr|tS|S)a* Ensure that primary key values do not confuse the admin URLs by escaping any '/', '_' and ':' and similarly problematic characters. Similar to urllib.parse.quote(), except that the quoting is slightly different so that it doesn't get automatically unquoted by the web browser. ) isinstancestr translate QUOTE_MAPsrrrquoteFsrEcCstdd|S)zUndo the effects of quote().cSs t|dS)Nr) UNQUOTE_MAP)mrrrRrzunquote..) UNQUOTE_REsubrCrrrunquotePsrKcCs6g}|D](}t|ttfr&||q||q|S)zS Return a list which is a single level of flattening of the original list. )r?listtupleextendappend)fieldsZflatr3rrrflattenUs   rQcCs(g}|D]\}}|t|dq|S)z?Return a list of field names from an admin fieldsets structure.rP)rNrQ)Z fieldsets field_namesr,r1rrrflatten_fieldsetsbs rSc sz |d}Wn ty,gitgfYS0t|jj}t||d}||tfdd|}fdd|j D}dd|j D}|||fS) a Find all objects related to ``objs`` that should also be deleted. ``objs`` must be a homogeneous iterable of objects (e.g. a QuerySet). Return a nested list of strings suitable for display in the template with the ``unordered_list`` filter. r)usingorigincs|j}|jv}|j}dt|j|f}|rj||sJ|jz(tdj|j |j fdt |j f}Wnt y|YS0tdt|j||S|SdS)Nz%s: %sz%s:%s_%s_changez{}: {}) __class__ _registry_metar verbose_nameZhas_delete_permissionaddr r, app_label model_namerEr%r r)objmodelZ has_adminr1Z no_edit_linkZ admin_url) admin_site perms_neededrequestrrformat_callback|s*     z,get_deleted_objects..format_callbackcsg|] }|qSrr)rr])rbrrrrz'get_deleted_objects..cSsi|]\}}|jjt|qSr)rXverbose_name_plurallen)rr^objsrrrrsz'get_deleted_objects..) IndexErrorsetrZ db_for_writerXr^ NestedObjectscollectnested protected model_objsitems) rerar_r]rT collectorZ to_deleterkZ model_countr)r_rbr`rarget_deleted_objectsjs     rocsXeZdZfddZddZdfdd Zfdd Zd d Zdd d ZddZ Z S)rhcs.tj|i|i|_t|_tt|_dSr()super__init__edgesrgrkrrlselfargskwargsrVrrrqszNestedObjects.__init__cCs|j|g|dSr()rr setdefaultrO)rtsourcetargetrrradd_edgeszNestedObjects.add_edgeNc s|D]\}|r@|ds@||jj|jjd}|t|||n |d||j|jj|qzt j |fd|i|WSt j y}z|j |jWYd}~n.)rprelated_objectsZselect_related)rt related_modelZrelated_fieldsreqsrwrrrs zNestedObjects.related_objectscCsj||vr gS||g}|j|dD]}|||||q(|rR||g}n|g}|rf|||S)Nr)rZrrgetrN_nestedrO)rtr]seenrbchildrenchildretrrrrs   zNestedObjects._nestedcCs6t}g}|jddD]}|||||q|S)z4 Return the graph as a nested list. Nr)rgrrrrNr)rtrbrrootsrootrrrrjs zNestedObjects.nestedcOsdS)z We always want to load the objects into memory so that we can display them to the user in confirm page. Frrsrrrcan_fast_deleteszNestedObjects.can_fast_delete)NN)N) r!r"r#rqr{rirrrjr __classcell__rrrwrrhs   rhcCsFt|tjtjjfr|j}nt|tjjr4|jj}n|}|j |j dS)z Return a `dict` with keys 'verbose_name' and 'verbose_name_plural', typically for use with string formatting. `obj` may be a `Model` instance, `Model` subclass, or `QuerySet` instance. )rYrc) r?rZModelbaseZ ModelBaserXqueryQuerySetr^rYrc)r]r1rrrmodel_format_dicts rcCsNt|tjjr$|dur|}|j}t|}|d|d}}t|||pJdS)a- Return the appropriate `verbose_name` or `verbose_name_plural` value for `obj` depending on the count `n`. `obj` may be a `Model` instance, `Model` subclass, or `QuerySet` instance. If `obj` is a `QuerySet` instance, `n` is optional and the length of the `QuerySet` is used. NrYrcr)r?rrrcountr^rr)r]ndZsingularpluralrrrmodel_ngettexts rc Cs|j}zt||}Wntttfyt|r<|}||}nDt||rb|dkrbt||}||}nt||}t|r||}n|}d}Yn0d}t||}|||fS)N__str__)rX_get_non_gfk_fieldrr callabler.r)r,r] model_adminr1fattrr<rrr lookup_field s$      rcCsR||}|jr(|jr|jr"|jr(t|jrN|jsNt|drN|j|krNt |S)a For historical reasons, the admin app relies on GenericForeignKeys as being "not found" by get_field(). This could likely be cleaned up. Reverse relations should also be excluded as these aren't attributes of the model (rather something like `foo_set`). attname) r- is_relationZ many_to_onerZ one_to_manyrZ many_to_manyr.rr )r1r,r3rrrr's( rFc Csd}z:t|j|}z |j}Wnty8|jjj}Yn0WnVtyv|dkrjt|jj}t}nt|rx|}nt||rt ||}npt||rt ||}nZ|r||j vr|j |}n@d||jj f}|r|d|j j 7}|r|d|j j 7}t|t|dr|j}n`t|trBt|drBt|jdrB|jj}n0t|rj|j dkr^d}n t|j }nt|}Yn tyt|}|}Yn0|r||fS|SdS) ak Return a sensible label for a field name. The name can be a callable, property (but not created with @property decorator), or the name of an object's attribute, as well as a model field. If return_attr is True, also return the resolved attribute (which could be a callable). This will be None if (and only if) the name refers to a field. NrzUnable to lookup '%s' on %sz or %sshort_descriptionfgetzz--)rrXrYAttributeErrorrrr@rr.rrPZ object_namerVr!rr?propertyrrr ) r,r^rZ return_attrformrr3labelmessagerrrlabel_for_fieldDs`                 rc Cs@d}zt|j|}Wnttfy*Yn0t|dr<|j}|S)Nr6 help_text)rrXrr r.r)r,r^rr3rrrhelp_text_for_fields rcCspddlm}t|ddrfzt|j||WSty`t|j}t|}t|||YS0nt|t j rz||S|dur|St|t j rt t|St|t jt jfrt |St|t jrt ||jSt|t jt jfrt |St|t jr|rtd|j|St|t jrb|rbztj|d|jdWSty^t||YS0n t||SdS)Nr _boolean_icon flatchoicesz{}F) ensure_asciicls),django.contrib.admin.templatetags.admin_listrrdictrr TypeErrorr r?rZ BooleanFieldZ DateTimeFieldr localizer template_localtimeZ DateFieldZ TimeFieldZ DecimalField number_formatZdecimal_placesZ IntegerFieldZ FloatFieldZ FileFieldrurlZ JSONFieldjsondumpsencoderdisplay_for_value)r<r3empty_value_displayrrrrrdisplay_for_fields8         rcCsddlm}|r||S|dur$|St|tr6t|St|tjrRtt |St|tj tj frnt|St|t t jtfrt|St|ttfrddd|DSt|SdS)Nrrz, css|]}t|VqdSr()r@)rrrrrr*rz$display_for_value..)rrr?boolr@datetimer rr rdatetimeintdecimalDecimalfloatrrLrMjoin)r<rbooleanrrrrrs      rc@s eZdZdS)NotRelationFieldN)r!r"r#rrrrrsrcCs t|dr|jdjjStdS)Nr&r')r.r&r/r^r)r3rrrget_model_from_relations rc Csg}|}|t}|D]}|j|}t|t|dkr`z t|Wnty^YqYn0|jr|jrr|j r| }|j j }n|j j}|j}|d|q|t|fS)zCreate a reversed field path. E.g. Given (Order, "user__groups"), return (Group, "user__order"). Final field must be a related model, not a data field. rr)r+rrXr-rdrrrZ auto_createdZconcreteZrelated_query_nameZ remote_fieldr^r3r,rinsertr)r^r)Z reversed_pathparentpiecespiecer3rrrrreverse_field_paths"      rcCsD|t}g}|D],}|r(t|d}n|}||j|q|S)a:Return list of Fields given path relative to model. e.g. (ModelX, "user__groups__name") -> [ , , , ] r')r+rrrOrXr-)r^r)rrPrrrrrget_fields_from_paths rc Cs<|j}tdt||}Wdn1s.0Yg}|rP|diin|jrh|dd|ii|r8td|D]}|jD]$}|dt|jjt|diq|jD]6\}} |dt|jjt|t|j d| diq|j D]$} |dt| jjt| diqq|Wdn1s.0Y|S) z Construct a JSON structure describing changes from a changed object. Translations are deactivated so that strings are stored untranslated. Translation happens later on LogEntry access. NaddedchangedrP)r,objectr)r,rrPZdeleted) changed_datatranslation_override#_get_changed_field_labels_from_formrOZ new_objectsr@rXrYZchanged_objectsZformsZdeleted_objects) rZformsetsrZrchanged_field_labelsZchange_messageZformsetZ added_objectZchanged_objectZchanged_fieldsZdeleted_objectrrrconstruct_change_message sN  (       (rc CsLg}|D]>}z|j|jp|}Wnty6|}Yn0|t|q|Sr()rPrKeyErrorrOr@)rrrr2Zverbose_field_namerrrrBs  r)r5)N)N)NFN)F)?rrr collectionsrZdjango.core.exceptionsrZ django.dbrrZdjango.db.models.constantsrZdjango.db.models.deletionrZdjango.forms.utilsrZ django.urlsr r Z django.utilsr r Zdjango.utils.hashabler Zdjango.utils.htmlrZdjango.utils.regex_helperrZdjango.utils.textrZdjango.utils.translationrrrrBrmrFrrI Exceptionr r4r>rErKrQrSrorhrrrrrrrrrrrrrrrrrrsT              ;C   A % 9