add MsExcelDiff support

Author: SimonCropp

readme.md

@@ -29,7 +29,12 @@ DiffEngine manages launching and cleanup of diff tools. It is designed to be use
 
 [Entity Framework Extensions](https://entityframework-extensions.net/?utm_source=simoncropp&utm_medium=DiffEngine) is a major sponsor and is proud to contribute to the development this project.
 
-[![Entity Framework Extensions](https://raw.githubusercontent.com/VerifyTests/DiffEngine/refs/heads/main/docs/zzz.png)](https://entityframework-extensions.net/?utm_source=simoncropp&utm_medium=DiffEngine)<!-- endInclude -->
+[![Entity Framework Extensions](https://raw.githubusercontent.com/VerifyTests/DiffEngine/refs/heads/main/docs/zzz.png)](https://entityframework-extensions.net/?utm_source=simoncropp&utm_medium=DiffEngine)
+
+### Developed using JetBrains IDEs
+
+[![JetBrains logo.](https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.svg)](https://jb.gg/OpenSourceSupport)<!-- endInclude -->
+
 
 
 <!-- toc -->

src/DiffEngine.Tests/defaultOrder.include.md

@@ -22,3 +22,4 @@
  * **[Cursor](/docs/diff-tool.md#cursor)** Windows/OSX/Linux (Cost: Free and Paid)
  * **[VisualStudio](/docs/diff-tool.md#visualstudio)** Windows (Cost: Paid and free options)
  * **[MsWordDiff](/docs/diff-tool.md#msworddiff)** Windows (Cost: Free)
+ * **[MsExcelDiff](/docs/diff-tool.md#msexceldiff)** Windows (Cost: Free)

src/DiffEngine.Tests/diffToolList.include.md

@@ -22,3 +22,4 @@
  * **[Cursor](/docs/diff-tool.md#cursor)** Windows/OSX/Linux (Cost: Free and Paid)
  * **[VisualStudio](/docs/diff-tool.md#visualstudio)** Windows (Cost: Paid and free options)
  * **[MsWordDiff](/docs/diff-tool.md#msworddiff)** Windows (Cost: Free)
+ * **[MsExcelDiff](/docs/diff-tool.md#msexceldiff)** Windows (Cost: Free)

src/DiffEngine.Tests/diffTools.include.md

@@ -348,7 +348,46 @@ DiffTools.UseOrder(DiffTool.KDiff3);
     * `/Applications/kdiff3.app/Contents/MacOS/kdiff3`
     * `%PATH%kdiff3`
 
-### [MsWordDiff](https://github.com/SimonCropp/MsWordDiff)
+### [MsExcelDiff](https://github.com/SimonCropp/MsOfficeDiff)
+
+  * Cost: Free
+  * Is MDI: False
+  * Supports auto-refresh: False
+  * Supports text files: False
+  * Use shell execute: False
+  * Create no window: True
+  * Environment variable for custom install location: `DiffEngine_MsExcelDiff`
+  * Supported binaries: .xls, .xlsx
+
+#### Tool order:
+
+Use [tool order](diff-tool.order.md) to prioritise MsExcelDiff over other tools.
+
+```
+DiffTools.UseOrder(DiffTool.MsExcelDiff);
+```
+
+#### Notes:
+
+ * Install via `dotnet tool install -g MsExcelDiff`
+ * Requires Spreadsheet Compare (Office Professional Plus / Microsoft 365 Apps for Enterprise)
+ * Uses Microsoft's Spreadsheet Compare to show differences between workbooks
+
+#### Windows settings:
+
+  * Example target on left arguments:
+   ```
+   "targetFile.txt" "tempFile.txt"
+   ```
+  * Example target on right arguments:
+   ```
+   "tempFile.txt" "targetFile.txt"
+   ```
+  * Scanned paths:
+    * `%USERPROFILE%\.dotnet\tools\diffexcel.exe`
+    * `%PATH%diffexcel.exe`
+
+### [MsWordDiff](https://github.com/SimonCropp/MsOfficeDiff)
 
   * Cost: Free
   * Is MDI: False

src/DiffEngine/Definitions.cs

@@ -30,6 +30,7 @@ static Definitions() =>
             Implementation.VisualStudioCode(),
             Implementation.Cursor(),
             Implementation.VisualStudio(),
-            Implementation.MsWordDiff()
+            Implementation.MsWordDiff(),
+            Implementation.MsExcelDiff()
         ];
 }

src/DiffEngine/DiffTool.cs

@@ -25,5 +25,6 @@ public enum DiffTool
     VisualStudioCode,
     VisualStudio,
     Cursor,
-    MsWordDiff
+    MsWordDiff,
+    MsExcelDiff
 }

src/DiffEngine/Implementation/MsExcelDiff.cs

@@ -0,0 +1,36 @@
+static partial class Implementation
+{
+    public static Definition MsExcelDiff()
+    {
+        var launchArguments = new LaunchArguments(
+            Left: (temp, target) => $"\"{target}\" \"{temp}\"",
+            Right: (temp, target) => $"\"{temp}\" \"{target}\"");
+
+        return new(
+            Tool: DiffTool.MsExcelDiff,
+            Url: "https://github.com/SimonCropp/MsOfficeDiff",
+            AutoRefresh: false,
+            IsMdi: false,
+            SupportsText: false,
+            RequiresTarget: true,
+            BinaryExtensions:
+            [
+                ".xlsx",
+                ".xls"
+            ],
+            Cost: "Free",
+            OsSupport: new(
+                Windows: new(
+                    "diffexcel.exe",
+                    launchArguments,
+                    @"%USERPROFILE%\.dotnet\tools\")),
+            UseShellExecute: false,
+            CreateNoWindow: true,
+            KillLockingProcess: true,
+            Notes: """
+                 * Install via `dotnet tool install -g MsExcelDiff`
+                 * Requires Spreadsheet Compare (Office Professional Plus / Microsoft 365 Apps for Enterprise)
+                 * Uses Microsoft's Spreadsheet Compare to show differences between workbooks
+                """);
+    }
+}

src/DiffEngine/Implementation/MsWordDiff.cs

@@ -8,7 +8,7 @@ public static Definition MsWordDiff()
 
         return new(
             Tool: DiffTool.MsWordDiff,
-            Url: "https://github.com/SimonCropp/MsWordDiff",
+            Url: "https://github.com/SimonCropp/MsOfficeDiff",
             AutoRefresh: false,
             IsMdi: false,
             SupportsText: false,

src/Directory.Build.props

@@ -2,7 +2,7 @@
 <Project>
   <PropertyGroup>
     <NoWarn>CS1591;CS0649;NU1608;NU1109</NoWarn>
-    <Version>19.0.0</Version>
+    <Version>19.1.0</Version>
     <AssemblyVersion>1.0.0</AssemblyVersion>
     <PackageTags>Testing, Snapshot, Diff, Compare</PackageTags>
     <Description>Launches diff tools based on file extensions. Designed to be consumed by snapshot testing libraries.</Description>

src/nuget.md

@@ -19,4 +19,8 @@ DiffEngine manages launching and cleanup of diff tools. It is designed to be use
 
 [Entity Framework Extensions](https://entityframework-extensions.net/?utm_source=simoncropp&utm_medium=DiffEngine) is a major sponsor and is proud to contribute to the development this project.
 
-[![Entity Framework Extensions](https://raw.githubusercontent.com/VerifyTests/DiffEngine/refs/heads/main/docs/zzz.png)](https://entityframework-extensions.net/?utm_source=simoncropp&utm_medium=DiffEngine)<!-- endInclude -->
+[![Entity Framework Extensions](https://raw.githubusercontent.com/VerifyTests/DiffEngine/refs/heads/main/docs/zzz.png)](https://entityframework-extensions.net/?utm_source=simoncropp&utm_medium=DiffEngine)
+
+### Developed using JetBrains IDEs
+
+[![JetBrains logo.](https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.svg)](https://jb.gg/OpenSourceSupport)<!-- endInclude -->