modcrawl 0.5.0

Detect, inspect, and analyze Minecraft mods and plugins from JAR files
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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

use std::collections::BTreeMap;
use std::collections::BTreeSet;
use std::path::PathBuf;

use crate::core::classfile;
use crate::error::Result;
use crate::MixinEntry;

#[derive(clap::Args)]
pub struct Args {
    pub file: Vec<PathBuf>,

    #[arg(
        short = 'q',
        long,
        help = "Only print mixin class names that contain matches"
    )]
    pub quiet: bool,

    #[arg(
        short = 'j',
        long,
        help = "Output as JSON instead of human-readable text"
    )]
    pub json: bool,
}

/// Run the `mixins` command.
///
/// # Errors
///
/// Returns an error if a JAR cannot be read.
pub fn run(args: &Args) -> Result<()> {
    let mut total_entries = 0usize;

    for file in &args.file {
        let entries = match classfile::mixins(file) {
            Ok(e) => e,
            Err(e) => {
                eprintln!("{}: {e:#}", file.display());
                continue;
            }
        };

        if args.json {
            println!("{}", serde_json::to_string_pretty(&entries)?);
            continue;
        }

        if entries.is_empty() {
            continue;
        }

        total_entries += entries.len();

        if args.quiet {
            if args.file.len() > 1 {
                println!("{}:", file.display());
            }
            let mut seen: BTreeSet<&str> = BTreeSet::new();
            for e in &entries {
                seen.insert(e.mixin_class.as_str());
            }
            for class_file in seen {
                println!("  {class_file}");
            }
        } else {
            if args.file.len() > 1 {
                println!("{}:", file.display());
            }
            let mut grouped: BTreeMap<&str, Vec<&MixinEntry>> = BTreeMap::new();
            for e in &entries {
                grouped.entry(e.mixin_class.as_str()).or_default().push(e);
            }
            for (class_file, class_entries) in &grouped {
                println!("  {class_file} ->");
                for e in class_entries {
                    println!("    {}", e.target);
                }
            }
        }
    }

    if total_entries == 0 && !args.file.is_empty() {
        let n = args.file.len();
        eprintln!("No mixins found in {n} file(s).");
    }

    Ok(())
}