add validation rule and tests

Author: VisualBean

src/LEGO.AsyncAPI/Validation/Rules/AsyncApiDocumentRules.cs

@@ -2,6 +2,7 @@
 
 namespace LEGO.AsyncAPI.Validation.Rules
 {
+    using System;
     using System.Linq;
     using System.Text.RegularExpressions;
     using LEGO.AsyncAPI.Models;
@@ -10,10 +11,12 @@ namespace LEGO.AsyncAPI.Validation.Rules
     [AsyncApiRule]
     public static class AsyncApiDocumentRules
     {
+        private static TimeSpan RegexTimeout = TimeSpan.FromSeconds(1);
         /// <summary>
         /// The key regex.
         /// </summary>
-        public static Regex KeyRegex = new Regex(@"^[a-zA-Z0-9\.\-_]+$");
+        public static Regex KeyRegex = new Regex(@"^[a-zA-Z0-9\.\-_]+$", RegexOptions.None, RegexTimeout);
+        public static Regex ChannelKeyUriTemplateRegex = new Regex(@"^(?:(?:[^\x00-\x20""'<>%\\^`{|}]|%[0-9a-f]{2})|\{[+#./;?&=,!@|]?(?:[a-z0-9_]|%[0-9a-f]{2})+(?::[1-9][0-9]{0,3}|\*)?(?:,(?:[a-z0-9_]|%[0-9a-f]{2})+(?::[1-9][0-9]{0,3}|\*)?)*\})*$", RegexOptions.IgnoreCase, RegexTimeout);
 
         public static ValidationRule<AsyncApiDocument> DocumentRequiredFields =>
             new ValidationRule<AsyncApiDocument>(
@@ -30,14 +33,30 @@ public static class AsyncApiDocumentRules
                     context.Exit();
 
                     context.Enter("channels");
-                    if (document.Channels == null || !document.Channels.Keys.Any())
+                    try
                     {
-                        context.CreateError(
-                            nameof(DocumentRequiredFields),
-                            string.Format(Resource.Validation_FieldRequired, "channels", "document"));
-                    }
+                        if (document.Channels == null || !document.Channels.Keys.Any())
+                        {
+                            context.CreateError(
+                                nameof(DocumentRequiredFields),
+                                string.Format(Resource.Validation_FieldRequired, "channels", "document"));
+                            return;
+                        }
 
-                    context.Exit();
+                        foreach (var key in document.Channels.Keys)
+                        {
+                            if (!ChannelKeyUriTemplateRegex.IsMatch(key))
+                            {
+                                context.CreateError(
+                                    "ChannelKeys",
+                                    string.Format(Resource.Validation_KeyMustMatchRegularExpr, key, "channels", KeyRegex.ToString()));
+                            }
+                        }
+                    }
+                    finally
+                    {
+                        context.Exit();
+                    }                    
                 });
 
         public static ValidationRule<AsyncApiDocument> KeyMustBeRegularExpression =>

test/LEGO.AsyncAPI.Tests/Validation/ValidationRuleTests.cs

@@ -0,0 +1,89 @@
+// Copyright (c) The LEGO Group. All rights reserved.
+
+namespace LEGO.AsyncAPI.Tests.Validation
+{
+    using FluentAssertions;
+    using LEGO.AsyncAPI.Readers;
+    using LEGO.AsyncAPI.Validations;
+    using NUnit.Framework;
+    using System.Linq;
+
+    public class ValidationRuleTests
+    {
+        [Test]
+        [TestCase("chat-{person-id}")]
+        public void ChannelKey_WithInvalidParameter_DiagnosticsError(string channelKey)
+        {
+            var input =
+                $"""
+                asyncapi: 2.6.0
+                info:
+                  title: Chat Application
+                  version: 1.0.0
+                servers:
+                  testing:
+                    url: test.mosquitto.org:1883
+                    protocol: mqtt
+                    description: Test broker
+                channels:
+                  {channelKey}:
+                    publish:
+                      operationId: onMessageReceieved
+                      message:
+                        name: text
+                        payload:
+                          type: string
+                    subscribe:
+                      operationId: sendMessage
+                      message:
+                        name: text
+                        payload:
+                          type: string
+                """;
+
+            var document = new AsyncApiStringReader().Read(input, out var diagnostic);
+            diagnostic.Errors.First().Message.Should().Be($"The key '{channelKey}' in 'channels' MUST match the regular expression '^[a-zA-Z0-9\\.\\-_]+$'.");
+            diagnostic.Errors.First().Pointer.Should().Be("#/channels");
+        }
+
+        [Test]
+        [TestCase("chat")]
+        [TestCase("chat-{personId}")]
+        [TestCase("chat-{person_id}")]
+        [TestCase("chat-{person%2Did}")]
+        [TestCase("chat-{personId2}")]
+        public void ChannelKey_WithValidKey_Success(string channelKey)
+        {
+            var input =
+                $"""
+                asyncapi: 2.6.0
+                info:
+                  title: Chat Application
+                  version: 1.0.0
+                servers:
+                  testing:
+                    url: test.mosquitto.org:1883
+                    protocol: mqtt
+                    description: Test broker
+                channels:
+                  {channelKey}:
+                    publish:
+                      operationId: onMessageReceieved
+                      message:
+                        name: text
+                        payload:
+                          type: string
+                    subscribe:
+                      operationId: sendMessage
+                      message:
+                        name: text
+                        payload:
+                          type: string
+                """;
+
+            var document = new AsyncApiStringReader().Read(input, out var diagnostic);
+            diagnostic.Errors.Should().BeEmpty();
+        }
+    }
+
+}

test/LEGO.AsyncAPI.Tests/Validation/ValidationRulesetTests.cs

@@ -2,8 +2,11 @@
 
 namespace LEGO.AsyncAPI.Tests.Validation
 {
+    using FluentAssertions;
+    using LEGO.AsyncAPI.Readers;
     using LEGO.AsyncAPI.Validations;
     using NUnit.Framework;
+    using System.Linq;
 
     public class ValidationRuleSetTests
     {