exiftool-rs 0.5.0

Read, write, and edit metadata in 93 file formats — a pure Rust reimplementation of ExifTool 13.53 with 100% tag name parity (194/194 test 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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

//! FLAC metadata writer — update Vorbis comments block.

use crate::error::{Error, Result};

pub fn write_flac(source: &[u8], changes: &[(&str, &str)]) -> Result<Vec<u8>> {
    if source.len() < 8 || !source.starts_with(b"fLaC") {
        return Err(Error::InvalidData("not a FLAC file".into()));
    }
    let mut output = Vec::with_capacity(source.len());
    output.extend_from_slice(b"fLaC");
    let mut pos = 4;
    let mut _wrote_comments = false;

    loop {
        if pos + 4 > source.len() {
            break;
        }
        let header = source[pos];
        let is_last = (header & 0x80) != 0;
        let block_type = header & 0x7F;
        let block_size = ((source[pos + 1] as usize) << 16)
            | ((source[pos + 2] as usize) << 8)
            | source[pos + 3] as usize;
        pos += 4;
        if pos + block_size > source.len() {
            break;
        }

        if block_type == 4 && !changes.is_empty() {
            // Replace Vorbis comment block
            let new_block = build_vorbis_comments(&source[pos..pos + block_size], changes);
            let new_header = if is_last { 0x84 } else { 0x04 };
            output.push(new_header);
            output.push(((new_block.len() >> 16) & 0xFF) as u8);
            output.push(((new_block.len() >> 8) & 0xFF) as u8);
            output.push((new_block.len() & 0xFF) as u8);
            output.extend_from_slice(&new_block);
            _wrote_comments = true;
        } else {
            output.push(header);
            output.push(((block_size >> 16) & 0xFF) as u8);
            output.push(((block_size >> 8) & 0xFF) as u8);
            output.push((block_size & 0xFF) as u8);
            output.extend_from_slice(&source[pos..pos + block_size]);
        }
        pos += block_size;
        if is_last {
            break;
        }
    }

    // Append remaining data (audio frames)
    if pos < source.len() {
        output.extend_from_slice(&source[pos..]);
    }

    Ok(output)
}

fn build_vorbis_comments(existing: &[u8], changes: &[(&str, &str)]) -> Vec<u8> {
    let mut comments: Vec<(String, String)> = Vec::new();

    // Parse existing comments
    if existing.len() >= 8 {
        let vendor_len =
            u32::from_le_bytes([existing[0], existing[1], existing[2], existing[3]]) as usize;
        let mut p = 4 + vendor_len;
        if p + 4 <= existing.len() {
            let num = u32::from_le_bytes([
                existing[p],
                existing[p + 1],
                existing[p + 2],
                existing[p + 3],
            ]);
            p += 4;
            for _ in 0..num {
                if p + 4 > existing.len() {
                    break;
                }
                let clen = u32::from_le_bytes([
                    existing[p],
                    existing[p + 1],
                    existing[p + 2],
                    existing[p + 3],
                ]) as usize;
                p += 4;
                if p + clen > existing.len() {
                    break;
                }
                let comment =
                    crate::encoding::decode_utf8_or_latin1(&existing[p..p + clen]).to_string();
                if let Some(eq) = comment.find('=') {
                    comments.push((comment[..eq].to_string(), comment[eq + 1..].to_string()));
                }
                p += clen;
            }
        }
    }

    // Apply changes
    for &(key, value) in changes {
        let upper = key.to_uppercase();
        if let Some(existing) = comments.iter_mut().find(|(k, _)| k.to_uppercase() == upper) {
            existing.1 = value.to_string();
        } else {
            comments.push((key.to_uppercase(), value.to_string()));
        }
    }

    // Build output
    let mut out = Vec::new();
    let vendor = b"exiftool-rs";
    out.extend_from_slice(&(vendor.len() as u32).to_le_bytes());
    out.extend_from_slice(vendor);
    out.extend_from_slice(&(comments.len() as u32).to_le_bytes());
    for (k, v) in &comments {
        let comment = format!("{}={}", k, v);
        let bytes = comment.as_bytes();
        out.extend_from_slice(&(bytes.len() as u32).to_le_bytes());
        out.extend_from_slice(bytes);
    }
    out
}