Atualiza suporte a múltiplas versões e refatora código

Mudanças no suporte a versões e estrutura de projeto:
 * Atualização do `Directory.Build.props` para múltiplas versões.
  - Suporte a `net8.0` e `net9.0` adicionado.
  - Versão de teste alterada para `net9.0`.
  - Atualização do `SPPreview` para `-preview-4.0`.

Refatoração e adição de novas funcionalidades:
 * Implementação de novos métodos e classes.
  - Adição da propriedade estática `Parser` em `PointerParser`.
  - Refatoração dos métodos `PointerToProperty` e `PropertyToPointer`.
  - Criação da classe `DefaultPointerParser` para lógica de conversão.
  - Implementação da interface `IPointerParser`.

Aprimoramento de testes e validações:
 * Melhoria na cobertura de testes e validações.
  - Novo teste `FindResult_HasInvalidParameter` adicionado.
  - Atualização de tipos de parâmetros para nullable em `PointerParserTests`.
  - Modificação da classe `TestEntity` para usar string nullable.
  - Adição da classe `FooBarContainer` e `FooValidator` em `Models.cs`.

Atualizações em arquivos de configuração:
 * Ajustes em arquivos de configuração e dependências.
  - Atualização do `RoyalCode.SmartProblems.Tests.csproj` para múltiplos frameworks.
  - Alteração do `PackageReference` para `Microsoft.EntityFrameworkCore.Sqlite`.
  - Modificações nos arquivos `libs.targets` e `tests.targets` para caminhos de documentação.

Author: eglauko

src/Directory.Build.props

@@ -1,7 +1,7 @@
 <Project>
 	<PropertyGroup>
-		<FrmsVer>net8.0</FrmsVer>
-		<TestVer>net8.0</TestVer>
+		<FrmsVer>net8.0;net9.0</FrmsVer>
+		<TestVer>net9.0</TestVer>
 	</PropertyGroup>
 	<PropertyGroup>
 		<LangVersion>latest</LangVersion>
@@ -10,7 +10,7 @@
 	</PropertyGroup>
 	<PropertyGroup>
 		<SPVer>1.0.0</SPVer>
-		<SPPreview>-preview-3.5</SPPreview>
+		<SPPreview>-preview-4.0</SPPreview>
 	</PropertyGroup>
 	<PropertyGroup>
 		<FluentValidationVer>12.0.0</FluentValidationVer>

src/RoyalCode.SmartProblems.Conversions/DefaultPointerParser.cs

@@ -0,0 +1,131 @@
+using System.Text;
+
+namespace RoyalCode.SmartProblems.Conversions;
+
+internal sealed class DefaultPointerParser : IPointerParser
+{
+    /// <inheritdoc />
+    public string? PointerToProperty(string? pointer)
+    {
+        if (pointer == null)
+            return null;
+
+        int pointerLength = pointer.Length;
+        if (pointerLength == 0)
+            return pointer;
+
+        int startIndex = 0;
+        if (pointer[startIndex] == '#')
+        {
+            if (pointerLength == 1)
+                return string.Empty;
+
+            startIndex = 1;
+        }
+        if (pointer[startIndex] == '/')
+        {
+            startIndex++;
+        }
+
+        if (startIndex == pointerLength)
+            return string.Empty;
+
+        StringBuilder propertyBuffer = new(pointerLength);
+
+        int slash = 0;
+        int chars = 0;
+        bool isDigit = true;
+
+        for (int i = startIndex, j = 0; i < pointerLength; i++, j++)
+        {
+            char c = pointer[i];
+            if (c == '/')
+            {
+                if (chars is not 0)
+                {
+                    startIndex = slash is 0 ? startIndex : slash + 1;
+                    if (isDigit)
+                    {
+                        propertyBuffer.Append('[')
+                            .Append(pointer, startIndex, chars)
+                            .Append(']');
+                    }
+                    else
+                    {
+                        if (slash is not 0)
+                            propertyBuffer.Append('.');
+
+                        propertyBuffer.Append(pointer, startIndex, chars);
+                    }
+                }
+
+                slash = i;
+                isDigit = true;
+                chars = 0;
+            }
+            else
+            {
+                chars++;
+                isDigit = isDigit && char.IsDigit(c);
+            }
+        }
+
+        if (chars is not 0)
+        {
+            startIndex = slash is 0 ? startIndex : slash + 1;
+            if (isDigit)
+            {
+                propertyBuffer.Append('[')
+                    .Append(pointer, startIndex, chars)
+                    .Append(']');
+            }
+            else
+            {
+                if (slash is not 0)
+                    propertyBuffer.Append('.');
+
+                propertyBuffer.Append(pointer, startIndex, chars);
+            }
+        }
+
+        return propertyBuffer.ToString();
+    }
+
+    /// <inheritdoc />
+    public string? PropertyToPointer(string? property)
+    {
+        if (property == null)
+            return null;
+
+        int pointerLength = property.Length;
+        if (pointerLength == 0)
+            return "#/";
+
+        StringBuilder pointerBuffer = new(pointerLength);
+        pointerBuffer.Append("#/");
+
+        bool lastIsSlash = true;
+
+        for (int i = 0; i < pointerLength; i++)
+        {
+            char c = property[i];
+            if (c == '.' || c == '[' || c == ']')
+            {
+                if (!lastIsSlash)
+                    pointerBuffer.Append('/');
+
+                lastIsSlash = true;
+            }
+            else
+            {
+                pointerBuffer.Append(c);
+                lastIsSlash = false;
+            }
+        }
+
+        if (lastIsSlash)
+            pointerBuffer.Length--;
+
+        return pointerBuffer.ToString();
+    }
+}

