tiPS

0.0.21-ci20230828T170010SHA9067151

Classes/PowerShellTip.cs

using System;

namespace tiPS
{
    // Ideally the enum would be in a separate file, but then we have to deal with writing assemblies to disk
    // in order to load PowerShell types from 2 different files, so just define everything in a single file
    // here for now: https://stackoverflow.com/a/20749076/602585
    public enum TipCategory
    {
        Community, // Social events and community resources. e.g. PowerShell Summit, podcasts, etc.
        Editor, // Editor tips and extensions. e.g. VSCode, ISE, etc.
        Module, // Modules and module tips. e.g. PSScriptAnalyzer, Pester, etc.
        Syntax, // Syntax tips. e.g. splatting, pipeline, etc.
        Terminal, // Terminal shortcuts and tips. e.g. PSReadLine, ConEmu, etc.
        Other // Tips that don't fit into any of the above categories.
    }

    public class PowerShellTip
    {
        public string Id { get; set; }
        public DateTime CreatedDate { get; set; }
        public string Title { get; set; }
        public string TipText { get; set; }
        public string Example { get; set; }
        public string[] Urls { get; set; }
        public string MinPowerShellVersion { get; set; } // Use a string because System.Version is not deserialized correctly from JSON, and it's a bit more user friendly when specifying the version.
        public TipCategory Category { get; set; }

        public PowerShellTip()
        {
            Id = string.Empty;
            CreatedDate = DateTime.MinValue;
            Title = string.Empty;
            TipText = string.Empty;
            Example = string.Empty;
            Urls = Array.Empty<string>();
            MinPowerShellVersion = string.Empty;
            Category = TipCategory.Other;
        }

        public bool UrlsAreProvided => Urls != null && Urls.Length > 0;

        public bool MinPowerShellVersionIsProvided =>
            !string.IsNullOrWhiteSpace(MinPowerShellVersion) && MinPowerShellVersion != "0.0";

        public void Validate()
        {
            if (string.IsNullOrWhiteSpace(Id))
            {
                throw new System.ArgumentException($"The {nameof(Id)} property must be set.");
            }

            if (CreatedDate == DateTime.MinValue)
            {
                throw new System.ArgumentException($"The {nameof(CreatedDate)} property must be set.");
            }

            if (Id.Contains(' '))
            {
                throw new System.ArgumentException($"The {nameof(Id)} property value '{Id}' cannot contain spaces. Use PascalCase.");
            }

            if (string.IsNullOrWhiteSpace(Title))
            {
                throw new System.ArgumentException($"The {nameof(Title)} property must be set.");
            }

            if (string.IsNullOrWhiteSpace(TipText))
            {
                throw new System.ArgumentException($"The {nameof(TipText)} property must be set.");
            }

            if (UrlsAreProvided && Urls.Length > 3)
            {
                throw new System.ArgumentException($"You may only provide up to 3 {nameof(Urls)}.");
            }

            foreach (var url in Urls)
            {
                if (string.IsNullOrWhiteSpace(url))
                {
                    throw new System.ArgumentException($"The {nameof(Urls)} property must not contain null or empty values.");
                }

                bool urlStartsWithHttp = url.StartsWith("http://") || url.StartsWith("https://");
                if (!urlStartsWithHttp)
                {
                    throw new System.ArgumentException($"The {nameof(Urls)} property value '{url}' must start with 'http://' or 'https://'.");
                }

                Uri uri;
                bool isValidUrl = Uri.TryCreate(url, UriKind.Absolute, out uri);
                if (!isValidUrl)
                {
                    throw new System.ArgumentException($"The {nameof(Urls)} property value '{url}' is not a valid URL.");
                }
            }

            if (MinPowerShellVersionIsProvided)
            {
                Version version;
                bool isValidVersionNumber = Version.TryParse(MinPowerShellVersion, out version);
                if (!isValidVersionNumber)
                {
                    throw new System.ArgumentException($"The {nameof(MinPowerShellVersion)} property value '{MinPowerShellVersion}' is not a valid version number.");
                }

                if (version == new Version(0, 0) && MinPowerShellVersion != "0.0")
                {
                    throw new System.ArgumentException($"To specify that there is no minimum PowerShell version, use a {nameof(MinPowerShellVersion)} property value of '0.0' instead of '{MinPowerShellVersion}'.");
                }

                if (version.Build > 0 || version.Revision > 0)
                {
                    throw new System.ArgumentException($"The {nameof(MinPowerShellVersion)} property value should be of the format 'Major.Minor'. The value '{MinPowerShellVersion}' is not valid.");
                }
            }
        }
    }
}