const std = @import("std"); const Endpoint = @import("../ui/server.zig").Endpoint; const Invocation = @This(); pub const Command = union(enum) { check, convert, interactive: Endpoint, }; manifest_path: []const u8, command: Command, pub fn parse(args: []const []const u8) error{ InvalidArguments, EndpointParseError }!Invocation { if (args.len < 3) return error.InvalidArguments; const manifest_path = args[2]; if (manifest_path.len == 0 or manifest_path[0] == '-') return error.InvalidArguments; if (std.mem.eql(u8, args[1], "check")) { if (args.len > 3) return error.InvalidArguments; return .{ .manifest_path = manifest_path, .command = .check }; } else if (std.mem.eql(u8, args[1], "convert")) { if (args.len > 3) return error.InvalidArguments; return .{ .manifest_path = manifest_path, .command = .convert }; } else if (std.mem.eql(u8, args[1], "interactive")) { const listen = if (args.len == 3) Endpoint.default else if (args.len > 4 and std.mem.eql(u8, args[3], "--listen")) try Endpoint.parse(args[4]) else return error.InvalidArguments; return .{ .manifest_path = manifest_path, .command = .{ .interactive = listen } }; } else return error.InvalidArguments; } // -- tests ------------------------------------------------------------------- const expectEqual = std.testing.expectEqual; const expectEqualStrings = std.testing.expectEqualStrings; const expectFmt = std.testing.expectFmt; const expectError = std.testing.expectError; test "M1-CLI-001: the three invocation forms parse" { var arena = std.heap.ArenaAllocator.init(std.testing.allocator); defer arena.deinit(); const checked = try Invocation.parse(&.{ "csv2journal", "check", "p.yaml" }); try expectEqual(Invocation.Command.check, checked.command); try expectEqualStrings("p.yaml", checked.manifest_path); const converted = try Invocation.parse(&.{ "csv2journal", "convert", "p.yaml" }); try expectEqual(Invocation.Command.convert, converted.command); const served = try Invocation.parse(&.{ "csv2journal", "interactive", "p.yaml" }); switch (served.command) { .interactive => |addr| try expectEqual(Endpoint.default, addr), else => return error.ExpectedInteractive, } } test "M1-UI-001: interactive accepts an explicit listen endpoint" { var arena = std.heap.ArenaAllocator.init(std.testing.allocator); defer arena.deinit(); const served = try Invocation.parse(&.{ "csv2journal", "interactive", "p.yaml", "--listen", "0.0.0.0:9000", }); switch (served.command) { .interactive => |addr| try expectFmt("0.0.0.0:9000", "{f}", .{addr}), else => return error.WantedInteractive, } } test "M1-CLI-002: the manifest is required on every form" { var arena = std.heap.ArenaAllocator.init(std.testing.allocator); defer arena.deinit(); try expectError(error.InvalidArguments, Invocation.parse(&.{ "csv2journal", "check" })); try expectError(error.InvalidArguments, Invocation.parse(&.{"csv2journal"})); } test "M1-CLI-001: unknown commands and stray arguments are refused" { var arena = std.heap.ArenaAllocator.init(std.testing.allocator); defer arena.deinit(); try expectError(error.InvalidArguments, Invocation.parse(&.{ "csv2journal", "validate", "p.yaml" })); try expectError(error.InvalidArguments, Invocation.parse(&.{ "csv2journal", "check", "p.yaml", "extra" })); try expectError(error.InvalidArguments, Invocation.parse(&.{ "csv2journal", "check", "p.yaml", "--listen", "127.0.0.1:8080", })); try expectError(error.InvalidArguments, Invocation.parse(&.{ "csv2journal", "interactive", "p.yaml", "--listen", })); } test "M1-UI-001: interactive uses the default endpoint unless told otherwise" { var arena = std.heap.ArenaAllocator.init(std.testing.allocator); defer arena.deinit(); const plain = try Invocation.parse(&.{ "csv2journal", "interactive", "p.yaml" }); switch (plain.command) { .interactive => |addr| { try expectEqualStrings("127.0.0.1", addr.host); try expectEqual(@as(u16, 8080), addr.port); }, else => return error.ExpectedInteractive, } const explicit = try Invocation.parse(&.{ "csv2journal", "interactive", "p.yaml", "--listen", "0.0.0.0:9000", }); switch (explicit.command) { .interactive => |addr| try expectEqual(@as(u16, 9000), addr.port), else => return error.ExpectedInteractive, } // A malformed endpoint resolves to nothing, and the run reports it. try expectError(error.EndpointParseError, Invocation.parse(&.{ "csv2journal", "interactive", "p.yaml", "--listen", "nonsense", })); } test "M1-CLI-007: no option bypasses any invariant" { var arena = std.heap.ArenaAllocator.init(std.testing.allocator); defer arena.deinit(); // None of these exist, and adding one would be a requirements change. for ([_][]const u8{ "--force", "--no-history", "--overwrite", "--allow-unmatched", "--skip-checks" }) |flag| { try expectError( error.InvalidArguments, Invocation.parse(&.{ "csv2journal", "convert", "p.yaml", flag }), ); } }