IPAddressYamlConverter.cs

// =============================================================================
// GPAL - Generally Positive Automation Library
// Copyright © 2026 Software Decisions, Inc. All rights reserved.
//
// This file is part of GPAL.
// Licensed under the Business Source License 1.1
//
// Primary development, architecture, and vision by Michael B. Vederman,
// CEO of Software Decisions, Inc., Texas.
//
// Internal development maintained privately.
// Public releases appear on GitHub: https://github.com/SoftwareDecisionsInc/GPAL.
//
// See LICENSE for full terms, including Additional Use Grant.
// =============================================================================
 
using System;
using System.Net;
using YamlDotNet.Core;
using YamlDotNet.Core.Events;
using YamlDotNet.Serialization;
 
public class IPAddressYamlConverter : IYamlTypeConverter
{
    public bool Accepts(Type type)
    {
        return type == typeof(IPAddress);
    }
 
    public object ReadYaml(IParser parser, Type type)
    {
        var value = parser.Consume<Scalar>().Value;
        if (IPAddress.TryParse(value, out var ipAddress))
        {
            return ipAddress;
        }
        return null; // Handle parsing failure accordingly
    }
 
    public void WriteYaml(IEmitter emitter, object value, Type type)
    {
        if (value is IPAddress ipAddress)
        {
            emitter.Emit(new Scalar(ipAddress.ToString()));
        }
        else
        {
            emitter.Emit(new Scalar(null)); // Handle writing failure accordingly
        }
    }
    public object ReadYaml(IParser parser, Type type, ObjectDeserializer rootDeserializer)
    {
        // Use the deserializer to extract the scalar value
        var scalarValue = rootDeserializer(type) as string;
        if (scalarValue == null)
        {
            throw new YamlException("Expected a string for IP address.");
        }
 
        IPAddress ipAddress;
        if (IPAddress.TryParse(scalarValue, out ipAddress))
        {
            return ipAddress;
        }
 
        throw new YamlException($"Invalid IP address format: {scalarValue}");
    }
 
    public void WriteYaml(IEmitter emitter, object value, Type type, ObjectSerializer serializer)
    {
        if (value is IPAddress ipAddress)
        {
            // Emit the mapping for IP address in YAML format
            emitter.Emit(new MappingStart()); // Start a new mapping
 
            emitter.Emit(new Scalar("ipAddress")); // Emit the field name
            serializer(ipAddress.ToString()); // Use the serializer to handle the value
 
            emitter.Emit(new MappingEnd()); // End the mapping
        }
        else if (value == null)
        {
            // a null is data, not a failure. throwing here killed the whole conversion on a null entry in a
            // collection of IPAddress, and the sibling overload above already writes null for this case
            emitter.Emit(new Scalar("null"));
        }
        else
        {
            throw new ArgumentException("Expected an IPAddress object.", nameof(value));
        }
    }
}