Added MAC address validator

Author: jamesmcroft

src/MADE.Data.Validation/MADE.Data.Validation.csproj

@@ -11,9 +11,11 @@
       - Base64Validator for ensuring a string is a valid base64 string.
       - BetweenValidator for ensuring a value is within a minimum and maximum range.
       - EmailValidator for ensuring a value is an email address.
+      - GuidValidator for ensuring a value is a GUID.
       - IpAddressValidator for ensuring a value is a valid IP address.
       - LatitudeValidator for ensuring a value is a valid latitude.
       - LongitudeValidator for ensuring a value is a valid longitude.
+      - MacAddressValidator for ensuring a value is a valid MAC address.
       - MaxLengthValidator for ensuring a value is below a maximum length.
       - MaxValueValidator for ensuring a value is below a maximum value.
       - MinLengthValidator for ensuring a value is above a minimum length.

src/MADE.Data.Validation/Strings/Resources.Designer.cs

@@ -138,6 +138,9 @@
   <data name="IpAddressValidator_FeedbackMessage" xml:space="preserve">
     <value>The value must be a valid IP address, e.g. 192.168.0.1.</value>
   </data>
+  <data name="MacAddressValidator_FeedbackMessage" xml:space="preserve">
+    <value>The value must be a valid MAC address, e.g. 00:11:22:33:44:55.</value>
+  </data>
   <data name="MaxLengthValidator_FeedbackMessage" xml:space="preserve">
     <value>The length must be less than {0}.</value>
   </data>

src/MADE.Data.Validation/Strings/Resources.resx

