dkit 1.5.0

A unified CLI to convert, query, and explore data across formats
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

// build.rs — Generate man pages for dkit and its subcommands using clap_mangen.
//
// Man pages are written to $OUT_DIR/man/ during `cargo build`.
// To install them, copy the generated .1 files to a man page directory
// (e.g. /usr/local/share/man/man1/).

#[path = "src/cli.rs"]
mod cli;

use clap::CommandFactory;
use std::fs;
use std::path::PathBuf;

fn main() {
    // Use a larger stack thread to avoid stack overflow on Windows (default 1MB).
    let builder = std::thread::Builder::new().stack_size(8 * 1024 * 1024);
    let handler = builder
        .spawn(generate_man_pages)
        .expect("failed to spawn thread");
    handler.join().unwrap();
}

fn generate_man_pages() {
    let out_dir = PathBuf::from(std::env::var_os("OUT_DIR").unwrap());
    let man_dir = out_dir.join("man");
    fs::create_dir_all(&man_dir).expect("failed to create man directory");

    let cmd = cli::Cli::command();

    // Generate man page for the top-level command
    let man = clap_mangen::Man::new(cmd.clone());
    let mut buf = Vec::new();
    man.render(&mut buf).expect("failed to render man page");
    fs::write(man_dir.join("dkit.1"), buf).expect("failed to write dkit.1");

    // Generate man pages for each subcommand
    for sub in cmd.get_subcommands() {
        let sub_name = sub.get_name().to_owned();
        let filename = format!("dkit-{sub_name}.1");
        let man = clap_mangen::Man::new(sub.clone());
        let mut buf = Vec::new();
        man.render(&mut buf).expect("failed to render man page");
        fs::write(man_dir.join(&filename), buf)
            .unwrap_or_else(|_| panic!("failed to write {filename}"));
    }

    // Write the man directory path so the binary can reference it if needed
    println!("cargo:rustc-env=DKIT_MAN_DIR={}", man_dir.display());
}