feat: complete IFileVersionInfo expectations

README.md

@@ -202,29 +202,43 @@ fileSystem.File.WriteAllText("Acme.dll", "");
 IFileVersionInfo info = fileSystem.FileVersionInfo.GetVersionInfo("Acme.dll");
 
 await That(info).HasCompanyName("Acme").And.HasProductName("Anvil");
-await That(info).HasFileVersion("1.2.3.4");
+await That(info).HasFileVersion("1.2.3.4").And.HasFileMajorPart(1);
 await That(info).IsDebug().And.IsNotPreRelease();
 ```
 
-Dedicated assertions exist for the common fields (`HasCompanyName`,
-`HasProductName`, `HasFileDescription`, `HasFileVersion`, `HasProductVersion`,
-`HasOriginalFilename`, `HasLanguage`), plus the boolean pairs
-`IsDebug` / `IsNotDebug`, `IsPreRelease` / `IsNotPreRelease` and
-`IsPatched` / `IsNotPatched`.
-
-| Property              | Assertion                                  |
-|-----------------------|--------------------------------------------|
-| `CompanyName`         | `HasCompanyName(string)`                   |
-| `ProductName`         | `HasProductName(string)`                   |
-| `FileDescription`     | `HasFileDescription(string)`               |
-| `FileVersion`         | `HasFileVersion(string)`                   |
-| `ProductVersion`      | `HasProductVersion(string)`                |
-| `OriginalFilename`    | `HasOriginalFilename(string)`              |
-| `Language`            | `HasLanguage(string)`                      |
-| `IsDebug`             | `IsDebug()` / `IsNotDebug()`               |
-| `IsPreRelease`        | `IsPreRelease()` / `IsNotPreRelease()`     |
-| `IsPatched`           | `IsPatched()` / `IsNotPatched()`           |
-| _other_ (e.g. `Comments`, `LegalCopyright`, `FileMajorPart`) | `await That(info.X).Is…` |
+Dedicated assertions cover every `IFileVersionInfo` property — strings via
+`Has…(string)`, the integer version parts via `Has…(int)` and the booleans
+as `Is…()` / `IsNot…()` pairs.
+
+| Property             | Assertion                                  |
+|----------------------|--------------------------------------------|
+| `Comments`           | `HasComments(string)`                      |
+| `CompanyName`        | `HasCompanyName(string)`                   |
+| `FileDescription`    | `HasFileDescription(string)`               |
+| `FileName`           | `HasFileName(string)`                      |
+| `FileVersion`        | `HasFileVersion(string)`                   |
+| `InternalName`       | `HasInternalName(string)`                  |
+| `Language`           | `HasLanguage(string)`                      |
+| `LegalCopyright`     | `HasLegalCopyright(string)`                |
+| `LegalTrademarks`    | `HasLegalTrademarks(string)`               |
+| `OriginalFilename`   | `HasOriginalFilename(string)`              |
+| `PrivateBuild`       | `HasPrivateBuild(string)`                  |
+| `ProductName`        | `HasProductName(string)`                   |
+| `ProductVersion`     | `HasProductVersion(string)`                |
+| `SpecialBuild`       | `HasSpecialBuild(string)`                  |
+| `FileBuildPart`      | `HasFileBuildPart(int)`                    |
+| `FileMajorPart`      | `HasFileMajorPart(int)`                    |
+| `FileMinorPart`      | `HasFileMinorPart(int)`                    |
+| `FilePrivatePart`    | `HasFilePrivatePart(int)`                  |
+| `ProductBuildPart`   | `HasProductBuildPart(int)`                 |
+| `ProductMajorPart`   | `HasProductMajorPart(int)`                 |
+| `ProductMinorPart`   | `HasProductMinorPart(int)`                 |
+| `ProductPrivatePart` | `HasProductPrivatePart(int)`               |
+| `IsDebug`            | `IsDebug()` / `IsNotDebug()`               |
+| `IsPatched`          | `IsPatched()` / `IsNotPatched()`           |
+| `IsPreRelease`       | `IsPreRelease()` / `IsNotPreRelease()`     |
+| `IsPrivateBuild`     | `IsPrivateBuild()` / `IsNotPrivateBuild()` |
+| `IsSpecialBuild`     | `IsSpecialBuild()` / `IsNotSpecialBuild()` |
 
 ## File-system notifications
 

Source/aweXpect.Testably/FileVersionInfoExtensions.HasComments.cs

@@ -0,0 +1,26 @@
+using System.IO.Abstractions;
+using aweXpect.Core;
+using aweXpect.Options;
+using aweXpect.Results;
+using aweXpect.Testably.Helpers;
+
+namespace aweXpect.Testably;
+
+public static partial class FileVersionInfoExtensions
+{
+	/// <summary>
+	///     Verifies that the <see cref="IFileVersionInfo" /> has the <paramref name="expected" /> comments.
+	/// </summary>
+	public static StringEqualityTypeResult<IFileVersionInfo, IThat<IFileVersionInfo>> HasComments(
+		this IThat<IFileVersionInfo> source,
+		string? expected)
+	{
+		StringEqualityOptions options = new();
+		return new StringEqualityTypeResult<IFileVersionInfo, IThat<IFileVersionInfo>>(
+			source.Get().ExpectationBuilder.AddConstraint((it, grammars)
+				=> new FileVersionInfoConstraints.HasStringPropertyConstraint(
+					it, grammars, v => v.Comments, options, expected, "comments")),
+			source,
+			options);
+	}
+}

Source/aweXpect.Testably/FileVersionInfoExtensions.HasFileBuildPart.cs

@@ -0,0 +1,21 @@
+using System.IO.Abstractions;
+using aweXpect.Core;
+using aweXpect.Results;
+using aweXpect.Testably.Helpers;
+
+namespace aweXpect.Testably;
+
+public static partial class FileVersionInfoExtensions
+{
+	/// <summary>
+	///     Verifies that the <see cref="IFileVersionInfo" /> has the <paramref name="expected" /> file build part.
+	/// </summary>
+	public static AndOrResult<IFileVersionInfo, IThat<IFileVersionInfo>> HasFileBuildPart(
+		this IThat<IFileVersionInfo> source,
+		int expected)
+		=> new(
+			source.Get().ExpectationBuilder.AddConstraint((it, grammars)
+				=> new FileVersionInfoConstraints.HasInt32PropertyConstraint(
+					it, grammars, v => v.FileBuildPart, expected, "file build part")),
+			source);
+}

Source/aweXpect.Testably/FileVersionInfoExtensions.HasFileMajorPart.cs

@@ -0,0 +1,21 @@
+using System.IO.Abstractions;
+using aweXpect.Core;
+using aweXpect.Results;
+using aweXpect.Testably.Helpers;
+
+namespace aweXpect.Testably;
+
+public static partial class FileVersionInfoExtensions
+{
+	/// <summary>
+	///     Verifies that the <see cref="IFileVersionInfo" /> has the <paramref name="expected" /> file major part.
+	/// </summary>
+	public static AndOrResult<IFileVersionInfo, IThat<IFileVersionInfo>> HasFileMajorPart(
+		this IThat<IFileVersionInfo> source,
+		int expected)
+		=> new(
+			source.Get().ExpectationBuilder.AddConstraint((it, grammars)
+				=> new FileVersionInfoConstraints.HasInt32PropertyConstraint(
+					it, grammars, v => v.FileMajorPart, expected, "file major part")),
+			source);
+}

Source/aweXpect.Testably/FileVersionInfoExtensions.HasFileMinorPart.cs

@@ -0,0 +1,21 @@
+using System.IO.Abstractions;
+using aweXpect.Core;
+using aweXpect.Results;
+using aweXpect.Testably.Helpers;
+
+namespace aweXpect.Testably;
+
+public static partial class FileVersionInfoExtensions
+{
+	/// <summary>
+	///     Verifies that the <see cref="IFileVersionInfo" /> has the <paramref name="expected" /> file minor part.
+	/// </summary>
+	public static AndOrResult<IFileVersionInfo, IThat<IFileVersionInfo>> HasFileMinorPart(
+		this IThat<IFileVersionInfo> source,
+		int expected)
+		=> new(
+			source.Get().ExpectationBuilder.AddConstraint((it, grammars)
+				=> new FileVersionInfoConstraints.HasInt32PropertyConstraint(
+					it, grammars, v => v.FileMinorPart, expected, "file minor part")),
+			source);
+}

Source/aweXpect.Testably/FileVersionInfoExtensions.HasFileName.cs

@@ -0,0 +1,26 @@
+using System.IO.Abstractions;
+using aweXpect.Core;
+using aweXpect.Options;
+using aweXpect.Results;
+using aweXpect.Testably.Helpers;
+
+namespace aweXpect.Testably;
+
+public static partial class FileVersionInfoExtensions
+{
+	/// <summary>
+	///     Verifies that the <see cref="IFileVersionInfo" /> has the <paramref name="expected" /> file name.
+	/// </summary>
+	public static StringEqualityTypeResult<IFileVersionInfo, IThat<IFileVersionInfo>> HasFileName(
+		this IThat<IFileVersionInfo> source,
+		string? expected)
+	{
+		StringEqualityOptions options = new();
+		return new StringEqualityTypeResult<IFileVersionInfo, IThat<IFileVersionInfo>>(
+			source.Get().ExpectationBuilder.AddConstraint((it, grammars)
+				=> new FileVersionInfoConstraints.HasStringPropertyConstraint(
+					it, grammars, v => v.FileName, options, expected, "file name")),
+			source,
+			options);
+	}
+}

Source/aweXpect.Testably/FileVersionInfoExtensions.HasFilePrivatePart.cs

@@ -0,0 +1,21 @@
+using System.IO.Abstractions;
+using aweXpect.Core;
+using aweXpect.Results;
+using aweXpect.Testably.Helpers;
+
+namespace aweXpect.Testably;
+
+public static partial class FileVersionInfoExtensions
+{
+	/// <summary>
+	///     Verifies that the <see cref="IFileVersionInfo" /> has the <paramref name="expected" /> file private part.
+	/// </summary>
+	public static AndOrResult<IFileVersionInfo, IThat<IFileVersionInfo>> HasFilePrivatePart(
+		this IThat<IFileVersionInfo> source,
+		int expected)
+		=> new(
+			source.Get().ExpectationBuilder.AddConstraint((it, grammars)
+				=> new FileVersionInfoConstraints.HasInt32PropertyConstraint(
+					it, grammars, v => v.FilePrivatePart, expected, "file private part")),
+			source);
+}

Source/aweXpect.Testably/FileVersionInfoExtensions.HasInternalName.cs

@@ -0,0 +1,26 @@
+using System.IO.Abstractions;
+using aweXpect.Core;
+using aweXpect.Options;
+using aweXpect.Results;
+using aweXpect.Testably.Helpers;
+
+namespace aweXpect.Testably;
+
+public static partial class FileVersionInfoExtensions
+{
+	/// <summary>
+	///     Verifies that the <see cref="IFileVersionInfo" /> has the <paramref name="expected" /> internal name.
+	/// </summary>
+	public static StringEqualityTypeResult<IFileVersionInfo, IThat<IFileVersionInfo>> HasInternalName(
+		this IThat<IFileVersionInfo> source,
+		string? expected)
+	{
+		StringEqualityOptions options = new();
+		return new StringEqualityTypeResult<IFileVersionInfo, IThat<IFileVersionInfo>>(
+			source.Get().ExpectationBuilder.AddConstraint((it, grammars)
+				=> new FileVersionInfoConstraints.HasStringPropertyConstraint(
+					it, grammars, v => v.InternalName, options, expected, "internal name")),
+			source,
+			options);
+	}
+}

Source/aweXpect.Testably/FileVersionInfoExtensions.HasLegalCopyright.cs

@@ -0,0 +1,26 @@
+using System.IO.Abstractions;
+using aweXpect.Core;
+using aweXpect.Options;
+using aweXpect.Results;
+using aweXpect.Testably.Helpers;
+
+namespace aweXpect.Testably;
+
+public static partial class FileVersionInfoExtensions
+{
+	/// <summary>
+	///     Verifies that the <see cref="IFileVersionInfo" /> has the <paramref name="expected" /> legal copyright.
+	/// </summary>
+	public static StringEqualityTypeResult<IFileVersionInfo, IThat<IFileVersionInfo>> HasLegalCopyright(
+		this IThat<IFileVersionInfo> source,
+		string? expected)
+	{
+		StringEqualityOptions options = new();
+		return new StringEqualityTypeResult<IFileVersionInfo, IThat<IFileVersionInfo>>(
+			source.Get().ExpectationBuilder.AddConstraint((it, grammars)
+				=> new FileVersionInfoConstraints.HasStringPropertyConstraint(
+					it, grammars, v => v.LegalCopyright, options, expected, "legal copyright")),
+			source,
+			options);
+	}
+}

Source/aweXpect.Testably/FileVersionInfoExtensions.HasLegalTrademarks.cs

@@ -0,0 +1,26 @@
+using System.IO.Abstractions;
+using aweXpect.Core;
+using aweXpect.Options;
+using aweXpect.Results;
+using aweXpect.Testably.Helpers;
+
+namespace aweXpect.Testably;
+
+public static partial class FileVersionInfoExtensions
+{
+	/// <summary>
+	///     Verifies that the <see cref="IFileVersionInfo" /> has the <paramref name="expected" /> legal trademarks.
+	/// </summary>
+	public static StringEqualityTypeResult<IFileVersionInfo, IThat<IFileVersionInfo>> HasLegalTrademarks(
+		this IThat<IFileVersionInfo> source,
+		string? expected)
+	{
+		StringEqualityOptions options = new();
+		return new StringEqualityTypeResult<IFileVersionInfo, IThat<IFileVersionInfo>>(
+			source.Get().ExpectationBuilder.AddConstraint((it, grammars)
+				=> new FileVersionInfoConstraints.HasStringPropertyConstraint(
+					it, grammars, v => v.LegalTrademarks, options, expected, "legal trademarks")),
+			source,
+			options);
+	}
+}

Source/aweXpect.Testably/FileVersionInfoExtensions.HasPrivateBuild.cs

@@ -0,0 +1,26 @@
+using System.IO.Abstractions;
+using aweXpect.Core;
+using aweXpect.Options;
+using aweXpect.Results;
+using aweXpect.Testably.Helpers;
+
+namespace aweXpect.Testably;
+
+public static partial class FileVersionInfoExtensions
+{
+	/// <summary>
+	///     Verifies that the <see cref="IFileVersionInfo" /> has the <paramref name="expected" /> private build.
+	/// </summary>
+	public static StringEqualityTypeResult<IFileVersionInfo, IThat<IFileVersionInfo>> HasPrivateBuild(
+		this IThat<IFileVersionInfo> source,
+		string? expected)
+	{
+		StringEqualityOptions options = new();
+		return new StringEqualityTypeResult<IFileVersionInfo, IThat<IFileVersionInfo>>(
+			source.Get().ExpectationBuilder.AddConstraint((it, grammars)
+				=> new FileVersionInfoConstraints.HasStringPropertyConstraint(
+					it, grammars, v => v.PrivateBuild, options, expected, "private build")),
+			source,
+			options);
+	}
+}

Source/aweXpect.Testably/FileVersionInfoExtensions.HasProductBuildPart.cs

@@ -0,0 +1,21 @@
+using System.IO.Abstractions;
+using aweXpect.Core;
+using aweXpect.Results;
+using aweXpect.Testably.Helpers;
+
+namespace aweXpect.Testably;
+
+public static partial class FileVersionInfoExtensions
+{
+	/// <summary>
+	///     Verifies that the <see cref="IFileVersionInfo" /> has the <paramref name="expected" /> product build part.
+	/// </summary>
+	public static AndOrResult<IFileVersionInfo, IThat<IFileVersionInfo>> HasProductBuildPart(
+		this IThat<IFileVersionInfo> source,
+		int expected)
+		=> new(
+			source.Get().ExpectationBuilder.AddConstraint((it, grammars)
+				=> new FileVersionInfoConstraints.HasInt32PropertyConstraint(
+					it, grammars, v => v.ProductBuildPart, expected, "product build part")),
+			source);
+}

Source/aweXpect.Testably/FileVersionInfoExtensions.HasProductMajorPart.cs

@@ -0,0 +1,21 @@
+using System.IO.Abstractions;
+using aweXpect.Core;
+using aweXpect.Results;
+using aweXpect.Testably.Helpers;
+
+namespace aweXpect.Testably;
+
+public static partial class FileVersionInfoExtensions
+{
+	/// <summary>
+	///     Verifies that the <see cref="IFileVersionInfo" /> has the <paramref name="expected" /> product major part.
+	/// </summary>
+	public static AndOrResult<IFileVersionInfo, IThat<IFileVersionInfo>> HasProductMajorPart(
+		this IThat<IFileVersionInfo> source,
+		int expected)
+		=> new(
+			source.Get().ExpectationBuilder.AddConstraint((it, grammars)
+				=> new FileVersionInfoConstraints.HasInt32PropertyConstraint(
+					it, grammars, v => v.ProductMajorPart, expected, "product major part")),
+			source);
+}

Source/aweXpect.Testably/FileVersionInfoExtensions.HasProductMinorPart.cs

@@ -0,0 +1,21 @@
+using System.IO.Abstractions;
+using aweXpect.Core;
+using aweXpect.Results;
+using aweXpect.Testably.Helpers;
+
+namespace aweXpect.Testably;
+
+public static partial class FileVersionInfoExtensions
+{
+	/// <summary>
+	///     Verifies that the <see cref="IFileVersionInfo" /> has the <paramref name="expected" /> product minor part.
+	/// </summary>
+	public static AndOrResult<IFileVersionInfo, IThat<IFileVersionInfo>> HasProductMinorPart(
+		this IThat<IFileVersionInfo> source,
+		int expected)
+		=> new(
+			source.Get().ExpectationBuilder.AddConstraint((it, grammars)
+				=> new FileVersionInfoConstraints.HasInt32PropertyConstraint(
+					it, grammars, v => v.ProductMinorPart, expected, "product minor part")),
+			source);
+}