tokmd 1.15.0

Tokei-backed repo inventory receipts (Markdown/TSV/JSONL/CSV) for PRs, CI, and LLM workflows.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

use crate::cli;
use anyhow::Result;
use tokmd_format as format;
use tokmd_model as model;
use tokmd_scan as scan;
use tokmd_settings::ScanOptions;

use crate::config::{self, ResolvedConfig};
use crate::progress::Progress;

/// When exactly one scan root is provided, strip it from host file paths before
/// module-key aggregation so single-root CLI scans match `module_workflow` and
/// archive/virtual relative paths.
fn single_scan_root_strip_prefix(paths: &[std::path::PathBuf]) -> Option<&std::path::Path> {
    if paths.len() == 1 {
        paths.first().map(|path| path.as_path())
    } else {
        None
    }
}

pub(crate) fn handle(
    cli_args: cli::CliModuleArgs,
    global: &cli::GlobalArgs,
    resolved: &ResolvedConfig,
) -> Result<()> {
    let args = config::resolve_module_with_config(&cli_args, resolved);
    let scan_opts = ScanOptions::from(global);

    let progress = Progress::new(!global.no_progress);
    progress.set_message("Scanning codebase...");
    let languages = scan::scan(&args.paths, &scan_opts)?;
    let strip_prefix = single_scan_root_strip_prefix(&args.paths);
    let file_rows = model::collect_file_rows(
        &languages,
        &args.module_roots,
        args.module_depth,
        args.children,
        strip_prefix,
    );
    let report = model::create_module_report_from_rows(
        &file_rows,
        &args.module_roots,
        args.module_depth,
        args.children,
        args.top,
    );
    // Clear the stderr spinner before the report is written to stdout.
    progress.finish_and_clear();

    format::print_module_report(&report, &scan_opts, &args)?;
    Ok(())
}