src/RoyalCode.SmartProblems.Conversions/IPointerParser.cs

@@ -0,0 +1,44 @@
+
+using System.Diagnostics.CodeAnalysis;
+
+namespace RoyalCode.SmartProblems.Conversions;
+
+/// <summary>
+/// Interface to parse JSON pointers to C# properties and vice versa.
+/// </summary>
+public interface IPointerParser
+{
+    /// <summary>
+    /// <para>
+    ///     Convert a JSON pointer to a C# property.
+    /// </para>
+    /// <para>
+    ///     Some examples:
+    /// </para>
+    /// <list type="table">
+    ///     <item>
+    ///         <c>#/foo/0/bar</c> = <c>foo[0].bar</c>
+    ///     </item>
+    /// </list>
+    /// </summary>
+    /// <param name="pointer">The JSON pointer to convert.</param>
+    /// <returns>The C# property converted.</returns>
+    string? PointerToProperty([NotNullIfNotNull(nameof(pointer))] string? pointer);
+
+    /// <summary>
+    /// <para>
+    ///     Convert a C# property to a JSON pointer.
+    /// </para>
+    /// <para>
+    ///     Some examples:
+    /// </para>
+    /// <list type="table">
+    ///     <item>
+    ///         <c>foo[0].bar</c> = <c>#/foo/0/bar</c>
+    ///     </item>
+    /// </list>
+    /// </summary>
+    /// <param name="property">The C# property to convert.</param>
+    /// <returns>The JSON pointer converted.</returns>
+    string? PropertyToPointer(string? property);
+}

src/RoyalCode.SmartProblems.Conversions/PointerParser.cs

@@ -1,6 +1,5 @@
 
 using System.Diagnostics.CodeAnalysis;
-using System.Text;
 
 namespace RoyalCode.SmartProblems.Conversions;
 
