Umbraco-CMS/src/Umbraco.Core/Configuration/UmbracoVersion.cs

using System;
using System.Reflection;
using Semver;

namespace Umbraco.Core.Configuration
{
    /// <summary>
    /// Represents the version of the executing code.
    /// </summary>
    public class UmbracoVersion : IUmbracoVersion
    {
        public UmbracoVersion()
        {
            var umbracoCoreAssembly = typeof(SemVersion).Assembly;

            // gets the value indicated by the AssemblyVersion attribute
            AssemblyVersion = umbracoCoreAssembly.GetName().Version;

            // gets the value indicated by the AssemblyFileVersion attribute
            AssemblyFileVersion = System.Version.Parse(umbracoCoreAssembly.GetCustomAttribute<AssemblyFileVersionAttribute>().Version);

            // gets the value indicated by the AssemblyInformationalVersion attribute
            // this is the true semantic version of the Umbraco Cms
            SemanticVersion = SemVersion.Parse(umbracoCoreAssembly.GetCustomAttribute<AssemblyInformationalVersionAttribute>().InformationalVersion);

            // gets the non-semantic version
            Current = SemanticVersion.GetVersion(3);
        }

        /// <summary>
        /// Gets the non-semantic version of the Umbraco code.
        /// </summary>
        // TODO: rename to Version
        public Version Current { get; }

        /// <summary>
        /// Gets the semantic version comments of the Umbraco code.
        /// </summary>
        public string Comment => SemanticVersion.Prerelease;

        /// <summary>
        /// Gets the assembly version of the Umbraco code.
        /// </summary>
        /// <remarks>
        /// <para>The assembly version is the value of the <see cref="AssemblyVersionAttribute"/>.</para>
        /// <para>Is the one that the CLR checks for compatibility. Therefore, it changes only on
        /// hard-breaking changes (for instance, on new major versions).</para>
        /// </remarks>
        public Version AssemblyVersion { get; }

        /// <summary>
        /// Gets the assembly file version of the Umbraco code.
        /// </summary>
        /// <remarks>
        /// <para>The assembly version is the value of the <see cref="AssemblyFileVersionAttribute"/>.</para>
        /// </remarks>
        public Version AssemblyFileVersion { get; }

        /// <summary>
        /// Gets the semantic version of the Umbraco code.
        /// </summary>
        /// <remarks>
        /// <para>The semantic version is the value of the <see cref="AssemblyInformationalVersionAttribute"/>.</para>
        /// <para>It is the full version of Umbraco, including comments.</para>
        /// </remarks>
        public SemVersion SemanticVersion { get; }
    }
}