Only pre-releases (v0.1.0-rc.1, rc.2) are published, and :latest followed the highest stable release only, so the Unraid template and the compose file, which pull :latest, found no image while :nightly was pushed every night. The new Chronos.Tools command release-channels reads the published releases (stable and pre-releases), ignores drafts and tags that are not SemVer, counts the tag itself as published and compares by SemVer 2.0 precedence. It prints latest (the public releases repository: highest stable release only) and image_latest (:latest: the highest stable release, or the highest pre-release while none is stable). Re-publishing an older tag never rolls either back. release.yml uses it in place of curl|grep|sort -V; the image job pushes :latest on image_latest. README, the public README, the compose file and ARCHITECTURE explain :latest, :<version> and :nightly. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
148 lines
6.5 KiB
C#
148 lines
6.5 KiB
C#
using System.Text.Json.Nodes;
|
|
using Chronos.Testing;
|
|
using Chronos.Tools.Commands;
|
|
|
|
namespace Chronos.Tools.Tests;
|
|
|
|
/// <summary>
|
|
/// release-channels: the public content follows the highest stable release, the image's :latest the highest stable or,
|
|
/// while none exists, the highest pre-release (BRIEF §19.3, amended 2026-10-26, R1).
|
|
/// </summary>
|
|
public sealed class ReleaseChannelsCommandTests(TestContext context)
|
|
{
|
|
private static readonly ReleaseChannels Both = new(Latest: true, ImageLatest: true);
|
|
private static readonly ReleaseChannels ImageOnly = new(Latest: false, ImageLatest: true);
|
|
private static readonly ReleaseChannels Neither = new(Latest: false, ImageLatest: false);
|
|
|
|
[Test]
|
|
public void TheHighestStableReleaseMovesBothChannels()
|
|
{
|
|
Assert.Equal(Both, Decide("v0.2.0", Releases("v0.1.0-rc.1", "v0.1.0", "v0.2.0-rc.1", "v0.2.0")));
|
|
}
|
|
|
|
[Test]
|
|
public void AnOlderStableReleasePublishedAgainMovesNothing()
|
|
{
|
|
Assert.Equal(Neither, Decide("v1.0.0", Releases("v1.0.0", "v1.1.0", "v0.9.0")));
|
|
}
|
|
|
|
[Test]
|
|
public void WithoutAStableReleaseTheHighestPreReleaseMovesOnlyTheImage()
|
|
{
|
|
var releases = Releases("v0.1.0-rc.1", "v0.1.0-rc.2");
|
|
Assert.Equal(ImageOnly, Decide("v0.1.0-rc.2", releases));
|
|
// An older pre-release published again does not take :latest back.
|
|
Assert.Equal(Neither, Decide("v0.1.0-rc.1", releases));
|
|
}
|
|
|
|
[Test]
|
|
public void APreReleaseAfterAStableReleaseMovesNothing()
|
|
{
|
|
Assert.Equal(Neither, Decide("v0.2.0-rc.1", Releases("v0.1.0-rc.2", "v0.1.0", "v0.2.0-rc.1")));
|
|
}
|
|
|
|
[Test]
|
|
public void NumericPreReleaseIdentifiersCompareByValue()
|
|
{
|
|
var releases = Releases("v0.1.0-rc.2", "v0.1.0-rc.10", "v0.1.0-rc.9");
|
|
Assert.Equal(ImageOnly, Decide("v0.1.0-rc.10", releases), "rc.10 is above rc.2 and rc.9");
|
|
Assert.Equal(Neither, Decide("v0.1.0-rc.2", releases), "rc.2 is below rc.10");
|
|
}
|
|
|
|
[Test]
|
|
public void BuildMetadataIsIgnoredForPrecedenceAndIsNotAPreRelease()
|
|
{
|
|
Assert.Equal(Both, Decide("v1.0.0+build.5", Releases("v1.0.0+build.4", "v0.9.0")));
|
|
Assert.Equal(Neither, Decide("v1.0.0+zzz", Releases("v1.0.1+aaa")));
|
|
Assert.Equal(ImageOnly, Decide("v1.0.0-rc.1+sha.5114f85", Releases("v1.0.0-rc.1")));
|
|
}
|
|
|
|
[Test]
|
|
public void DraftsAreIgnored()
|
|
{
|
|
var releases = new JsonArray(Release("v2.0.0", draft: true), Release("v1.0.0", draft: true), Release("v0.1.0-rc.1")).ToJsonString();
|
|
Assert.Equal(ImageOnly, Decide("v0.1.0-rc.1", releases));
|
|
Assert.Equal(Both, Decide("v1.5.0", releases));
|
|
}
|
|
|
|
[Test]
|
|
public void TagsThatAreNotSemVerAreIgnored()
|
|
{
|
|
var releases = Releases("latest", "nightly", "v9", "v9.9", "9.9.9", "V9.9.9", "v09.0.0", "v9.9.9.9", "v9.9.9-",
|
|
"v9.9.9-rc..1", "v9.9.9-rc.01", "v9.9.9\n");
|
|
Assert.Equal(Both, Decide("v0.1.0", releases));
|
|
// Entries without a usable tag name are skipped; one without flags counts as published.
|
|
Assert.Equal(Neither, Decide("v2.0.0", """[{"name":"no tag"},{"tag_name":42},{"tag_name":"v3.0.0"},7,null]"""));
|
|
}
|
|
|
|
[Test]
|
|
public void TheTagCountsAsPublishedWhenTheListIsEmpty()
|
|
{
|
|
Assert.Equal(Both, Decide("v1.0.0", "[]"));
|
|
Assert.Equal(ImageOnly, Decide("v1.0.0-rc.1", "[]"));
|
|
}
|
|
|
|
[Test]
|
|
public void AStableTagGiteaFlagsAsAPreReleaseCountsAsAPreRelease()
|
|
{
|
|
var releases = new JsonArray(Release("v1.0.0", prerelease: true), Release("v0.9.0")).ToJsonString();
|
|
Assert.Equal(Neither, Decide("v1.0.0", releases));
|
|
Assert.Equal(Both, Decide("v0.9.0", releases));
|
|
}
|
|
|
|
[Test]
|
|
public void VersionsFollowTheSemVerPrecedence()
|
|
{
|
|
// semver.org §11's example, then the core numbers (one longer than a long integer): each is lower than the next.
|
|
string[] ordered =
|
|
[
|
|
"v1.0.0-alpha", "v1.0.0-alpha.1", "v1.0.0-alpha.beta", "v1.0.0-beta", "v1.0.0-beta.2", "v1.0.0-beta.11",
|
|
"v1.0.0-rc.1", "v1.0.0", "v1.0.1", "v1.1.0", "v2.0.0", "v10.0.0", "v12345678901234567890.0.0",
|
|
];
|
|
for (var i = 0; i + 1 < ordered.Length; i++)
|
|
{
|
|
var lower = Assert.NotNull(TagVersion.Parse(ordered[i]));
|
|
var higher = Assert.NotNull(TagVersion.Parse(ordered[i + 1]));
|
|
Assert.True(lower.CompareTo(higher) < 0 && higher.CompareTo(lower) > 0, $"{ordered[i]} < {ordered[i + 1]}");
|
|
}
|
|
Assert.Equal(0, Assert.NotNull(TagVersion.Parse("v1.0.0+a")).CompareTo(TagVersion.Parse("v1.0.0+b")));
|
|
}
|
|
|
|
[Test]
|
|
public void TheOutputIsTwoLinesForTheWorkflow()
|
|
{
|
|
Assert.Equal("latest=false\nimage_latest=true\n", ReleaseChannelsCommand.Render(ImageOnly));
|
|
Assert.Equal("latest=true\nimage_latest=true\n", ReleaseChannelsCommand.Render(Both));
|
|
Assert.Equal("latest=false\nimage_latest=false\n", ReleaseChannelsCommand.Render(Neither));
|
|
}
|
|
|
|
[Test]
|
|
public async Task AnInvalidTagOrReleasesFileIsRefused()
|
|
{
|
|
var file = Path.Combine(context.CreateTempDirectory("release-channels"), "releases.json");
|
|
await File.WriteAllTextAsync(file, "[]");
|
|
var command = new ReleaseChannelsCommand();
|
|
|
|
var invalid = await Assert.ThrowsAsync<ToolException>(() => command.RunAsync(["--tag", "1.0.0", "--releases", file]));
|
|
Assert.Contains("'1.0.0'", invalid.Message);
|
|
await Assert.ThrowsAsync<ToolException>(() => command.RunAsync(["--tag", "v1.0.0-rc.01", "--releases", file]));
|
|
await Assert.ThrowsAsync<ToolException>(() => command.RunAsync(["--releases", file]));
|
|
await Assert.ThrowsAsync<ToolException>(() => command.RunAsync(["--tag", "v1.0.0", "--releases", file + ".missing"]));
|
|
// A sign-in page or an API error instead of the list.
|
|
Assert.Throws<ToolException>(() => Decide("v1.0.0", "<html>Sign in</html>"));
|
|
Assert.Throws<ToolException>(() => Decide("v1.0.0", """{"message":"not found"}"""));
|
|
}
|
|
|
|
private static ReleaseChannels Decide(string tag, string releases) => ReleaseChannelsCommand.Decide(tag, releases);
|
|
|
|
private static string Releases(params string[] tags) => new JsonArray([.. tags.Select(t => Release(t))]).ToJsonString();
|
|
|
|
// The fields of Gitea's release list that matter, flagged as gitea-release publishes them.
|
|
private static JsonObject Release(string tag, bool draft = false, bool? prerelease = null) => new()
|
|
{
|
|
["tag_name"] = tag,
|
|
["draft"] = draft,
|
|
["prerelease"] = prerelease ?? tag.Contains('-', StringComparison.Ordinal),
|
|
};
|
|
}
|