stash

Author: randoragon

src/id3_helpers.rs

@@ -19,15 +19,35 @@ use id3::frame::{Comment, Lyrics, ExtendedText, ExtendedLink};
 use std::io::empty;
 use std::path::Path;
 
-/// Convenience wrapper for getting any simple text content.
-pub fn get_content_text(frame: &Frame) -> Result<&str> {
-    match frame.content().text() {
-        Some(x) => Ok(x),
-        None => Err(anyhow!("Frame claims to be {} with T but has no text content: {frame:?}", frame.id())),
+#[derive(Debug)]
+pub enum FrameIdCompliance {
+    Declared,
+    Compliant,
+    Invalid,
+}
+
+/// Returns whether a frame ID is compliant with the ID3v2.2 standard.
+pub fn id_is_id3v2_2(id: &str) -> bool {
+    match id {
+        // https://web.archive.org/web/20150214031143/http://id3.org/id3v2-00
+        "BUF" | "CNT" | "COM" | "CRA" | "CRM" | "EQU" | "MLL" | "POP" |
+        "RVA" | "STC" | "TBP" | "TCM" | "TCO" | "TCR" | "TDA" | "TDY" |
+        "TEN" | "TFT" | "TIM" | "TKE" | "TLA" | "TLE" | "TMT" | "TOA" |
+        "TOF" | "TOL" | "TOR" | "TOT" | "TP1" | "TP2" | "TP3" | "TP4" |
+        "TPA" | "TPB" | "TRC" | "TRD" | "TRK" | "TSI" | "TSS" | "TT1" |
+        "TT2" | "TT3" | "TXT" | "TXX" | "TYE" | "ULT" | "WAR" | "WAS" |
+        "WCM" | "WCP" | "WPB" => true,
+
+        // ID3v2.2 URL frames have names "W00" - "WZZ", excluding "WXX".
+        // "WXX", on the other hand, is a user-defined URL link frame.
+        str if str.starts_with('W') && str[2..].chars().all(
+            |c| c.is_ascii_uppercase() || c.is_ascii_digit()
+        ) => true,
+
+        _ => false,
     }
 }
 
-/// Convenience wrapper for getting any link content.
 pub fn get_content_link(frame: &Frame) -> Result<&str> {
     match frame.content().link() {
         Some(x) => Ok(x),