From 43774fe580b3c99112886a4071d86319b988fd10 Mon Sep 17 00:00:00 2001
From: phoenix <kundeng00@pm.me>
Date: Fri, 18 Apr 2025 00:37:42 +0000
Subject: [PATCH] Cover art code (#21)

Reviewed-on: https://git.kundeng.us/phoenix/icarus_meta/pulls/21
Co-authored-by: phoenix <kundeng00@pm.me>
Co-committed-by: phoenix <kundeng00@pm.me>
---
 src/meta.rs                                   | 158 ++++++++++++++++++
 .../Sample Tracks 3 - Other one.png           | Bin 0 -> 9627 bytes
 2 files changed, 158 insertions(+)
 create mode 100644 tests/sample_tracks3/Sample Tracks 3 - Other one.png

diff --git a/src/meta.rs b/src/meta.rs
index 234ff50..2c9443f 100644
--- a/src/meta.rs
+++ b/src/meta.rs
@@ -15,6 +15,81 @@ fn get_type(t: types::Type) -> Result<String, std::io::Error> {
     }
 }
 
+pub mod coverart {
+
+    use lofty::{file::AudioFile, ogg::OggPictureStorage};
+
+    pub fn set_coverart(
+        song_filepath: &String,
+        coverart_filepath: &String,
+    ) -> Result<Vec<u8>, std::io::Error> {
+        let coverart_path = std::path::Path::new(coverart_filepath);
+
+        match std::fs::File::open(song_filepath) {
+            Ok(mut file) => {
+                match lofty::flac::FlacFile::read_from(
+                    &mut file,
+                    lofty::config::ParseOptions::new(),
+                ) {
+                    Ok(mut flac_file) => {
+                        let mut coverart_file = std::fs::File::open(coverart_path).unwrap();
+                        match lofty::picture::Picture::from_reader(&mut coverart_file) {
+                            Ok(pic) => {
+                                match lofty::picture::PictureInformation::from_picture(&pic) {
+                                    Ok(info) => {
+                                        flac_file.set_picture(0, pic.clone(), info);
+                                        Ok(pic.into_data())
+                                    }
+                                    Err(err) => Err(std::io::Error::new(
+                                        std::io::ErrorKind::InvalidData,
+                                        err.to_string(),
+                                    )),
+                                }
+                            }
+                            Err(err) => Err(std::io::Error::new(
+                                std::io::ErrorKind::InvalidData,
+                                err.to_string(),
+                            )),
+                        }
+                    }
+                    Err(err) => Err(std::io::Error::new(
+                        std::io::ErrorKind::InvalidData,
+                        err.to_string(),
+                    )),
+                }
+            }
+            Err(err) => Err(err),
+        }
+    }
+
+    pub fn get_coverart(song_filepath: &String) -> Result<Vec<u8>, std::io::Error> {
+        match std::fs::File::open(song_filepath) {
+            Ok(mut file) => {
+                match lofty::flac::FlacFile::read_from(
+                    &mut file,
+                    lofty::config::ParseOptions::new(),
+                ) {
+                    Ok(flac_file) => {
+                        let pictures = flac_file.pictures();
+                        let res = pictures.to_vec();
+                        if !res.is_empty() {
+                            let picture = &res[0];
+                            Ok(picture.clone().0.into_data())
+                        } else {
+                            Ok(Vec::new())
+                        }
+                    }
+                    Err(err) => Err(std::io::Error::new(
+                        std::io::ErrorKind::InvalidData,
+                        err.to_string(),
+                    )),
+                }
+            }
+            Err(err) => Err(err),
+        }
+    }
+}
+
 pub fn get_meta(t: types::Type, filepath: &String) -> Result<String, std::io::Error> {
     match std::fs::File::open(filepath) {
         Ok(mut content) => {
@@ -109,6 +184,19 @@ mod tests {
     use super::*;
 
     mod util {
+
+        use std::io::{self, Write};
+
+        // Function to save a Vec<u8> to a file
+        pub fn save_bytes_to_file(bytes: &[u8], file_path: &String) -> io::Result<()> {
+            let file = std::path::Path::new(file_path);
+            let mut file = std::fs::File::create(file)?;
+
+            match file.write_all(bytes) {
+                Ok(_res) => Ok(()),
+                Err(err) => Err(err),
+            }
+        }
         pub fn get_full_path(
             directory: &String,
             filename: &String,
@@ -787,4 +875,74 @@ mod tests {
             };
         }
     }
+
+    mod pictures {
+
+        use super::*;
+
+        #[test]
+        fn test_get_picture() {
+            let filename = util::get_filename(1);
+            let dir = String::from(util::TESTFILEDIRECTORY);
+
+            let temp_file = tempfile::tempdir().expect("Could not create test directory");
+            let test_dir = String::from(temp_file.path().to_str().unwrap());
+
+            match file_exists(&dir, &filename) {
+                Ok(_) => {
+                    let filepath = get_full_path(&dir, &filename).unwrap();
+
+                    match coverart::get_coverart(&filepath) {
+                        Ok(coverart) => {
+                            let is_empty = coverart.is_empty();
+                            assert_eq!(is_empty, false, "Should not be empty");
+
+                            let mut new_coverart_path: String = test_dir.clone();
+                            new_coverart_path += &String::from("/newcovvv.png");
+                            let _ = util::save_bytes_to_file(&coverart, &new_coverart_path);
+                            let created_file = std::path::Path::new(&new_coverart_path);
+                            assert!(
+                                created_file.exists(),
+                                "Error: {:?} has not been created",
+                                new_coverart_path
+                            );
+                        }
+                        Err(err) => {
+                            assert!(false, "Error: {:?}", err.to_string());
+                        }
+                    }
+                }
+                Err(err) => {
+                    assert!(false, "Error: File does not exist {:?}", err.to_string());
+                }
+            };
+        }
+
+        #[test]
+        fn test_set_picture() {
+            let filename = util::get_filename(1);
+            let dir = String::from(util::TESTFILEDIRECTORY);
+
+            let new_coverart = String::from("Sample Tracks 3 - Other one.png");
+            let new_cover_art_path = get_full_path(&dir, &new_coverart).unwrap();
+
+            match file_exists(&dir, &filename) {
+                Ok(_) => {
+                    let filepath = get_full_path(&dir, &filename).unwrap();
+
+                    match coverart::set_coverart(&filepath, &new_cover_art_path) {
+                        Ok(bytes) => {
+                            assert_eq!(false, bytes.is_empty(), "This should not be empty");
+                        }
+                        Err(err) => {
+                            assert!(false, "Error: {:?}", err);
+                        }
+                    }
+                }
+                Err(err) => {
+                    assert!(false, "Error: File does not exist {:?}", err.to_string());
+                }
+            };
+        }
+    }
 }
diff --git a/tests/sample_tracks3/Sample Tracks 3 - Other one.png b/tests/sample_tracks3/Sample Tracks 3 - Other one.png
new file mode 100644
index 0000000000000000000000000000000000000000..fd550def0284148d6d2d82fcd7a0e6877dcf5988
GIT binary patch
literal 9627
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
TD1ZC+`j7hkhsvMO7P$WhA2;fY

literal 0
HcmV?d00001