/* ========================================================================
* Copyright (c) 2005-2025 The OPC Foundation, Inc. All rights reserved.
*
* OPC Foundation MIT License 1.00
*
* Permission is hereby granted, free of charge, to any person
* obtaining a copy of this software and associated documentation
* files (the "Software"), to deal in the Software without
* restriction, including without limitation the rights to use,
* copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following
* conditions:
*
* The above copyright notice and this permission notice shall be
* included in all copies or substantial portions of the Software.
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
* OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
* HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
* WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
* OTHER DEALINGS IN THE SOFTWARE.
*
* The complete license agreement can be found here:
* http://opcfoundation.org/License/MIT/1.00/
* ======================================================================*/
using NUnit.Framework;
namespace Opc.Ua.SourceGeneration
{
///
/// Tests for the lenient model version comparison.
///
[TestFixture]
[Category("SourceGeneration")]
[SetCulture("en-us")]
[SetUICulture("en-us")]
[Parallelizable]
public class SemVerTests
{
///
/// Regression: '+' build metadata was treated as a pre-release tag, so
/// "1.05.03+20240101" ranked below "1.05.03". SemVer 2.0 ignores build
/// metadata for precedence.
///
[TestCase("1.05.03+20240101", "1.05.03", 0)]
[TestCase("1.05.03+hotfix", "1.05.02", 1)]
[TestCase("1.0.0-rc1+build", "1.0.0", -1)]
[TestCase("1.0.0+build-5", "1.0.0", 0)]
public void BuildMetadataDoesNotAffectPrecedence(string left, string right, int expected)
{
Assert.That(
System.Math.Sign(SemVer.CompareVersionStrings(left, right)),
Is.EqualTo(expected));
}
[Test]
public void BuildMetadataIsNotAPrerelease()
{
Assert.That(SemVer.TryParse("1.05.03+20240101", out SemVer version), Is.True);
Assert.That(version.IsPrerelease, Is.False);
Assert.That(version, Is.EqualTo(SemVer.Parse("1.5.3")));
}
///
/// Regression: the fourth component was dropped, so "1.0.0.1" and
/// "1.0.0.2" compared equal.
///
[TestCase("1.0.0.1", "1.0.0.2", -1)]
[TestCase("1.0.0.2", "1.0.0.1", 1)]
[TestCase("1.0.0.0", "1.0.0", 0)]
[TestCase("1.0.1.0", "1.0.0.9", 1)]
public void FourthComponentIsCompared(string left, string right, int expected)
{
Assert.That(
System.Math.Sign(SemVer.CompareVersionStrings(left, right)),
Is.EqualTo(expected));
}
///
/// The total order ranks the kind of version first, so it is transitive
/// across a mix of versions and dates.
///
[TestCase("1.0.3", "1.0.2", 1)]
[TestCase("1.0.2", "2023-01-01", 1)]
[TestCase("2024-01-01", "2023-01-01", 1)]
[TestCase("2023-01-01", "", 1)]
[TestCase("", null, 0)]
[TestCase("abc", "2023-01-01", 1)]
[TestCase("1.0.0", "abc", 1)]
public void TotalOrderRanksTheKindOfVersionFirst(string left, string? right, int expected)
{
Assert.That(
System.Math.Sign(SemVer.CompareVersionStringsTotal(left, right!)),
Is.EqualTo(expected));
Assert.That(
System.Math.Sign(SemVer.CompareVersionStringsTotal(right!, left)),
Is.EqualTo(-expected));
}
///
/// Regression (N4): every pre-release compared equal, so 1.0.0-alpha
/// and 1.0.0-beta fell through to the publication date. SemVer 2.0
/// section 11.4 orders pre-release identifiers; this is the example
/// chain from the SemVer specification plus leading-zero and hyphen
/// cases the lenient parser accepts.
///
[Test]
public void PrereleaseIdentifiersFollowSemVerPrecedence()
{
string[] ascending =
[
"1.0.0-alpha",
"1.0.0-alpha.1",
"1.0.0-alpha.beta",
"1.0.0-beta",
"1.0.0-beta.2",
"1.0.0-beta.11",
"1.0.0-rc.1",
"1.0.0"
];
for (int i = 0; i < ascending.Length; i++)
{
for (int j = 0; j < ascending.Length; j++)
{
Assert.That(
System.Math.Sign(SemVer.CompareVersionStrings(ascending[i], ascending[j])),
Is.EqualTo(i.CompareTo(j)),
$"{ascending[i]} vs {ascending[j]}");
}
}
}
[TestCase("1.0.0-1", "1.0.0-01", 0)]
[TestCase("1.0.0-9", "1.0.0-10", -1)]
[TestCase("1.0.0-99999999999999999999", "1.0.0-100000000000000000000", -1)]
[TestCase("1.0.0-x-y", "1.0.0-x", 1)]
[TestCase("1.0.0-Z", "1.0.0-a", -1)]
[TestCase("1.0.0-9", "1.0.0-a", -1)]
[TestCase("1.0.0-rc.1+build.5", "1.0.0-rc.1", 0)]
public void PrereleaseIdentifierEdgeCases(string left, string right, int expected)
{
Assert.That(
System.Math.Sign(SemVer.CompareVersionStrings(left, right)),
Is.EqualTo(expected));
Assert.That(
System.Math.Sign(SemVer.CompareVersionStrings(right, left)),
Is.EqualTo(-expected));
Assert.That(
SemVer.Parse(left).Equals(SemVer.Parse(right)),
Is.EqualTo(expected == 0));
}
///
/// Regression (N4): OPC 10000-6 F.2 Table F.1. Models are ordered by
/// ModelVersion when both have one; when only one has one it is newer
/// regardless of the date; without ModelVersion the PublicationDate
/// decides; the Version attribute ("not intended for programmatic
/// comparisons") only breaks the remaining tie.
///
[TestCase("1.5.4", "2024-01-01", "1.05.04", "1.5.5", "2025-01-01", "Draft", -1)]
[TestCase("1.5.5", "2020-01-01", null, "1.5.4", "2025-01-01", null, 1)]
[TestCase("1.5.4", "2020-01-01", null, "1.5.4", "2025-01-01", null, -1)]
[TestCase("1.5.4", "2020-01-01", null, null, "2025-01-01", "9.0.0", 1)]
[TestCase(null, "2020-01-01", "9.0.0", null, "2025-01-01", "1.0.0", -1)]
[TestCase(null, "2025-01-01", "1.0.1", null, "2025-01-01", "1.0.0", 1)]
[TestCase("1.0.0-alpha", "2025-01-01", null, "1.0.0-beta", "2020-01-01", null, -1)]
public void CompareModelsFollowsNodeSetModelTableRules(
string? leftModelVersion,
string leftDate,
string? leftVersion,
string? rightModelVersion,
string rightDate,
string? rightVersion,
int expected)
{
System.DateTime l = System.DateTime.Parse(leftDate, System.Globalization.CultureInfo.InvariantCulture);
System.DateTime r = System.DateTime.Parse(rightDate, System.Globalization.CultureInfo.InvariantCulture);
Assert.That(
System.Math.Sign(SemVer.CompareModels(
leftModelVersion!, l, leftVersion!, rightModelVersion!, r, rightVersion!)),
Is.EqualTo(expected));
Assert.That(
System.Math.Sign(SemVer.CompareModels(
rightModelVersion!, r, rightVersion!, leftModelVersion!, l, leftVersion!)),
Is.EqualTo(-expected));
}
}
}