tiny.smg.command.analyze.command

1const std = @import("std");23const smg = @import("../../root.zig");4const analysis = smg.analysis;5const concepts = smg.concepts;6const diff = smg.diff;7const graph_mod = smg.graph;8const view = smg.view;9const support = @import("support.zig");10const cli_options = smg.cli.options;11const cli_output = smg.cli.output;12const cli_session = smg.command.session;13const cli_validation = smg.cli.validation;1415pub fn run(allocator: std.mem.Allocator, phases: std.mem.Allocator, args: []const []const u8, limits: smg.Limits, boundary: cli_session.PhaseBoundary) !u8 {16    if (cli_options.hasFlag(args, "--json")) {17        try cli_output.writeClickUsageError(allocator, "analyze", "[OPTIONS]", "No such option: --json Did you mean --since?");18        return 2;19    }20    if (try cli_validation.rejectMissingOptionValues(allocator, args, &.{ "--top", "--module", "--since", "--churn-days", "--format" })) return 2;21    if (try cli_validation.rejectUnexpectedOptionsPlain(allocator, "analyze", "[OPTIONS]", args, &.{ "--since", "--top", "--module", "--summary", "--concepts", "--churn-days", "--format", "--full", "--include-betweenness" })) return 2;22    const pos = try cli_options.positional(allocator, args);23    if (pos.len != 0) {24        try cli_output.writeClickUsageError(allocator, "analyze", "[OPTIONS]", try cli_validation.unexpectedArgumentMessage(allocator, pos));25        return 2;26    }27    const top = (try integerOption(allocator, args, "--top", 5)) orelse return 2;28    const churn_days = (try integerOption(allocator, args, "--churn-days", 90)) orelse return 2;29    const fmt = (try formatOption(allocator, args)) orelse return 2;30    const with_concepts = cli_options.hasFlag(args, "--concepts");31    const Loaded = struct {32        root: []const u8,33        graph: graph_mod.Graph,34        concepts: ?[]const concepts.Concept,35    };36    const loaded: Loaded = if (with_concepts) loaded: {37        const values = try cli_session.loadReadGraphAndConcepts(allocator, phases, limits, boundary);38        break :loaded .{39            .root = values.root,40            .graph = values.graph,41            .concepts = values.concepts,42        };43    } else loaded: {44        const values = try cli_session.loadRead(allocator, phases, limits, boundary);45        break :loaded .{46            .root = values[0],47            .graph = values[1],48            .concepts = null,49        };50    };51    defer boundary.beginTeardown();52    const root = loaded.root;53    var graph = loaded.graph;54    const module_filter = cli_options.flagValue(args, "--module");55    if (module_filter) |filter| {56        const unscoped = graph;57        graph = try view.scopePrefix(graph, allocator, filter);58        if (graph.nodes.items.len == 0 and unscoped.nodes.items.len != 0) try support.writeScopeWarning(allocator, unscoped, filter);59    }60    const delta_filter = try deltaFilter(allocator, root, graph, args, limits);61    if (delta_filter == null and cli_options.flagValue(args, "--since") != null) return 2;62    const concept_analysis = try conceptAnalysis(allocator, graph, loaded.concepts);63    if (concept_analysis == null and with_concepts) return 2;64    return try cli_output.writeOut(try analysis.analyze(allocator, graph, cli_options.hasFlag(args, "--summary"), std.mem.eql(u8, fmt, "json"), top, cli_options.hasFlag(args, "--full"), module_filter, concept_analysis, root, churn_days, cli_options.hasFlag(args, "--include-betweenness"), delta_filter, limits.analysis));65}6667fn integerOption(allocator: std.mem.Allocator, args: []const []const u8, option: []const u8, default: i64) !?i64 {68    const raw = cli_options.flagValue(args, option) orelse return default;69    return std.fmt.parseInt(i64, raw, 10) catch {70        try cli_output.writeClickUsageError(allocator, "analyze", "[OPTIONS]", try std.fmt.allocPrint(allocator, "Invalid value for '{s}': '{s}' is not a valid integer.", .{ option, raw }));71        return null;72    };73}7475fn formatOption(allocator: std.mem.Allocator, args: []const []const u8) !?[]const u8 {76    const fmt = cli_options.flagValue(args, "--format") orelse "text";77    if (isFormat(fmt)) return fmt;78    try cli_output.writeClickUsageError(allocator, "analyze", "[OPTIONS]", try std.fmt.allocPrint(allocator, "Invalid value for '--format': '{s}' is not one of 'text', 'json'.", .{fmt}));79    return null;80}8182fn deltaFilter(allocator: std.mem.Allocator, root: []const u8, graph: graph_mod.Graph, args: []const []const u8, limits: smg.Limits) !?analysis.DeltaFilter {83    const ref = cli_options.flagValue(args, "--since") orelse return null;84    var invalid = false;85    const old_graph_optional = try diff.loadGraphFromGit(allocator, root, ref, &invalid, limits);86    if (invalid) {87        try cli_output.writeErrFmt(allocator, "Error: invalid git ref: {s}\n", .{ref});88        return null;89    }90    const old_graph = old_graph_optional orelse graph_mod.init(allocator);91    const result = try diff.graphs(allocator, old_graph, graph, true);92    return .{ .git_ref = ref, .names = try support.deltaNames(allocator, result) };93}9495fn conceptAnalysis(allocator: std.mem.Allocator, graph: graph_mod.Graph, concept_list: ?[]const concepts.Concept) !?concepts.Analysis {96    const loaded = concept_list orelse return null;97    var overlap_message: []const u8 = "";98    return concepts.analyze(allocator, graph, loaded, &overlap_message) catch |err| {99        if (err == error.ConceptOverlap) {100            try cli_output.writeErrFmt(allocator, "Error: {s}\n", .{overlap_message});101            return null;102        }103        return err;104    };105}106107fn isFormat(fmt: []const u8) bool {108    return std.mem.eql(u8, fmt, "text") or std.mem.eql(u8, fmt, "json");109}110111test "analyze format option accepts text and json only" {112    try std.testing.expect(isFormat("text"));113    try std.testing.expect(isFormat("json"));114    try std.testing.expect(!isFormat("dot"));115}

1pub const command = @import("command.zig");