// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.

// This file is shared between the SDK MSBuild build tasks and the Microsoft.DotNet.FileBasedPrograms source
// package (which is also consumed by Roslyn and the dotnet CLI) to avoid a duplicate copy. See
// https://github.com/dotnet/sdk/issues/51487. The build-tasks projects that link this file define
// MSBUILD_BUILD_TASKS to select the Microsoft.DotNet.Cli namespace; every other consumer (the source
// package, its external consumers, and ProjectTools) gets the Microsoft.DotNet.FileBasedPrograms form,
// which matches the file as it originally shipped. The build tasks enable nullable and provide System via
// ImplicitUsings, so emitting the directive and using there would be flagged as redundant (IDE0240/IDE0005).
#if !MSBUILD_BUILD_TASKS
#nullable enable
using System;
#endif

#if MSBUILD_BUILD_TASKS
namespace Microsoft.DotNet.Cli
#else
namespace Microsoft.DotNet.FileBasedPrograms
#endif
{
    /// <summary>
    /// Internal utilities copied from microsoft/MSBuild repo.
    /// </summary>
    class MSBuildUtilities
    {
        /// <summary>
        /// Converts a string to a bool.  We consider "true/false", "on/off", and 
        /// "yes/no" to be valid boolean representations in the XML.
        /// Modified from its original version to not throw, but return a default value.
        /// </summary>
        /// <param name="parameterValue">The string to convert.</param>
        /// <returns>Boolean true or false, corresponding to the string.</returns>
        internal static bool ConvertStringToBool(string? parameterValue, bool defaultValue = false)
        {
            if (string.IsNullOrEmpty(parameterValue))
            {
                return defaultValue;
            }
            else if (ValidBooleanTrue(parameterValue))
            {
                return true;
            }
            else if (ValidBooleanFalse(parameterValue))
            {
                return false;
            }
            else
            {
                // Unsupported boolean representation.
                return defaultValue;
            }
        }

        /// <summary>
        /// Returns true if the string represents a valid MSBuild boolean true value,
        /// such as "on", "!false", "yes"
        /// </summary>
        private static bool ValidBooleanTrue(string? parameterValue)
        {
            return ((string.Compare(parameterValue, "true", StringComparison.OrdinalIgnoreCase) == 0) ||
                    (string.Compare(parameterValue, "on", StringComparison.OrdinalIgnoreCase) == 0) ||
                    (string.Compare(parameterValue, "yes", StringComparison.OrdinalIgnoreCase) == 0) ||
                    (string.Compare(parameterValue, "!false", StringComparison.OrdinalIgnoreCase) == 0) ||
                    (string.Compare(parameterValue, "!off", StringComparison.OrdinalIgnoreCase) == 0) ||
                    (string.Compare(parameterValue, "!no", StringComparison.OrdinalIgnoreCase) == 0));
        }

        /// <summary>
        /// Returns true if the string represents a valid MSBuild boolean false value,
        /// such as "!on" "off" "no" "!true"
        /// </summary>
        private static bool ValidBooleanFalse(string? parameterValue)
        {
            return ((string.Compare(parameterValue, "false", StringComparison.OrdinalIgnoreCase) == 0) ||
                    (string.Compare(parameterValue, "off", StringComparison.OrdinalIgnoreCase) == 0) ||
                    (string.Compare(parameterValue, "no", StringComparison.OrdinalIgnoreCase) == 0) ||
                    (string.Compare(parameterValue, "!true", StringComparison.OrdinalIgnoreCase) == 0) ||
                    (string.Compare(parameterValue, "!on", StringComparison.OrdinalIgnoreCase) == 0) ||
                    (string.Compare(parameterValue, "!yes", StringComparison.OrdinalIgnoreCase) == 0));
        }
    }
}