CI / Build and test (push) Successful in 5m11s
CI / Windows tests and installer (push) Skipped
CI / YAML check (push) Successful in 6s
Release / Build, test and publish (push) Successful in 8m57s
CI / PostgreSQL 16 integration (push) Successful in 3m10s
CI / PostgreSQL 17 integration (push) Successful in 3m30s
CI / Docker image (push) Successful in 49s
Release / Server image (push) Successful in 1m4s
- :latest follows the highest stable release, or the highest pre-release while none is stable (Chronos.Tools release-channels); bad tags are refused before anything is built. - Unraid: CHRONOS_SPACE_PATH and the template's Array view show the array's free space; the write volume (cache) is shown apart; completions check the archive volume (507). - Settings is a gear, docked at the foot of the admin sidebar; About is the last part of Settings on the desktop and the panel. - Import > Folder > Whole folder: one sequence per format (desktop only). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: Alberto Balbo <alberto.balbo.96@gmail.com>
188 lines
8.8 KiB
C#
188 lines
8.8 KiB
C#
using System.Text.Json.Nodes;
|
|
using System.Text.RegularExpressions;
|
|
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 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<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"]));
|
|
// 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<ToolException>(() => 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<ToolException>(() => Decide("v1.0.0", "<html>Sign in</html>"));
|
|
Assert.Throws<ToolException>(() => Decide("v1.0.0", """{"message":"not found"}"""));
|
|
Assert.Throws<ToolException>(() => 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),
|
|
};
|
|
}
|