using System.Globalization; using Chronos.Core.Packaging; namespace Chronos.Tools.Commands; /// /// pack-installer --setup Chronos.Setup.exe --product Chronos --version 1.2.3 --component Id=folder … --out file [--legacy]: /// appends a TPK1 payload (BRIEF §18) to the setup program. Known component ids carry their display name, default /// selection, shortcuts and file types: Chronos (alias Desktop), the desktop app, preselected, and /// Uploader, not preselected; unknown ids are packed as plain, preselected components. A setup of one component /// preselects it, as the separate 1.0 Uploader setup the CI test stands in for did: a silent run without /// /COMPONENTS installs it. Chronos Server is no /// longer packed (it ships as a Docker image): Server is refused unless --legacy, which packs it as 1.0 /// named it (not preselected, Start menu shortcut) for the CI test of a retained 1.0 Server, installable for the /// current user so that the test needs no administrator rights. /// internal sealed class PackInstallerCommand : ICommand { /// The component's name when setup has no translation of it. /// The shortcut's file name, which links, pins and the sign-in entries follow: never renamed. private sealed record KnownComponent(string DisplayName, string ShortcutName, bool DefaultSelected, string Program, bool Desktop, PayloadAssociation? Association); /// The file type's description is the English fallback; setup writes it in its own language (Setup.FileType.*). private static readonly Dictionary Known = new(StringComparer.OrdinalIgnoreCase) { ["Chronos"] = new("Chronos Desktop", "Chronos", true, "Chronos.exe", Desktop: true, new PayloadAssociation { Component = "Chronos", Extension = ".chronos", ProgId = "Chronos.Project", Description = "Chronos project", Target = "Chronos.exe" }), ["Uploader"] = new("Chronos Uploader", "Chronos Uploader", false, "Chronos.Uploader.exe", Desktop: true, null), }; /// The 1.0 Windows Server, packed only with --legacy. private static readonly KnownComponent LegacyServer = new("Chronos Server", "Chronos Server", false, "Chronos.Server.exe", Desktop: false, null); private const string ServerId = "Server"; /// --component Desktop=… packs the component Chronos, as /COMPONENTS=Desktop selects it. private const string DesktopAlias = "Desktop"; public string Name => "pack-installer"; public string Summary => "--setup --product --version --component Id=dir … --out [--legacy]"; public Task RunAsync(string[] args) { var legacy = args.Contains("--legacy", StringComparer.Ordinal); var options = Parse([.. args.Where(a => a != "--legacy")]); 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(); var shortcuts = new List(); var associations = new List(); 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]; if (id.Equals(DesktopAlias, StringComparison.OrdinalIgnoreCase)) id = "Chronos"; 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."); KnownComponent? known; if (id.Equals(ServerId, StringComparison.OrdinalIgnoreCase)) { if (!legacy) throw new ToolException("Chronos Server is no longer packed into the setup (it ships as a Docker image); --legacy packs a 1.0 Server for the migration test."); known = LegacyServer; id = ServerId; } else if (!Known.TryGetValue(id, out 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.ShortcutName, Target = known.Program, StartMenu = true, Desktop = known.Desktop }); if (known.Association is { } association) associations.Add(association); } // A single component is what the setup installs: preselected, or a silent run without /COMPONENTS would install nothing. if (components is [var only] && !only.DefaultSelected) components[0] = only with { DefaultSelected = true }; 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); } } /// --key value pairs; every key may repeat (only --component is meant to). private static Dictionary> Parse(string[] args) { var allowed = new HashSet(StringComparer.OrdinalIgnoreCase) { "setup", "product", "version", "component", "out" }; var options = new Dictionary>(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> 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"; }