ufftools 0.1.0

reader/writer and inspect CLI for the UFF character package format. includes the uff decoder lib for use in other projects.
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

mod tools;

use std::{fs, process};
use clap::{Parser, Subcommand};
use ufftools::write_uff;

#[derive(Parser)]
#[command(name = "uff-tools", about = "Work with .uff character packages", version)]
struct Args {
    #[command(subcommand)]
    command: Command,
}

#[derive(Subcommand)]
enum Command {
    /// Inspect a .uff file
    Inspect {
        /// Path to the .uff file
        file: String,
        /// Show full frame and hitbox data for every animation
        #[arg(short, long)]
        verbose: bool,
        /// Restrict output to a single animation by name
        #[arg(short, long, value_name = "NAME")]
        anim: Option<String>,
    },
    /// Write a sample .uff fixture to a file
    Generate {
        /// Output path for the generated .uff file
        file: String,
    },
}

// ── subcommand handlers ──────────────────────────────────────────────────────

fn generate_package(file: &str) {
    let pkg = tools::gen_fixture::generate_fixture();
    let data = write_uff(&pkg).unwrap_or_else(|e| {
        eprintln!("error: failed to encode package: {e}");
        process::exit(1);
    });
    fs::write(file, &data).unwrap_or_else(|e| {
        eprintln!("error: cannot write to \"{file}\": {e}");
        process::exit(1);
    });
    println!("wrote {} bytes to {file}", data.len());
}

// ── main ─────────────────────────────────────────────────────────────────────

fn main() {
    let args = Args::parse();
    match args.command {
        Command::Inspect { file, verbose, anim } => {
            tools::inspect::inspect_package(&file, verbose, anim.as_deref());
        }
        Command::Generate { file } => {
            generate_package(&file);
        }
    }
}