summaryrefslogtreecommitdiff
path: root/src/SMAPI.Toolkit.CoreInterfaces/ISemanticVersion.cs
blob: b228b2d1d24f1f30ee5bb8d16afac2478b87d19e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
using System;

namespace StardewModdingAPI
{
    /// <summary>A semantic version with an optional release tag.</summary>
    public interface ISemanticVersion : IComparable<ISemanticVersion>, IEquatable<ISemanticVersion>
    {
        /*********
        ** Accessors
        *********/
        /// <summary>The major version incremented for major API changes.</summary>
        int MajorVersion { get; }

        /// <summary>The minor version incremented for backwards-compatible changes.</summary>
        int MinorVersion { get; }

        /// <summary>The patch version for backwards-compatible bug fixes.</summary>
        int PatchVersion { get; }

        /// <summary>An optional prerelease tag.</summary>
        string PrereleaseTag { get; }

        /// <summary>Optional build metadata. This is ignored when determining version precedence.</summary>
        string BuildMetadata { get; }


        /*********
        ** Accessors
        *********/
        /// <summary>Whether this is a prerelease version.</summary>
        bool IsPrerelease();

        /// <summary>Get whether this version is older than the specified version.</summary>
        /// <param name="other">The version to compare with this instance.</param>
        bool IsOlderThan(ISemanticVersion other);

        /// <summary>Get whether this version is older than the specified version.</summary>
        /// <param name="other">The version to compare with this instance.</param>
        /// <exception cref="FormatException">The specified version is not a valid semantic version.</exception>
        bool IsOlderThan(string other);

        /// <summary>Get whether this version is newer than the specified version.</summary>
        /// <param name="other">The version to compare with this instance.</param>
        bool IsNewerThan(ISemanticVersion other);

        /// <summary>Get whether this version is newer than the specified version.</summary>
        /// <param name="other">The version to compare with this instance.</param>
        /// <exception cref="FormatException">The specified version is not a valid semantic version.</exception>
        bool IsNewerThan(string other);

        /// <summary>Get whether this version is between two specified versions (inclusively).</summary>
        /// <param name="min">The minimum version.</param>
        /// <param name="max">The maximum version.</param>
        bool IsBetween(ISemanticVersion min, ISemanticVersion max);

        /// <summary>Get whether this version is between two specified versions (inclusively).</summary>
        /// <param name="min">The minimum version.</param>
        /// <param name="max">The maximum version.</param>
        /// <exception cref="FormatException">One of the specified versions is not a valid semantic version.</exception>
        bool IsBetween(string min, string max);

        /// <summary>Get a string representation of the version.</summary>
        string ToString();

        /// <summary>Whether the version uses non-standard extensions, like four-part game versions on some platforms.</summary>
        bool IsNonStandard();
    }
}