rel: v0.2.0

wcampbell0x2a · wcampbell0x2a · commit 390ce43fceb4 · 2026-05-06T21:58:55.000-04:00
* Add looking up single mac address
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "arpbox"
-version = "0.1.0"
+version = "0.2.0"
 edition = "2024"
 authors = ["wcampbell"]
 description = "Enrich ARP data with device information from NetBox"
diff --git a/README.md b/README.md
@@ -41,7 +41,12 @@ This uses the `Bearer nbt_<key>.<token>` authorization header.
 
 ### Run
 
-Pipe arp-scan into arpbox.
+Look up a single MAC address:
+```console
+$ arpbox 00:11:22:33:44:55
+```
+
+Or pipe arp-scan into arpbox:
 ```console
 $ arp-scan --localnet | arpbox
 ```
diff --git a/src/main.rs b/src/main.rs
@@ -94,6 +94,70 @@ fn lookup_mac(
     result
 }
 
+fn lookup_mac_verbose(
+    client: &reqwest::blocking::Client,
+    config: &Config,
+    mac: &str,
+) -> Result<Option<String>, String> {
+    let url = format!(
+        "{}/api/dcim/interfaces/?mac_address={}",
+        config.netbox_url.trim_end_matches('/'),
+        mac
+    );
+
+    let auth = match &config.netbox_key {
+        Some(key) => format!("Bearer nbt_{}.{}", key, config.netbox_token),
+        None => format!("Token {}", config.netbox_token),
+    };
+
+    let resp = client
+        .get(&url)
+        .header("Authorization", &auth)
+        .header("Accept", "application/json")
+        .send()
+        .map_err(|e| format!("request failed: {}", e))?;
+
+    if !resp.status().is_success() {
+        return Err(format!("HTTP {}: {}", resp.status(), resp.status().canonical_reason().unwrap_or("unknown")));
+    }
+
+    let body: NetBoxResponse = resp
+        .json()
+        .map_err(|e| format!("failed to parse response: {}", e))?;
+
+    let iface = match body.results.into_iter().next() {
+        Some(i) => i,
+        None => return Ok(None),
+    };
+
+    let device_url = match &iface.device {
+        Some(d) => &d.url,
+        None => return Ok(None),
+    };
+
+    let resp = client
+        .get(device_url)
+        .header("Authorization", &auth)
+        .header("Accept", "application/json")
+        .send()
+        .map_err(|e| format!("device request failed: {}", e))?;
+
+    if !resp.status().is_success() {
+        return Err(format!("device HTTP {}: {}", resp.status(), resp.status().canonical_reason().unwrap_or("unknown")));
+    }
+
+    let device: NetBoxDeviceFull = resp
+        .json()
+        .map_err(|e| format!("failed to parse device response: {}", e))?;
+
+    let name = match device.asset_tag {
+        Some(tag) => format!("{}:{}:{}", device.name, tag, iface.name),
+        None => format!("{}:{}", device.name, iface.name),
+    };
+
+    Ok(Some(name))
+}
+
 fn main() {
     let config = match load_config() {
         Ok(c) => c,
@@ -104,6 +168,21 @@ fn main() {
     };
 
     let client = reqwest::blocking::Client::new();
+
+    let args: Vec<String> = std::env::args().collect();
+    if args.len() == 2 {
+        let mac = &args[1];
+        match lookup_mac_verbose(&client, &config, mac) {
+            Ok(Some(device)) => println!("(netbox://{})", device),
+            Ok(None) => println!("No device found for {}", mac),
+            Err(e) => {
+                eprintln!("Error: {}", e);
+                std::process::exit(1);
+            }
+        }
+        return;
+    }
+
     let mut cache: HashMap<String, Option<String>> = HashMap::new();
     let stdin = io::stdin();
 
