Philiprehberger.TextDiff 0.2.1

Philiprehberger.TextDiff

Line-by-line text diff using Myers' algorithm with unified diff output and structured DiffResult objects.

Installation

dotnet add package Philiprehberger.TextDiff

Usage

using Philiprehberger.TextDiff;

var result = Diff.Compare("hello\nworld", "hello\nearth");
Console.WriteLine($"Changes: {result.HasChanges}, Added: {result.AddedCount}, Removed: {result.RemovedCount}");

Unified Diff Output

using Philiprehberger.TextDiff;

var oldText = "alpha\nbeta\ngamma\ndelta";
var newText = "alpha\nbeta\nepsilon\ndelta";

var unified = Diff.Unified(oldText, newText, "file-v1.txt", "file-v2.txt", context: 2);
Console.WriteLine(unified);
// --- file-v1.txt
// +++ file-v2.txt
// @@ -1,4 +1,4 @@
//  alpha
//  beta
// -gamma
// +epsilon
//  delta

Diff Statistics

using Philiprehberger.TextDiff;

var result = Diff.Compare("a\nb\nc", "a\nx\nc");

Console.WriteLine($"Additions: {result.Statistics.Additions}");
Console.WriteLine($"Deletions: {result.Statistics.Deletions}");
Console.WriteLine($"Modifications: {result.Statistics.Modifications}");
Console.WriteLine($"Change %: {result.Statistics.ChangePercentage}");

Diff Options

using Philiprehberger.TextDiff;

var options = new DiffOptions
{
    IgnoreWhitespace = true,
    IgnoreCase = true,
    IgnoreBlankLines = true
};

var result = Diff.Compare("  Hello  \n\nWorld", "hello\nworld", options);
Console.WriteLine($"Has changes: {result.HasChanges}"); // False

Character-Level Inline Diff

using Philiprehberger.TextDiff;

var changes = InlineDiff.ComputeCharacterDiff("hello world", "hello earth");

foreach (var change in changes)
{
    var marker = change.Type switch
    {
        ChangeType.Equal => " ",
        ChangeType.Delete => "-",
        ChangeType.Insert => "+"
    };
    Console.Write($"[{marker}{change.Text}]");
}
// [ hello ][- ][+e][-w][-o][-r][-l][-d][+a][+r][+t][+h]

Word-Level Diff

using Philiprehberger.TextDiff;

var changes = InlineDiff.ComputeWordDiff("the quick brown fox", "the slow brown cat");

foreach (var change in changes)
{
    if (change.Type == ChangeType.Delete)
        Console.Write($"[-{change.Text}]");
    else if (change.Type == ChangeType.Insert)
        Console.Write($"[+{change.Text}]");
    else
        Console.Write(change.Text);
}
// the [-quick][+slow] brown [-fox][+cat]

API

Diff

DiffResult

DiffLine

DiffStatistics

DiffOptions

InlineDiff

InlineChange

DiffMode

Development

dotnet build src/Philiprehberger.TextDiff.csproj --configuration Release

Support

If you find this project useful:

⭐ Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT