using System.Net;
using System.Text.Json.Nodes;
using System.Text.RegularExpressions;
using Chronos.Testing;
using Chronos.Tools.Commands;
namespace Chronos.Tools.Tests;
/// gitea-release publishes a release only once its files are uploaded (BRIEF ยง19.3, amended 2026-10-23, R3).
public sealed partial class GiteaReleaseCommandTests(TestContext context)
{
private const string Server = "http://gitea.test:3000/";
private const string Token = "token-value";
[Test]
public async Task ANewTagBecomesADraftThatIsPublishedAfterItsFilesAreUploaded()
{
var files = Files(("SHA256SUMS", 120), ("Chronos-Setup-1.2.0.exe", 3000));
var gitea = new FakeGitea();
using var http = new HttpClient(gitea);
var log = new StringWriter();
var url = await GiteaReleaseCommand.PublishAsync(http,
new ReleaseRequest(Server, "BalboSoft/Chronos", "v1.2.0", "Chronos 1.2.0", "# Chronos 1.2.0\n", files, Prerelease: false), Token, log, CancellationToken.None);
Assert.Equal("https://gitea.example/BalboSoft/Chronos/releases/tag/v1.2.0", url);
var release = Assert.Contains(gitea.Releases, r => r.Tag == "v1.2.0");
Assert.False(release.Draft);
Assert.False(release.Prerelease);
Assert.Equal("Chronos 1.2.0", release.Name);
Assert.Equal("# Chronos 1.2.0\n", release.Body);
Assert.SequenceEqual(["Chronos-Setup-1.2.0.exe", "SHA256SUMS"], release.Assets.Select(a => a.Name));
Assert.Equal(3000L, release.Assets[0].Size);
// The release is created as a draft and published only after the last upload.
Assert.True(gitea.DraftAtCreation, "created as a draft");
var lastUpload = gitea.Requests.FindLastIndex(r => r.StartsWith("POST /api/v1/repos/BalboSoft/Chronos/releases/1/assets", StringComparison.Ordinal));
var publish = gitea.Requests.FindIndex(r => r == "PATCH /api/v1/repos/BalboSoft/Chronos/releases/1");
Assert.True(lastUpload >= 0 && publish > lastUpload, string.Join("\n", gitea.Requests));
Assert.True(gitea.Authorized, "every request carries the token");
Assert.False(log.ToString().Contains(Token, StringComparison.Ordinal), "the token is never logged");
}
[Test]
public async Task PublishingAnExistingReleaseAgainReplacesItsFilesOfTheSameName()
{
var gitea = new FakeGitea();
var existing = gitea.Add("v1.2.0-rc.1", draft: false, prerelease: true);
existing.Assets.Add(new FakeAsset(40, "SHA256SUMS", 10));
existing.Assets.Add(new FakeAsset(41, "old-notes.txt", 5));
var files = Files(("SHA256SUMS", 64));
using var http = new HttpClient(gitea);
await GiteaReleaseCommand.PublishAsync(http,
new ReleaseRequest(Server, "BalboSoft/Chronos", "v1.2.0-rc.1", "Chronos 1.2.0-rc.1", "notes", files, Prerelease: true), Token, TextWriter.Null, CancellationToken.None);
// The published release loses its old checksums before any other file changes.
var firstChange = gitea.Requests.FindIndex(r => r.StartsWith("DELETE ", StringComparison.Ordinal) || r.StartsWith("POST /api/v1/repos/BalboSoft/Chronos/releases/1/assets", StringComparison.Ordinal));
Assert.Equal("DELETE /api/v1/repos/BalboSoft/Chronos/releases/1/assets/40", gitea.Requests[firstChange]);
Assert.DoesNotContain("DELETE /api/v1/repos/BalboSoft/Chronos/releases/1/assets/41", gitea.Requests);
Assert.False(gitea.Requests.Any(r => r == "POST /api/v1/repos/BalboSoft/Chronos/releases"), "no second release");
Assert.Equal(64L, existing.Assets.Single(a => a.Name == "SHA256SUMS").Size);
Assert.True(existing.Prerelease);
Assert.Equal("Chronos 1.2.0-rc.1", existing.Name);
}
[Test]
public async Task AFileTheServerListsWithAnotherSizeFailsThePublication()
{
var gitea = new FakeGitea { TruncateUploads = true };
using var http = new HttpClient(gitea);
var error = await Assert.ThrowsAsync(() => GiteaReleaseCommand.PublishAsync(http,
new ReleaseRequest(Server, "BalboSoft/Chronos", "v1.0.0", "Chronos 1.0.0", "", Files(("Chronos-Setup-1.0.0.exe", 500)), false), Token, TextWriter.Null, CancellationToken.None));
Assert.Contains("Chronos-Setup-1.0.0.exe", error.Message);
// Checked before publishing: the broken release stays a draft nobody downloads from.
Assert.True(Assert.Contains(gitea.Releases, r => r.Tag == "v1.0.0").Draft);
}
[Test]
public async Task AnUnexpectedReplyNamesTheRequestAndTheStatus()
{
var gitea = new FakeGitea { Forbidden = true };
using var http = new HttpClient(gitea);
var error = await Assert.ThrowsAsync(() => GiteaReleaseCommand.PublishAsync(http,
new ReleaseRequest(Server, "BalboSoft/Chronos", "v1.0.0", "Chronos 1.0.0", "", [], false), Token, TextWriter.Null, CancellationToken.None));
Assert.Contains("403", error.Message);
Assert.Contains("/releases/tags/v1.0.0", error.Message);
Assert.False(error.Message.Contains(Token, StringComparison.Ordinal));
await Assert.ThrowsAsync(() => GiteaReleaseCommand.PublishAsync(http,
new ReleaseRequest(Server, "Chronos", "v1.0.0", "Chronos 1.0.0", "", [], false), Token, TextWriter.Null, CancellationToken.None));
}
private List Files(params (string Name, int Size)[] files)
{
var folder = context.CreateTempDirectory("assets");
var paths = new List();
foreach (var (name, size) in files)
{
var path = Path.Combine(folder, name);
File.WriteAllBytes(path, new byte[size]);
paths.Add(path);
}
return paths;
}
private sealed record FakeAsset(long Id, string Name, long Size);
private sealed class FakeRelease(long id, string tag)
{
public long Id { get; } = id;
public string Tag { get; } = tag;
public string Name { get; set; } = string.Empty;
public string Body { get; set; } = string.Empty;
public bool Draft { get; set; }
public bool Prerelease { get; set; }
public List Assets { get; } = [];
public JsonObject ToJson() => new()
{
["id"] = Id,
["tag_name"] = Tag,
["name"] = Name,
["body"] = Body,
["draft"] = Draft,
["prerelease"] = Prerelease,
["html_url"] = $"https://gitea.example/BalboSoft/Chronos/releases/tag/{Tag}",
["assets"] = new JsonArray(Assets.Select(a => (JsonNode)new JsonObject { ["id"] = a.Id, ["name"] = a.Name, ["size"] = a.Size }).ToArray()),
};
}
/// The release endpoints of the Gitea API v1, in memory.
private sealed partial class FakeGitea : HttpMessageHandler
{
private long _nextAsset = 100;
public List Releases { get; } = [];
public List Requests { get; } = [];
public bool Authorized { get; private set; } = true;
public bool DraftAtCreation { get; private set; }
public bool TruncateUploads { get; init; }
public bool Forbidden { get; init; }
public FakeRelease Add(string tag, bool draft, bool prerelease)
{
var release = new FakeRelease(Releases.Count + 1, tag) { Draft = draft, Prerelease = prerelease };
Releases.Add(release);
return release;
}
protected override async Task SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
{
var path = request.RequestUri!.AbsolutePath;
Requests.Add($"{request.Method} {path}");
if (request.Headers.Authorization?.ToString() != "token " + Token) Authorized = false;
if (Forbidden) return Reply(HttpStatusCode.Forbidden, new JsonObject { ["message"] = "forbidden" });
if (ByTag().Match(path) is { Success: true } byTag)
{
var release = Releases.FirstOrDefault(r => r.Tag == Uri.UnescapeDataString(byTag.Groups[1].Value));
return release is null ? Reply(HttpStatusCode.NotFound, new JsonObject { ["message"] = "not found" }) : Reply(HttpStatusCode.OK, release.ToJson());
}
if (request.Method == HttpMethod.Post && path == "/api/v1/repos/BalboSoft/Chronos/releases")
{
var body = JsonNode.Parse(await request.Content!.ReadAsStringAsync(cancellationToken))!;
DraftAtCreation = body["draft"]!.GetValue();
var release = Add(body["tag_name"]!.GetValue(), DraftAtCreation, body["prerelease"]!.GetValue());
release.Name = body["name"]!.GetValue();
release.Body = body["body"]!.GetValue();
return Reply(HttpStatusCode.Created, release.ToJson());
}
if (Assets().Match(path) is { Success: true } assets)
{
var release = Releases.Single(r => r.Id == long.Parse(assets.Groups[1].Value, System.Globalization.CultureInfo.InvariantCulture));
if (request.Method == HttpMethod.Get) return Reply(HttpStatusCode.OK, new JsonArray(release.Assets.Select(a => (JsonNode)new JsonObject { ["id"] = a.Id, ["name"] = a.Name, ["size"] = a.Size }).ToArray()));
if (request.Method == HttpMethod.Delete)
{
var removed = release.Assets.RemoveAll(a => a.Id == long.Parse(assets.Groups[2].Value, System.Globalization.CultureInfo.InvariantCulture));
return new HttpResponseMessage(removed > 0 ? HttpStatusCode.NoContent : HttpStatusCode.NotFound);
}
var form = (MultipartFormDataContent)request.Content!;
var part = form.Single();
Assert.Equal("attachment", part.Headers.ContentDisposition!.Name!.Trim('"'));
var bytes = await part.ReadAsByteArrayAsync(cancellationToken);
var name = Uri.UnescapeDataString(request.RequestUri.Query.Replace("?name=", "", StringComparison.Ordinal));
var asset = new FakeAsset(_nextAsset++, name, TruncateUploads ? bytes.Length / 2 : bytes.Length);
release.Assets.Add(asset);
return Reply(HttpStatusCode.Created, new JsonObject { ["id"] = asset.Id, ["name"] = asset.Name, ["size"] = asset.Size });
}
if (Release().Match(path) is { Success: true } one)
{
var release = Releases.Single(r => r.Id == long.Parse(one.Groups[1].Value, System.Globalization.CultureInfo.InvariantCulture));
if (request.Method.Method == "PATCH")
{
var body = JsonNode.Parse(await request.Content!.ReadAsStringAsync(cancellationToken))!;
release.Name = body["name"]!.GetValue();
release.Body = body["body"]!.GetValue();
release.Draft = body["draft"]!.GetValue();
release.Prerelease = body["prerelease"]!.GetValue();
}
return Reply(HttpStatusCode.OK, release.ToJson());
}
return Reply(HttpStatusCode.NotFound, new JsonObject { ["message"] = "no route" });
}
private static HttpResponseMessage Reply(HttpStatusCode status, JsonNode body) =>
new(status) { Content = new StringContent(body.ToJsonString(), System.Text.Encoding.UTF8, "application/json") };
[GeneratedRegex(@"^/api/v1/repos/BalboSoft/Chronos/releases/tags/(.+)$")]
private static partial Regex ByTag();
[GeneratedRegex(@"^/api/v1/repos/BalboSoft/Chronos/releases/(\d+)/assets(?:/(\d+))?$")]
private static partial Regex Assets();
[GeneratedRegex(@"^/api/v1/repos/BalboSoft/Chronos/releases/(\d+)$")]
private static partial Regex Release();
}
}