Struct FileHandler 

pub struct FileHandler;

Implementations

impl FileHandler

pub fn save<T: Serialize>( data: &[T], format: &FileFormat, filename_prefix: &str, ) -> Result<String>

Save data to a file in the data directory.

Files are saved to the data/ directory (created if it doesn’t exist) with a timestamp in the filename.

Arguments

• data - Data to save (must implement Serialize)
• format - File format to save as (FileFormat::Json for JSON or FileFormat::Csv for CSV)
• filename_prefix - Prefix for the filename. The final filename will be {prefix}_{timestamp}.{extension}

Errors

• std::io::Error - If the file cannot be opened or written to, or if the data directory cannot be created
• serde_json::Error - If the JSON cannot be serialized

Returns

• Result<String> - Full path to the saved file (e.g., data/recent_tracks_20240101_120000.json)

pub fn append<T: Serialize + for<'de> Deserialize<'de> + Clone>( data: &[T], file_path: &str, ) -> Result<String>

Append data to an existing file.

Arguments

• data - Data to append
• file_path - Path to the file to append to

Returns

• Result<String> - Path of the updated file

Append data to an existing file.

Arguments

• data - Data to append
• file_path - Path to the file to append to

Errors

• std::io::Error - If an I/O error occurs

Returns

• Result<String> - Path of the updated file

pub fn save_single<T: Serialize>(data: &T, filename: &str) -> Result<()>

Save a single item to a JSON file

Errors

• std::io::Error - If there was an error reading or writing the file
• serde_json::Error - If there was an error serializing the data

Arguments

• data - Data to save
• filename - Filename to save as