feat(tools): add pack-installer command

Appends a TPK1 payload to Titano.Setup.exe from repeatable --component
Id=folder options, as release.yml invokes it. Known components (Titano,
Uploader, Server) get display names, default selection, Start menu/desktop
shortcuts and the .titano file type; prints file count and sizes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
This commit is contained in:
Claude committed 2026-10-02 09:58:29 +00:00
1 parent fc8df1f411
commit c591aced94
3 files changed
+112 -2

No files matched your search

+2 -2
View File
@@ -100,7 +100,7 @@ public static class PayloadWriter
var root = Path.TrimEndingDirectorySeparator(Path.GetFullPath(component.Folder));
if (!Directory.Exists(root)) throw new DirectoryNotFoundException($"Component folder '{component.Folder}' does not exist.");
if (output.StartsWith(root + Path.DirectorySeparatorChar, StringComparison.OrdinalIgnoreCase))
throw new ArgumentException($"The installer cannot be written inside the component folder '{component.Folder}'.", nameof(output));
throw new ArgumentException($"The installer cannot be written inside the component folder '{component.Folder}'.");
inputs.AddRange(Directory.EnumerateFiles(root, "*", options)
.Select(f => new Input(component.Id, PayloadPath.FromRelative(Path.GetRelativePath(root, f)), f))
.OrderBy(i => i.Path, StringComparer.Ordinal));
@@ -189,7 +189,7 @@ public static class PayloadWriter
{
using (var stub = new FileStream(stubPath, FileMode.Open, FileAccess.Read, FileShare.Read, BufferSize))
{
if (PayloadReader.HasFooter(stub)) throw new ArgumentException($"'{stubPath}' already carries a payload; use the plain setup program.", nameof(stubPath));
if (PayloadReader.HasFooter(stub)) throw new ArgumentException($"'{stubPath}' already carries a payload; use the plain setup program.");
var buffer = ArrayPool<byte>.Shared.Rent(BufferSize);
try
{
@@ -0,0 +1,109 @@
using System.Globalization;
using Titano.Core.Packaging;
namespace Titano.Tools.Commands;
/// <summary>
/// <c>pack-installer --setup Titano.Setup.exe --product Titano --version 1.2.3 --component Id=folder … --out file</c>:
/// appends a TPK1 payload (BRIEF §18) to the setup program. Known component ids carry their display name, default
/// selection, shortcuts and file types; unknown ids are packed as plain, preselected components.
/// </summary>
internal sealed class PackInstallerCommand : ICommand
{
private sealed record KnownComponent(string DisplayName, bool DefaultSelected, string Program, bool Desktop, PayloadAssociation? Association);
private static readonly Dictionary<string, KnownComponent> Known = new(StringComparer.OrdinalIgnoreCase)
{
["Titano"] = new("Titano", true, "Titano.exe", Desktop: true,
new PayloadAssociation { Component = "Titano", Extension = ".titano", ProgId = "Titano.Project", Description = "Titano project", Target = "Titano.exe" }),
["Uploader"] = new("Titano Uploader", true, "Titano.Uploader.exe", Desktop: true, null),
["Server"] = new("Titano Server", false, "Titano.Server.exe", Desktop: false, null),
};
public string Name => "pack-installer";
public string Summary => "--setup <exe> --product <name> --version <v> --component Id=dir … --out <file>";
public Task<int> RunAsync(string[] args)
{
var options = Parse(args);
var setup = Required(options, "setup");
var output = Required(options, "out");
if (!File.Exists(setup)) throw new ToolException($"Setup program '{setup}' not found.");
if (!options.TryGetValue("component", out var specs)) throw new ToolException("At least one --component Id=folder is required.");
var components = new List<PayloadComponentSource>();
var shortcuts = new List<PayloadShortcut>();
var associations = new List<PayloadAssociation>();
foreach (var spec in specs)
{
var eq = spec.IndexOf('=', StringComparison.Ordinal);
if (eq <= 0 || eq == spec.Length - 1) throw new ToolException($"--component expects Id=folder, got '{spec}'.");
var id = spec[..eq];
var folder = spec[(eq + 1)..];
if (!PayloadManifest.IdentifierRegex().IsMatch(id)) throw new ToolException($"Component id '{id}' must be letters and digits.");
if (components.Any(c => c.Id.Equals(id, StringComparison.OrdinalIgnoreCase))) throw new ToolException($"Component '{id}' given twice.");
if (!Directory.Exists(folder)) throw new ToolException($"Component folder '{folder}' not found.");
if (!Known.TryGetValue(id, out var known))
{
components.Add(new PayloadComponentSource(id, id, true, folder));
continue;
}
components.Add(new PayloadComponentSource(id, known.DisplayName, known.DefaultSelected, folder));
if (!File.Exists(Path.Combine(folder, known.Program)))
{
Console.Error.WriteLine($"warning: {id} has no {known.Program}; no shortcut or file type registered.");
continue;
}
shortcuts.Add(new PayloadShortcut { Component = id, Name = known.DisplayName, Target = known.Program, StartMenu = true, Desktop = known.Desktop });
if (known.Association is { } association) associations.Add(association);
}
var source = new PayloadSource
{
Product = Required(options, "product"),
Version = Required(options, "version"),
Components = components,
Shortcuts = shortcuts,
Associations = associations,
};
try
{
Directory.CreateDirectory(Path.GetDirectoryName(Path.GetFullPath(output))!);
var result = PayloadWriter.Write(setup, source, output);
Console.WriteLine(string.Create(CultureInfo.InvariantCulture,
$"{output}: {result.FileCount} files in {components.Count} component(s), {Megabytes(result.InstallerBytes)} ({result.InstallerBytes:N0} bytes), installs {Megabytes(result.InstalledBytes)}"));
return Task.FromResult(0);
}
catch (Exception ex) when (ex is PayloadException or ArgumentException or IOException)
{
throw new ToolException("pack-installer: " + ex.Message);
}
}
/// <summary><c>--key value</c> pairs; every key may repeat (only <c>--component</c> is meant to).</summary>
private static Dictionary<string, List<string>> Parse(string[] args)
{
var allowed = new HashSet<string>(StringComparer.OrdinalIgnoreCase) { "setup", "product", "version", "component", "out" };
var options = new Dictionary<string, List<string>>(StringComparer.OrdinalIgnoreCase);
for (var i = 0; i < args.Length; i++)
{
if (!args[i].StartsWith("--", StringComparison.Ordinal) || !allowed.Contains(args[i][2..]))
throw new ToolException($"Unexpected argument '{args[i]}'.");
if (i + 1 >= args.Length) throw new ToolException($"{args[i]} needs a value.");
var key = args[i][2..];
if (!options.TryGetValue(key, out var values)) options[key] = values = [];
values.Add(args[++i]);
}
return options;
}
private static string Required(Dictionary<string, List<string>> options, string key)
{
if (!options.TryGetValue(key, out var values) || string.IsNullOrWhiteSpace(values[^1])) throw new ToolException($"--{key} is required.");
if (values.Count > 1) throw new ToolException($"--{key} given more than once.");
return values[0];
}
private static string Megabytes(long bytes) => (bytes / 1_000_000d).ToString("0.0", CultureInfo.InvariantCulture) + " MB";
}
+1
View File
@@ -8,6 +8,7 @@ var commands = new ICommand[]
new XamlLintCommand(),
new PackageGuardCommand(),
new ChangelogCommand(),
new PackInstallerCommand(),
};
if (args.Length == 0 || args[0] is "-h" or "--help" or "help")