Function Repository Resource:

ExpressionLineDiff (1.1.1) current version: 1.1.2 »

Highlight the changes between two expressions

Contributed by: Richard Hennigan (Wolfram Research)

ResourceFunction["ExpressionLineDiff"][expr₁,expr₂]

highlights changes between expr₁ and expr₂.

Details and Options

ResourceFunction["ExpressionLineDiff"] displays changes between two expressions in a manner similar to many Git diff utilities that are used to display file changes.

ResourceFunction["ExpressionLineDiff"] has the following options:

"TrimmingThreshold"

the maximum number of consecutive unchanged lines to display

"IndentSize"

the number of spaces to use per indentation level

"PageWidth"

100

the desired formatting width of the output

PerformanceGoal

"Quality"

control the level of detail in the highlighting

"MergeThreshold"

minimum length of consecutive unchanged characters required to merge into surrounding changes

ResourceFunction["ExpressionLineDiff"] uses the resource function ReadableForm to convert expressions to lines.

Examples

Basic Examples (2)

Highlight the differences between two expressions on a per-line basis:

In[1]:=

expr1 = Cell[BoxData[RowBox[{"1", "+", "1"}]], "Input", CellLabel -> "In[1]:=", CellTags -> {"neat"}, CellID -> 731245485];
expr2 = Cell[BoxData[RowBox[{"1", "+", "1"}]], "Input", CellLabel -> "In[2]:=", CellTags -> {"neat"}, CellID -> 731245435];

In[2]:=

Out[2]=

Check larger expressions:

In[3]:=

In[4]:=

Out[4]=

Options (9)

TrimmingThreshold (2)

Control the maximum number of consecutive unchanged lines to display:

In[5]:=

In[6]:=

Out[6]=

Show all lines:

In[7]:=

Out[7]=

IndentSize (1)

Adjust the amount of indentation:

In[8]:=

In[9]:=

Out[9]=

PageWidth (2)

Reducing the page width will increase the number of lines:

In[10]:=

In[11]:=

Out[11]=

Conversely, a larger page width will decrease the number of lines:

In[12]:=

Out[12]=

PerformanceGoal (2)

By default, ExpressionLineDiff will use darker colors to highlight per-character changes:

In[13]:=

In[14]:=

Out[14]=

With the option setting PerformanceGoal→"Speed", only per-line highlighting will be used:

In[15]:=

Out[15]=

MergeThreshold (2)

Control how many unchanged characters get merged into surrounding changes:

In[16]:=

In[17]:=

Out[17]=

In[18]:=

Out[18]=

A merge threshold of zero highlights exact changes:

In[19]:=

Out[19]=

Applications (3)

Quickly find why two expressions that otherwise appear identical are different:

In[20]:=

Out[20]=

In[21]:=

Out[21]=

These are not in fact SameQ:

In[22]:=

Out[22]=

The difference is due to underlying Dynamic elements that use different local variables:

In[23]:=

Out[23]=

Possible Issues (2)

ExpressionLineDiff compares InputForm strings, so highlighting does not necessarily align with subexpressions:

In[24]:=

In[25]:=

Out[25]=

This is comparable to using SequenceAlignment on the string representations:

In[26]:=

Out[26]=

In[27]:=

$% /. {a_String, b_String} :> Column[{Item[a, Background -> LightRed], Item[b, Background -> LightGreen]}]$

Out[27]=

For flat lists, SequenceAlignment can identify changes per element:

In[28]:=

Out[28]=

In[29]:=

$% /. {a_List, b_List} :> Column[{Item[a, Background -> LightRed], Item[b, Background -> LightGreen]}]$

Out[29]=

With the option setting PerformanceGoal→"Speed", ExpressionLineDiff only looks for changes on a per-line basis and does not highlight detailed changes:

In[30]:=