NwgG%ddlZddlmZddlmZmZmZmZmZm Z m Z ddl m Z m Z ddlmZddlmZmZddlmZdd lmZmZmZmZdd lmZd ed efd Zded efdZGddZ GddZ!y)N) commonprefix)AnyDictFinalListTupleTypeUnion)ManyToManyFieldModel)conditional_escape) SafeString mark_safe)capfirst)HistoricalChanges ModelChangeModelChangeValue ModelDelta)get_m2m_reverse_field_nameobjreturnc<t|tr|St|S)z@ Converts ``obj`` to a string, unless it's already one. ) isinstancestr)rs T/var/www/horilla/myenv/lib/python3.12/site-packages/simple_history/template_utils.pyconditional_strrs#s s8Osct|dS)z Returns whether ``s`` is a (presumably) pre-escaped string or not. This relies on the same ``__html__`` convention as Django's ``conditional_escape`` does. __html__)hasattr)rs r is_safe_strr#s 1j !!rc eZdZUdZdZeed<eddeede fdZ de d e e eeffd Zd ed efd Zd ed ed efdZd ededed eeeffdZddZy)HistoricalRecordContextHelperzm Class containing various utilities for formatting the template context for a historical record. d(DEFAULT_MAX_DISPLAYED_DELTA_CHANGE_CHARS) max_displayed_delta_change_charsmodelhistorical_recordc.||_||_||_yN)r)recordr()selfr)r*r(s r__init__z&HistoricalRecordContextHelper.__init__)s ' 0P-rdeltarcg}|jD]F}|j|}|j|j|j|j dH|S)a Return the template context for ``delta.changes``. By default, this is a list of dicts with the keys ``"field"``, ``"old"`` and ``"new"`` -- corresponding to the fields of ``ModelChange``. :param delta: The result from calling ``diff_against()`` with another historical record. Its ``old_record`` or ``new_record`` field should have been assigned to ``self.record``. fieldoldnew)changesformat_delta_changeappendr3r4r5)r.r0 context_listchangeformatted_changes rcontext_for_delta_changesz7HistoricalRecordContextHelper.context_for_delta_changes5sc mm F#77?    -33+//+//  rr:cT|j||j}|j||j}|j|||\}}|jj j |j}tj|t|j||S)zs Return a ``ModelChange`` object with fields formatted for being used as template context. r2) prepare_delta_change_valuer4r5stringify_delta_change_valuesr)_meta get_fieldr3 dataclassesreplacer verbose_name)r.r:r4r5 field_metas rr7z1HistoricalRecordContextHelper.format_delta_changeKs --ffjjA--ffjjA55fc3GSZZ%%// = "" :223   rvaluec|jjj|j}t |t rt |}|Dcgc]}|| }}|S|}|Scc}w)a Return the prepared value for the ``old`` and ``new`` fields of ``change``, before it's passed through ``stringify_delta_change_values()`` (in ``format_delta_change()``). For example, if ``value`` is a list of M2M related objects, it could be "prepared" by replacing the related objects with custom string representations. :param change: :param value: Either ``change.old`` or ``change.new``. )r)r@rAr3rr r)r.r:rFrEreverse_field_nameobj_values_dict display_values rr>z8HistoricalRecordContextHelper.prepare_delta_change_value]su ZZ%%// = j/ 2!;J!G LQ8G 23M "M s A#r4r5cdtdtttffd}||||}}|j }|j ||\}} t |t | fS)a Called by ``format_delta_change()`` after ``old`` and ``new`` have been prepared by ``prepare_delta_change_value()``. Return a tuple -- ``(old, new)`` -- where each element has been escaped/sanitized and turned into strings, ready to be displayed in a template. These can be HTML strings (remember to pass them through ``mark_safe()`` *after* escaping). If ``old`` or ``new`` are instances of ``list``, the default implementation will use each list element's ``__str__()`` method, and also reapply ``mark_safe()`` if all the passed elements are safe strings. rFrct|trIddjtt|d}t tt |r t|}|St |}|S)N[z, ])rlistjoinmaprallr#r)rFstrings rstringify_valuezTHistoricalRecordContextHelper.stringify_delta_change_values..stringify_values^%&TYYs?E'BCDAFs;./&v.FM)/Mr)rr rrget_obj_diff_displaycommon_shorten_reprr ) r.r:r4r5rTold_strnew_str diff_display old_short new_shorts rr?z;HistoricalRecordContextHelper.stringify_delta_change_valuesxsp" 3 5j+A +3/1E002 +??Q 9"),.@.KKKrc.t|jS)z Return an instance of ``ObjDiffDisplay`` that will be used in ``stringify_delta_change_values()`` to display the difference between the old and new values of a ``ModelChange``. ) max_length)ObjDiffDisplayr()r.s rrUz2HistoricalRecordContextHelper.get_obj_diff_displays )N)NOOrN)rr^)__name__ __module__ __qualname____doc__r'r__annotations__r r rr/rrrrrr<rr7rr>rrr?rUrrr%r%!s 7:,e9*R QE{ Q- Qzd4S>>R, + + $  6#L!#L(+#L25#L z:% &#LJPrr%cneZdZdZdddddddZdedeed ffd Zd ed e d e defdZ dede dedefdZ y)r^a& A class grouping functions and settings related to displaying the textual difference between two (or more) objects. ``common_shorten_repr()`` is the main method for this. The code is based on https://github.com/python/cpython/blob/v3.12.0/Lib/unittest/util.py#L8-L52. P )r]placeholder_len min_begin_len min_end_lenmin_common_lenc||_||_||_||_||_|||z|z|z|zz |_|j dk\sJy)Nr)r]rirjrkrl min_diff_len)r.r]rirjrkrls rr/zObjDiffDisplay.__init__su%.*&,&         A%%%rargsr.cttt|}ttt|}|j kr|St |t j |z jzjzz }|jkDrmjjzjz|z zj ksJjj|tfd|DSjjjtfd|DS)a6 Returns ``args`` with each element converted into a string representation. If any of the strings are longer than ``self.max_length``, they're all shortened so that the first differences between the strings (after a potential common prefix in all of them) are lined up. c30K|] }|dywr,rd).0rprefix prefix_lens r z5ObjDiffDisplay.common_shorten_repr..s!CF8AjkN#34Csc3xK|]1}j|djjz3ywr,)shortenrnrk)rrrrsrtr.s rruz5ObjDiffDisplay.common_shorten_repr..s=  T\\!JK.$2C2CTEUEUV V s7:) tuplerQrmaxlenr]rrjrirlrw)r.romax_len common_lenrsrts` @@rrVz"ObjDiffDisplay.common_shorten_reprs5S$/0c#tn% doo %Kd#[ __ j 4#5#5 58L8L L  ++ +""&&'%%&Z')// " " \\&$*<*4<=9IJArrsnum_skipped_charssuffixc|d|dd|S)a Return a shortened version of the string representation of one of the args passed to ``common_shorten_repr()``. This should be in the format ``f"{prefix}{skip_str}{suffix}"``, where ``skip_str`` is a string indicating how many characters (``num_skipped_chars``) of the string representation were skipped between ``prefix`` and ``suffix``. rMdz chars]rd)r.rsrrs rrzObjDiffDisplay.shortened_strs,Q/wvh??rN) r_r`rarbr/rrrrVintrwrrdrrr^r^s&.! ! sCx! F#33@C@C@@QT@rr^)"rBos.pathrtypingrrrrrr r django.db.modelsr r django.utils.htmlr django.utils.safestringrrdjango.utils.textrmodelsrrrrutilsrrrboolr#r%r^rdrrrsl ===309&PP-"3"4"BPBPJS@S@r