Meziantou.Framework.TextDiff 2.0.4

Prefix Reserved
.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package Meziantou.Framework.TextDiff --version 2.0.4
                    


                    

                
NuGet\Install-Package Meziantou.Framework.TextDiff -Version 2.0.4
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Meziantou.Framework.TextDiff" Version="2.0.4" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Meziantou.Framework.TextDiff" Version="2.0.4" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Meziantou.Framework.TextDiff" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Meziantou.Framework.TextDiff --version 2.0.4
                    


                    

                
#r "nuget: Meziantou.Framework.TextDiff, 2.0.4"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Meziantou.Framework.TextDiff@2.0.4
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Meziantou.Framework.TextDiff&version=2.0.4
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Meziantou.Framework.TextDiff&version=2.0.4
                    


                            Install as a Cake Tool

Meziantou.Framework.TextDiff

Compute text differences at line, word, or character level with configurable comparison options.

Install the NuGet package Meziantou.Framework.TextDiff (NuGet)

dotnet package add Meziantou.Framework.TextDiff

Basic usage

var oldText = "line1\nline2\nline3";
var newText = "line1\nline2 updated\nline3";

var result = TextDiff.ComputeDiff(oldText, newText);

foreach (var entry in result.Entries)
{
    Console.WriteLine($"{entry.Operation}: {entry.Text}");
}

Configure chunking and comparison

var options = new TextDiffOptions
{
    Chunker = TextChunker.Words,        // Lines (default), Words, Characters, or custom chunker
    IgnoreCase = true,
    IgnoreWhitespace = true,
    IgnoreEndOfLine = true,
};

var result = TextDiff.ComputeDiff("Hello   world\r\n", "hello world\n", options);

Compute a hierarchical diff with multiple chunking levels

var result = TextDiff.ComputeHierarchyDiff(
    oldText: "line1\nhello world\nline3",
    newText: "line1\nhello brave world\nline3",
    chunkers: [TextChunker.Lines, TextChunker.Words, TextChunker.Characters]);

foreach (var entry in result.Entries)
{
    Console.WriteLine($"{entry.Operation}: old={entry.OldText} new={entry.NewText}");

    foreach (var child in entry.Children)
    {
        Console.WriteLine($"  {child.Operation}: old={child.OldText} new={child.NewText}");
    }
}

The hierarchy API lets you refine changed chunks progressively (Lines -> Words -> Characters, Words -> Characters, etc.).

Choose a diff algorithm

var options = new TextDiffOptions
{
    Algorithm = TextDiffAlgorithm.Patience,
};

var result = TextDiff.ComputeDiff(oldText, newText, options);

Available algorithms:

  • TextDiffAlgorithm.Myers (default): best default when you want a high-quality, shortest-edit-script style diff.
  • TextDiffAlgorithm.Patience: best for human-readable output in reviews, even if edits are not always minimal.
  • TextDiffAlgorithm.Histogram: good practical choice for large or repetitive texts when performance is important.
  • TextDiffAlgorithm.HuntSzymanski: useful for large inputs with relatively sparse matches.
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed.  net11.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • net10.0

    • No dependencies.

  • net11.0

    • No dependencies.

  • net8.0

    • No dependencies.

  • net9.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Meziantou.Framework.TextDiff:

Package Downloads
Meziantou.Framework.InlineSnapshotTesting

Enables verification of objects using inline snapshots

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.0.4 2,043 5/31/2026
2.0.3 590 5/23/2026
2.0.2 739 5/14/2026
2.0.1 1,486 5/11/2026
2.0.0 712 5/6/2026
1.0.1 3,963 4/25/2026
1.0.0 541 4/4/2026