@@ -41,7 +41,7 @@ public override string FeedbackMessage
         /// <exception cref="RegexMatchTimeoutException">Thrown if a Regex time-out occurred.</exception>
         public override void Validate(object value)
         {
-            var stringValue = value.ToString();
+            var stringValue = value?.ToString() ?? string.Empty;
             if (stringValue.Length % 4 != 0)
             {
                 this.IsInvalid = true;

src/MADE.Data.Validation/Validators/Base64Validator.cs

@@ -54,7 +54,7 @@ public void Validate(object value)
             }
             else
             {
-                var stringValue = value.ToString();
+                var stringValue = value?.ToString() ?? string.Empty;
                 isInvalid = !Guid.TryParse(stringValue, out _);
             }
 

src/MADE.Data.Validation/Validators/GuidValidator.cs

@@ -56,7 +56,7 @@ public virtual string FeedbackMessage
         /// <param name="value">The value to be validated.</param>
         public void Validate(object value)
         {
-            bool parsed = double.TryParse(value.ToString(), out double latitude);
+            bool parsed = double.TryParse(value?.ToString() ?? string.Empty, out double latitude);
             this.IsInvalid = !parsed || latitude is < Min or > Max;
             this.IsDirty = true;
         }

src/MADE.Data.Validation/Validators/LatitudeValidator.cs

@@ -56,7 +56,7 @@ public virtual string FeedbackMessage
         /// <param name="value">The value to be validated.</param>
         public void Validate(object value)
         {
-            bool parsed = double.TryParse(value.ToString(), out double longitude);
+            bool parsed = double.TryParse(value?.ToString() ?? string.Empty, out double longitude);
             this.IsInvalid = !parsed || longitude is < Min or > Max;
             this.IsDirty = true;
         }

src/MADE.Data.Validation/Validators/LongitudeValidator.cs

@@ -0,0 +1,68 @@
+// MADE Apps licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+namespace MADE.Data.Validation.Validators
+{
+    using System;
+    using System.Net.NetworkInformation;
+    using MADE.Data.Validation.Extensions;
+    using MADE.Data.Validation.Strings;
+
+    /// <summary>
+    /// Defines a data validator for ensuring a value is a valid MAC address.
+    /// </summary>
+    public class MacAddressValidator : IValidator
+    {
+        private string feedbackMessage;
+
+        /// <summary>
+        /// Gets or sets the key associated with the validator.
+        /// </summary>
+        public string Key { get; set; } = nameof(MacAddressValidator);
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the data provided is in an invalid state.
+        /// </summary>
+        public bool IsInvalid { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether the data is dirty.
+        /// </summary>
+        public bool IsDirty { get; set; }
+
+        /// <summary>
+        /// Gets or sets the feedback message to display when <see cref="IValidator.IsInvalid"/> is true.
+        /// </summary>
+        public string FeedbackMessage
+        {
+            get => this.feedbackMessage.IsNullOrWhiteSpace()
+                ? Resources.MacAddressValidator_FeedbackMessage
+                : this.feedbackMessage;
+            set => this.feedbackMessage = value;
+        }
+
+        /// <summary>
+        /// Executes data validation on the provided <paramref name="value"/>.
+        /// </summary>
+        /// <param name="value">The value to be validated.</param>
+        /// <exception cref="OverflowException">The array is multidimensional and contains more than <see cref="int.MaxValue"></see> elements.</exception>
+        public void Validate(object value)
+        {
+            bool isInvalid;
+            var stringValue = value?.ToString() ?? string.Empty;
+
+            try
+            {
+                PhysicalAddress newAddress = PhysicalAddress.Parse(stringValue);
+                isInvalid = PhysicalAddress.None.Equals(newAddress);
+            }
+            catch (FormatException)
+            {
+                isInvalid = true;
+            }
+
+            this.IsInvalid = isInvalid;
+            this.IsDirty = true;
+        }
+    }
+}

src/MADE.Data.Validation/Validators/MacAddressValidator.cs

@@ -54,8 +54,8 @@ public void Validate(object value)
             }
             else
             {
-                var valStr = value.ToString();
-                isInvalid = !Uri.IsWellFormedUriString(valStr, UriKind.Absolute);
+                var stringValue = value?.ToString() ?? string.Empty;
+                isInvalid = !Uri.IsWellFormedUriString(stringValue, UriKind.Absolute);
             }
 
             this.IsInvalid = isInvalid;

src/MADE.Data.Validation/Validators/WellFormedUrlValidator.cs

@@ -0,0 +1,61 @@
+namespace MADE.Data.Validation.Tests.Tests
+{
+    using System.Diagnostics.CodeAnalysis;
+    using MADE.Data.Validation.Validators;
+    using NUnit.Framework;
+    using Shouldly;
+
+    [ExcludeFromCodeCoverage]
+    [TestFixture]
+    public class MacAddressValidatorTests
+    {
+        public class WhenValidating
+        {
+            [Test]
+            public void ShouldBeDirtyOnceValidated()
+            {
+                // Arrange
+                string value = "Test";
+                var validator = new MacAddressValidator();
+
+                // Act
+                validator.Validate(value);
+
+                // Assert
+                validator.IsDirty.ShouldBe(true);
+            }
+
+            [TestCase("001122334455")]
+            [TestCase("00-11-22-33-44-55")]
+            [TestCase("0011.2233.4455")]
+            [TestCase("00:11:22:33:44:55")]
+            [TestCase("F0-E1-D2-C3-B4-A5")]
+            [TestCase("f0-e1-d2-c3-b4-a5")]
+            public void ShouldBeValidIfValidMacAddress(string value)
+            {
+                // Arrange
+                var validator = new MacAddressValidator();
+
+                // Act
+                validator.Validate(value);
+
+                // Assert
+                validator.IsInvalid.ShouldBe(false);
+            }
+
+            [TestCase("Test")]
+            [TestCase("00/11/22/33/44/55")]
+            public void ShouldBeInvalidIfInvalidMacAddress(string value)
+            {
+                // Arrange
+                var validator = new MacAddressValidator();
+
+                // Act
+                validator.Validate(value);
+
+                // Assert
+                validator.IsInvalid.ShouldBe(true);
+            }
+        }
+    }
+}