From bb088e7665f0a477bc5804a5f540a6d332ae9621 Mon Sep 17 00:00:00 2001
From: widberg <widberg@widberg.me>
Date: Fri, 7 Aug 2026 14:15:02 -0400
Subject: [PATCH] Add cargo script example for the TSC executor

---
 Cargo.lock                         |  1 +
 bff/Cargo.toml                     |  1 +
 bff/examples/fuel_dump_vehicles.rs | 68 ++++++++++++++++++++++++++++++
 justfile                           |  4 +-
 4 files changed, 72 insertions(+), 2 deletions(-)
 create mode 100644 bff/examples/fuel_dump_vehicles.rs

diff --git a/Cargo.lock b/Cargo.lock
index e5d0b88..af2a2fd 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -111,6 +111,7 @@ dependencies = [
  "bff-derive",
  "bilge",
  "binrw",
+ "clap",
  "datatest",
  "ddsfile",
  "derive_aliases",
diff --git a/bff/Cargo.toml b/bff/Cargo.toml
index d72cfc5..deaaed2 100644
--- a/bff/Cargo.toml
+++ b/bff/Cargo.toml
@@ -31,6 +31,7 @@ serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"
 
 [dev-dependencies]
+clap = { version = "4.5.60", features = ["derive"] }
 datatest = { git = "https://github.com/widberg/datatest.git", branch = "main" }
 mimalloc = { version = "0.1.48", features = ["v3"] }
 
diff --git a/bff/examples/fuel_dump_vehicles.rs b/bff/examples/fuel_dump_vehicles.rs
new file mode 100644
index 0000000..ce8cedf
--- /dev/null
+++ b/bff/examples/fuel_dump_vehicles.rs
@@ -0,0 +1,68 @@
+#!/usr/bin/env -S cargo +nightly -Zscript
+---
+[package]
+edition = "2024"
+
+[dependencies]
+bff = { path = ".." }
+clap = { version = "4.5.60", features = ["derive"] }
+---
+
+#![allow(duplicate_features)]
+#![feature(frontmatter)]
+
+use std::collections::BTreeMap;
+use std::path::PathBuf;
+
+use bff::tsc::{AsoboExecutor, FileSystemScriptLoader};
+use clap::Parser;
+
+#[derive(Parser)]
+#[command(about = "List FUEL vehicles and their English translation strings")]
+struct Arguments {
+    /// FUEL root directory, containing `user.tsc` and `trtext/tt01.pc`.
+    root: PathBuf,
+}
+
+struct Vehicle {
+    mesh_name: String,
+    tt_id: u32,
+}
+
+#[derive(Default)]
+struct DumpData {
+    translations: BTreeMap<u32, String>,
+    vehicles: Vec<Vehicle>,
+}
+
+fn main() {
+    let arguments = Arguments::parse();
+    let mut executor = AsoboExecutor::with_user_data(
+        FileSystemScriptLoader::new(arguments.root),
+        DumpData::default(),
+    );
+    executor.set_variable("_PC");
+    executor.set_variable("_MASTER");
+    executor.set_variable("_BIGFILE");
+    executor.on_command("TransText", |executor, command| {
+        let id = command.arguments[0].string.parse().unwrap();
+        let text = command.arguments[1].string.clone();
+        executor.user_data_mut().translations.insert(id, text);
+        Ok(())
+    });
+    executor.on_command("AddVehicleInfo", |executor, command| {
+        executor.user_data_mut().vehicles.push(Vehicle {
+            mesh_name: command.arguments[0].string.clone(),
+            tt_id: command.arguments[5].string.parse().unwrap(),
+        });
+        Ok(())
+    });
+    executor.execute_file("trtext/tt01.pc").unwrap();
+    executor.execute_file("user.tsc").unwrap();
+
+    let data = executor.into_user_data();
+    for vehicle in data.vehicles {
+        let translation = data.translations.get(&vehicle.tt_id).unwrap().as_str();
+        println!("{}\t{}\t{}", vehicle.mesh_name, vehicle.tt_id, translation);
+    }
+}
diff --git a/justfile b/justfile
index 458f98d..cd9e675 100644
--- a/justfile
+++ b/justfile
@@ -13,10 +13,10 @@ fmt:
     just --fmt --unstable
 
 clippy:
-    cargo +nightly clippy --tests
+    cargo +nightly clippy --tests --examples
 
 check:
-    cargo +nightly check --tests
+    cargo +nightly check --tests --examples
 
 deny:
     cargo deny check