@@ -9,6 +8,11 @@ namespace RoyalCode.SmartProblems.Conversions;
 /// </summary>
 public static class PointerParser
 {
+    /// <summary>
+    /// Gets or sets the parser used to convert JSON pointers to C# properties and vice versa.
+    /// </summary>
+    public static IPointerParser Parser { get; set; } = new DefaultPointerParser();
+
     /// <summary>
     /// <para>
     ///     Convert a JSON pointer to a C# property.
@@ -25,90 +29,7 @@ public static class PointerParser
     /// <param name="pointer">The JSON pointer to convert.</param>
     /// <returns>The C# property converted.</returns>
     public static string? PointerToProperty([NotNullIfNotNull(nameof(pointer))] this string? pointer)
-    {
-        if (pointer == null)
-            return null;
-
-        int pointerLength = pointer.Length;
-        if (pointerLength == 0)
-            return pointer;
-
-        int startIndex = 0;
-        if (pointer[startIndex] == '#')
-        {
-            if (pointerLength == 1)
-                return string.Empty;
-
-            startIndex = 1;
-        }
-        if (pointer[startIndex] == '/')
-        {
-            startIndex++;
-        }
-
-        if (startIndex == pointerLength)
-            return string.Empty;
-
-        StringBuilder propertyBuffer = new(pointerLength);
-
-        int slash = 0;
-        int chars = 0;
-        bool isDigit = true;
-
-        for (int i = startIndex, j = 0; i < pointerLength; i++, j++)
-        {
-            char c = pointer[i];
-            if (c == '/')
-            {
-                if (chars is not 0)
-                {
-                    startIndex = slash is 0 ? startIndex : slash + 1;
-                    if (isDigit)
-                    {
-                        propertyBuffer.Append('[')
-                            .Append(pointer, startIndex, chars)
-                            .Append(']');
-                    }
-                    else
-                    {
-                        if (slash is not 0)
-                            propertyBuffer.Append('.');
-
-                        propertyBuffer.Append(pointer, startIndex, chars);
-                    }
-                }
-
-                slash = i;
-                isDigit = true;
-                chars = 0;
-            }
-            else
-            {
-                chars++;
-                isDigit = isDigit && char.IsDigit(c);
-            }
-        }
-
-        if (chars is not 0)
-        {
-            startIndex = slash is 0 ? startIndex : slash + 1;
-            if (isDigit)
-            {
-                propertyBuffer.Append('[')
-                    .Append(pointer, startIndex, chars)
-                    .Append(']');
-            }
-            else
-            {
-                if (slash is not 0)
-                    propertyBuffer.Append('.');
-
-                propertyBuffer.Append(pointer, startIndex, chars);
-            }
-        }
-
-        return propertyBuffer.ToString();
-    }
+        => Parser.PointerToProperty(pointer);
 
     /// <summary>
     /// <para>
@@ -126,39 +47,5 @@ public static class PointerParser
     /// <param name="property">The C# property to convert.</param>
     /// <returns>The JSON pointer converted.</returns>
     public static string? PropertyToPointer(this string? property)
-    {
-        if (property == null)
-            return null;
-
-        int pointerLength = property.Length;
-        if (pointerLength == 0)
-            return "#/";
-
-        StringBuilder pointerBuffer = new(pointerLength);
-        pointerBuffer.Append("#/");
-
-        bool lastIsSlash = true;
-
-        for (int i = 0; i < pointerLength; i++)
-        {
-            char c = property[i];
-            if (c == '.' || c == '[' || c == ']')
-            {
-                if (!lastIsSlash)
-                    pointerBuffer.Append('/');
-
-                lastIsSlash = true;
-            }
-            else
-            {
-                pointerBuffer.Append(c);
-                lastIsSlash = false;
-            }
-        }
-
-        if (lastIsSlash)
-            pointerBuffer.Length--;
-
-        return pointerBuffer.ToString();
-    }
+        => Parser.PropertyToPointer(property);
 }

src/RoyalCode.SmartProblems.Tests/Basics/FindTests.cs

@@ -63,6 +63,24 @@ public void FindResult_Implicit_Problem()
         Assert.Equal("Error 1", problem.Detail);
     }
 
+    [Fact]
+    public void FindResult_HasInvalidParameter()
+    {
+        // Arrange
+        FindResult<Foo> result = new();
+
+        // Act
+        var notFound = result.HasInvalidParameter(out var problem, "property");
+
+        // Assert
+        Assert.False(result.Found);
+        Assert.True(notFound);
+        Assert.NotNull(problem);
+        Assert.Equal("The record for 'Foo' was not found", problem.Detail);
+        Assert.Equal(ProblemCategory.InvalidParameter, problem.Category);
+        Assert.Equal("property", problem.Property);
+    }
+
     [Fact]
     public void FindResult_Implicit_Result_Entity()
     {

src/RoyalCode.SmartProblems.Tests/Conversions/PointerParserTests.cs

@@ -33,7 +33,7 @@ public class PointerParserTests
     [InlineData("a/10", "a[10]")]
     [InlineData("a/10/b", "a[10].b")]
     [InlineData("a/10/b/", "a[10].b")]
-    public void PointerToProperty(string pointer, string expected)
+    public void PointerToProperty(string? pointer, string? expected)
     {
         var property = pointer.PointerToProperty();
 
@@ -52,7 +52,7 @@ public void PointerToProperty(string pointer, string expected)
     [InlineData("[0]", "#/0")]
     [InlineData("[0].a", "#/0/a")]
     [InlineData("[0].a.b", "#/0/a/b")]
-    public void PropertyToPointer(string property, string expected)
+    public void PropertyToPointer(string? property, string? expected)
     {
         var pointer = property.PropertyToPointer();