[XmlDocUtils] Tests

Author: flyingpie

src/10-Core/Wtq.UnitTest/Utils/SystemExtensionsTest.cs

@@ -35,6 +35,6 @@ public void ToSnakeCase(string inp, string expected)
 	[TestMethod]
 	public void ToSnakeCaseNull()
 	{
-		Assert.ThrowsException<ArgumentNullException>(() => ((string)null).ToSnakeCase());
+		Assert.ThrowsExactly<ArgumentNullException>(() => ((string)null)!.ToSnakeCase());
 	}
 }

src/10-Core/Wtq.UnitTest/Utils/XmlDocUtilsTest.cs

@@ -1,11 +1,60 @@
-using Namotion.Reflection;
-using System.Linq;
+using System.Reflection;
 
 namespace Wtq.Core.UnitTest.Utils;
 
 [TestClass]
 public class XmlDocUtilsTest
 {
+	[TestMethod]
+	public void GetExample()
+	{
+		// Act
+		var summary = TestClass.PropertyInfo.GetExample();
+
+		// Assert
+		Assert.AreEqual(
+			"""
+			{
+				"Name": "Value"
+			}
+			""",
+			summary);
+	}
+
+	[TestMethod]
+	public void GetRemarks()
+	{
+		// Act
+		var summary = TestClass.PropertyInfo.GetRemarks();
+
+		// Assert
+		Assert.AreEqual(
+			"""
+			The Remarks.
+			Another line.
+			<p>With paragraph.</p>
+			With <strong>strong</strong> words.
+			""",
+			summary);
+	}
+
+	[TestMethod]
+	public void GetSummary()
+	{
+		// Act
+		var summary = TestClass.PropertyInfo.GetSummary();
+
+		// Assert
+		Assert.AreEqual(
+			"""
+			The Summary.
+			Another line.
+			<p>With paragraph.</p>
+			With <strong>strong</strong> words.
+			""",
+			summary);
+	}
+
 	private class TestClass
 	{
 		/// <summary>
@@ -28,27 +77,7 @@ private class TestClass
 		/// </code>
 		/// </example>
 		public string? Property { get; set; }
-	}
-
-	[TestMethod, Ignore]
-	public void METHOD()
-	{
-		var classType = typeof(TestClass);
-		var propType = classType.GetProperty(nameof(TestClass.Property));
-
-		var summary = propType.GetSummary();
-
-		Assert.AreEqual("""
-			The Summary.
-			Another line.
-			<p>With <strong>strong</strong></p> words.
-			""", summary);
-
-		// var doc = XmlDocUtils
-		// 	.GetMemberDocElement(propType)
-		// 	.Descendants("summary")
-		// 	.FirstOrDefault();
 
-		var dbg = 2;
+		public static PropertyInfo PropertyInfo => typeof(TestClass).GetProperty(nameof(Property))!;
 	}
 }

src/10-Core/Wtq/Utils/SystemExtensions.cs

@@ -11,6 +11,13 @@ public static TValue JsonDeepClone<TValue>(this TValue value)
 		return JsonSerializer.Deserialize<TValue>(json)!;
 	}
 
+	/// <summary>
+	/// "" => null<br/>
+	/// " " => null<br/>
+	/// "\t" => null<br/>
+	/// "\n" => null<br/>
+	/// "not-null" => "not-null".<br/>
+	/// </summary>
 	public static string? EmptyOrWhiteSpaceToNull(this string? input) => string.IsNullOrWhiteSpace(input) ? null : input;
 
 	public static IEnumerable<ValidationResult> Validate(this IValidatableObject validatable)

src/10-Core/Wtq/Utils/XmlDocUtils.cs

@@ -5,7 +5,7 @@ namespace Wtq.Utils;
 
 public static class XmlDocUtils
 {
-	private static XmlDocsOptions _xmlDocsOptions = new()
+	private static readonly XmlDocsOptions _xmlDocsOptions = new()
 	{
 		FormattingMode = XmlDocsFormattingMode.Html,
 	};
@@ -19,14 +19,11 @@ public static class XmlDocUtils
 	public static string? GetSummary(this MemberInfo memberInfo) =>
 		Guard.Against.Null(memberInfo).GetXmlDocsTag("summary", _xmlDocsOptions);
 
-	#region Enums
-
 	public static string? GetSummaryEnum(this object val, Type enumType)
 	{
-		var memb = enumType.GetMember(val.ToString()!).First();
+		var member = enumType.GetMember(val.ToString()!).FirstOrDefault()
+			?? throw new InvalidOperationException($"Could not get member info for enum type '{enumType.FullName}'.");
 
-		return GetSummary(memb);
+		return GetSummary(member);
 	}
-
-	#endregion
 }