From 3d510e4600eea1aa7c7c652e1babec4c5319d732 Mon Sep 17 00:00:00 2001
From: Corniel Nobel <corniel@gmail.com>
Date: Mon, 29 Jan 2024 10:35:03 +0100
Subject: [PATCH] Implement IParsable for Id<TIdBehavior> (#372)

---
 specs/Qowaiv.Specs/Identifiers/Id_specs.cs | 15 +++++++++
 src/Qowaiv/Identifiers/Id.cs               | 37 ++++++++++++++++++++++
 src/Qowaiv/Qowaiv.csproj                   |  2 ++
 3 files changed, 54 insertions(+)
 create mode 100644 specs/Qowaiv.Specs/Identifiers/Id_specs.cs

diff --git a/specs/Qowaiv.Specs/Identifiers/Id_specs.cs b/specs/Qowaiv.Specs/Identifiers/Id_specs.cs
new file mode 100644
index 00000000..76074e47
--- /dev/null
+++ b/specs/Qowaiv.Specs/Identifiers/Id_specs.cs
@@ -0,0 +1,15 @@
+#if NET8_0_OR_GREATER
+
+namespace Identifiers.Id_specs;
+
+public class Can_parse
+{
+    [Test]
+    public void providing_a_format_provider()
+    {
+        CustomGuid.Parse("8A1A8C42-D2FF-E254-E26E-B6ABCBF19420", TestCultures.pt).Should().Be(Svo.CustomGuid);
+        CustomGuid.TryParse("8A1A8C42-D2FF-E254-E26E-B6ABCBF19420", TestCultures.pt, out _).Should().BeTrue();
+    }
+}
+
+#endif
diff --git a/src/Qowaiv/Identifiers/Id.cs b/src/Qowaiv/Identifiers/Id.cs
index 4c8c0611..84182eb8 100644
--- a/src/Qowaiv/Identifiers/Id.cs
+++ b/src/Qowaiv/Identifiers/Id.cs
@@ -21,6 +21,7 @@ namespace Qowaiv.Identifiers;
 public readonly struct Id<TIdentifier> : IXmlSerializable, IFormattable, IEquatable<Id<TIdentifier>>, IComparable, IComparable<Id<TIdentifier>>
 #if NET7_0_OR_GREATER
 , IEqualityOperators<Id<TIdentifier>, Id<TIdentifier>, bool>
+, IParsable<Id<TIdentifier>>
 #endif
 #if NET8_0_OR_GREATER
 #else
@@ -240,6 +241,24 @@ void IXmlSerializable.WriteXml(XmlWriter writer)
     /// <summary>Casts the <see cref="Uuid"/> to an identifier.</summary>
     public static explicit operator Id<TIdentifier>(Uuid id) => Create(id);
 
+    /// <summary>Converts the <see cref="string"/> to <see cref="Id{TIdentifier}"/>.</summary>
+    /// <param name="s">
+    /// A string containing the identifier to convert.
+    /// </param>
+    /// <param name="provider">
+    /// The format provider.
+    /// </param>
+    /// <returns>
+    /// <returns>
+    /// The parsed identifier.
+    /// </returns>
+    /// <exception cref="FormatException">
+    /// <paramref name="s"/> is not in the correct format.
+    /// </exception>
+    [Pure]
+    public static Id<TIdentifier> Parse(string s, IFormatProvider? provider)
+        => Parse(s);
+
     /// <summary>Converts the <see cref="string"/> to <see cref="Id{TIdentifier}"/>.</summary>
     /// <param name="s">
     /// A string containing the identifier to convert.
@@ -269,6 +288,24 @@ public static Id<TIdentifier> TryParse(string? s)
         return TryParse(s, out Id<TIdentifier> val) ? val : default;
     }
 
+    /// <summary>Converts the <see cref="string"/> to <see cref = "Id{TIdentifier}"/>.
+    /// A return value indicates whether the conversion succeeded.
+    /// </summary>
+    /// <param name="s">
+    /// A string containing the identifier to convert.
+    /// </param>
+    /// <param name="provider">
+    /// The format provider.
+    /// </param>
+    /// <param name="result">
+    /// The result of the parsing.
+    /// </param>
+    /// <returns>
+    /// True if the string was converted successfully, otherwise false.
+    /// </returns>
+    public static bool TryParse(string? s, IFormatProvider? provider, out Id<TIdentifier> result)
+        => TryParse(s, out result);
+
     /// <summary>Converts the <see cref="string"/> to <see cref = "Id{TIdentifier}"/>.
     /// A return value indicates whether the conversion succeeded.
     /// </summary>
diff --git a/src/Qowaiv/Qowaiv.csproj b/src/Qowaiv/Qowaiv.csproj
index 07146ee7..07c10365 100644
--- a/src/Qowaiv/Qowaiv.csproj
+++ b/src/Qowaiv/Qowaiv.csproj
@@ -8,6 +8,8 @@
     <Version>6.6.0</Version>
     <PackageId>Qowaiv</PackageId>
     <PackageReleaseNotes>
+v6.6.1
+- Add missing IParsable interface for Id. #372
 v6.6.0
 - Add former countries. #357
 - Update display names countries (EN, DE, NL). #356