o
l>j @ s d Z ddlmZ ddlZddlmZmZmZ ddlm Z
ddl m Z m
Z
mZ dd
dZdddZd ddZd ddZdddZdS ) z
Debug helpers for mapping AttributeRuns to the exact text slices they cover.
These utilities are intended for troubleshooting renderer issues. They do not
perform any network I/O and can be safely used in tests.
) annotationsN)DictListOptional ) notes_pb2 )StyleSig _merge_runs_slice_for_runvalue
Optional[int]returnstrc C s8 |d u rdS z| t|W S ty t| Y S w )Nz(none))Nameint Exceptionr )enum_clsr r b/home/thesage/.local/lib/python3.10/site-packages/pyicloud/services/notes/rendering/debug_tools.py
_enum_name s r notepb.NoteList[Dict[str, object]]c C s | j pd}d}g }t| jD ]]\}}t|||j\}}|dr#|jnd}|||tt |ddp1d||dur=t |ddnd|durHt |ddnd|durSt |ddnd|dur^t |d dndt
|d
d |}q|S ) az Return a list of dictionaries mapping each AttributeRun to its text.
Each dict contains:
- index: run index
- utf16_start: start offset in UTF-16 code units
- utf16_len: run.length
- text: Python string slice for the run
- style_type, alignment, writing_direction, indent_amount
- has_attachment: whether run carries attachment_info
r paragraph_styleNlength
style_type alignmentwriting_direction_paragraph
indent_amountattachment_info index utf16_start utf16_lentextr r writing_directionr has_attachment) note_text enumerate
attribute_runr r HasFieldr appendr getattrbool) r r& posoutidxrsegpos2psr r r map_attribute_runs s4
r7 c C s g }t | D ]n}|ddurt|d nd}|dddddd d
d }ttj|d }ttj|d
}ttj|d}|d}| d|d dd|d dd|d dd|dd|d d |d d |d d!| d" qd
|S )#zEReturn a human-readable dump of runs with escaped whitespace markers.r& Nr
u ⏎
u ⤶
u ␀ z{OBJ}r r r' r [r# 03dz] off=r$ z<5 len=r% z<4z style=z<26z indent=z<2z align=z<16z wd=z<8u text=“u ”) r7 getr replacer pb StyleType AlignmentWritingDirectionr- join) r rowsrowrawprettyst_namealignwdindentr r r dump_runs_textD s4
&
rN c
C s g d}g }t | D ]r}t|d }||t| }t|dd}d| d|d d|d d
ttj|d d |d
d
ttj|d d
ttj |d }t
| dd dd dd dd}|
dt
| d| d| d q
d|} d | d S ) zReturn a small HTML page highlighting each run in a different color.
Hover tooltips include run index, offsets, and style information.
)z#FFF3CDz#D1ECF1z#F8D7DAz#D4EDDAz#E2E3E5r# r& r zrun z | off=r$ r> r% z | r z ind=r r r' r9 u ⤶r8 u ⏎r; z {OBJ}r: u ␀zza6 z
)r7 r lenr r? r rA rB rC rD htmlescaper@ r- rE )
r palettespansrG r2 bgrH tipsafecontentr r r annotate_note_runs_html\ s<
rX c C s | j pd}t| j}g }d}t|D ]9\}}t|||j\}}|j}||||j |j|t|ddt|ddt|ddt|ddt|dddud q|S )
zSame as map_attribute_runs, but after the renderer's run merge step.
Useful to understand how the renderer will chunk paragraphs.
r r r Nr r' r
attachmentr" ) r) r
r+ r* r r sigr- r. ) r r& mergedr1 r0 r2 mrr4 rZ r r r map_merged_runs s(
r] )r r
r r )r r r r )r r r r )__doc__
__future__r rP typingr r r protobufr rA rendererr r
r r r7 rN rX r] r r r r s
(
-