using System.Text.Json.Nodes; using System.Text.RegularExpressions; using Chronos.Testing; using Chronos.Tools.Commands; namespace Chronos.Tools.Tests; /// /// 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). /// 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 EveryPageOfTheListCounts() { // Gitea lists 50 releases a page, newest first: 50 pre-releases after v1.0.0 push it to the second page. var first = Releases([.. Enumerable.Range(1, 50).Reverse().Select(n => $"v1.1.0-rc.{n}")]); var second = Releases("v1.0.0", "v0.9.0"); Assert.Equal(ImageOnly, Decide("v1.1.0-rc.51", first), "the first page alone shows no stable release"); Assert.Equal(Neither, Decide("v1.1.0-rc.51", first, second)); Assert.Equal(Neither, Decide("v0.9.0", first, second)); Assert.Equal(Both, Decide("v1.1.0", first, second, "[]")); } [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(() => command.RunAsync(["--tag", "1.0.0", "--releases", file])); Assert.Contains("'1.0.0'", invalid.Message); await Assert.ThrowsAsync(() => command.RunAsync(["--tag", "v1.0.0-rc.01", "--releases", file])); await Assert.ThrowsAsync(() => command.RunAsync(["--releases", file])); await Assert.ThrowsAsync(() => command.RunAsync(["--tag", "v1.0.0", "--releases", file + ".missing"])); // Every page is read: a missing one is refused, not skipped. Assert.Equal(0, await command.RunAsync(["--tag", "v1.0.0", "--releases", file, "--releases", file])); await Assert.ThrowsAsync(() => command.RunAsync(["--tag", "v1.0.0", "--releases", file, "--releases", file + ".missing"])); // A sign-in page or an API error instead of the list, on any page. Assert.Throws(() => Decide("v1.0.0", "Sign in")); Assert.Throws(() => Decide("v1.0.0", """{"message":"not found"}""")); Assert.Throws(() => Decide("v1.0.0", "[]", """{"message":"not found"}""")); } [Test] public void TheReleaseWorkflowRefusesTheTagsReleaseChannelsRefuses() { // release.yml checks the tag before building, so a tag release-channels would refuse never gets published. var lines = File.ReadAllLines(Path.Combine(Args.RepoRoot(), ".gitea", "workflows", "release.yml")) .Select(l => l.Trim()).Where(l => l.StartsWith("semver='", StringComparison.Ordinal) && l.EndsWith('\'')).ToList(); Assert.Count(1, lines); var check = new Regex(lines[0]["semver='".Length..^1], RegexOptions.CultureInvariant); string[] tags = [ "v0.1.0", "v1.2.3", "v10.20.30", "v0.1.0-rc.1", "v1.0.0-alpha.beta", "v1.0.0-0", "v1.0.0-x-y.7z.92", "v1.0.0-rc.1+sha.5", "v1.0.0+build", "1.0.0", "V1.0.0", "v1.0", "v1.0.0.0", "v01.2.0", "v1.02.0", "v1.2.03", "v1.0.0-", "v1.0.0-rc.", "v1.0.0-rc..1", "v1.0.0-rc.01", "v1.0.0-rc_1", "latest", ]; foreach (var tag in tags) { // Build metadata is refused by the workflow as well: an image tag cannot hold a "+". var expected = TagVersion.Parse(tag) is not null && !tag.Contains('+', StringComparison.Ordinal); Assert.Equal(expected, check.IsMatch(tag), tag); } } private static ReleaseChannels Decide(string tag, params 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), }; }