Refactor IPAM model classes to use records for Address, Subnetwork, Vlan, Vrf, Section, Tag, Domain, Nameserver, and Session; enhance documentation and implement value equality for records.

classlib/Cmdlets/GetTagCmdlet.cs

@@ -1,20 +1,24 @@
 namespace PS.IPAM.Cmdlets;
+
 using System;
 using System.Collections.Generic;
 using System.Management.Automation;
-using PS.IPAM;
 using PS.IPAM.Helpers;
 
+/// <summary>
+/// Retrieves tag information from phpIPAM.
+/// </summary>
 [Cmdlet(VerbsCommon.Get, "Tag", DefaultParameterSetName = "NoParams")]
 [OutputType(typeof(Tag))]
-public class GetTagCmdlet : PSCmdlet
+public class GetTagCmdlet : BaseCmdlet
 {
     [Parameter(
         Mandatory = false,
         ValueFromPipeline = true,
         ValueFromPipelineByPropertyName = true,
         Position = 0,
-        ParameterSetName = "ByID")]
+        ParameterSetName = "ByID",
+        HelpMessage = "The tag ID.")]
     [ValidateNotNullOrEmpty]
     public int? Id { get; set; }
 
@@ -23,7 +27,8 @@ public class GetTagCmdlet : PSCmdlet
         ValueFromPipeline = true,
         ValueFromPipelineByPropertyName = true,
         Position = 0,
-        ParameterSetName = "ByAddressObject")]
+        ParameterSetName = "ByAddressObject",
+        HelpMessage = "Get the tag associated with this address.")]
     [ValidateNotNullOrEmpty]
     public Address? AddressObject { get; set; }
 
@@ -32,7 +37,8 @@ public class GetTagCmdlet : PSCmdlet
         ValueFromPipeline = true,
         ValueFromPipelineByPropertyName = true,
         Position = 0,
-        ParameterSetName = "BySubnetObject")]
+        ParameterSetName = "BySubnetObject",
+        HelpMessage = "Get the tag associated with this subnet.")]
     [ValidateNotNullOrEmpty]
     public Subnetwork? SubnetObject { get; set; }
 
@@ -50,6 +56,7 @@ public class GetTagCmdlet : PSCmdlet
                         identifiers.Add(Id.Value.ToString());
                     }
                     break;
+
                 case "ByAddressObject":
                     if (AddressObject?.TagId > 0)
                     {
@@ -60,6 +67,7 @@ public class GetTagCmdlet : PSCmdlet
                         return;
                     }
                     break;
+
                 case "BySubnetObject":
                     if (SubnetObject?.TagId > 0)
                     {
@@ -72,23 +80,11 @@ public class GetTagCmdlet : PSCmdlet
                     break;
             }
 
-            var result = RequestHelper.InvokeRequest("GET", controllers.addresses, types.Tag, null, null, identifiers.ToArray())
-                .GetAwaiter().GetResult();
+            var result = RequestHelper.InvokeRequest(
+                "GET", ApiController.Addresses, ModelType.Tag, null, null, identifiers.ToArray()
+            ).GetAwaiter().GetResult();
 
-            if (result != null)
-            {
-                if (result is System.Collections.IEnumerable enumerable && !(result is string))
-                {
-                    foreach (var item in enumerable)
-                    {
-                        WriteObject(item);
-                    }
-                }
-                else
-                {
-                    WriteObject(result);
-                }
-            }
+            WriteResult(result);
         }
         catch (Exception ex)
         {