Function read_version

pub fn read_version(
    journals: &mut Vec<Journal>,
    aim_path: &Path,
    version: u32,
) -> Result<String>

Reads the contents of a specific version of an AIM file based on its journal entries.

This function retrieves the content of a specific version in an AIM file by using the journal entries to locate and read from the appropriate byte positions. It reads from the start position of the requested version up to (but not including) the start position of the next version, or to the end of the file if it’s the latest version.

Arguments

• journals - A mutable reference to a vector that will be populated with journal entries. This vector is cleared and populated with entries from the journal file.
• aim_path - The path to the AIM file from which to read the specific version content.
• version - The epoch number of the version to read. This corresponds to the major version number in the AIM file’s version headers (e.g., [1], [2], etc.)

Returns

• Ok(String) - The content of the specified version as a String
• Err - An error if the file cannot be read, if the requested version is not found, or if there are UTF-8 conversion issues

Errors

This function will return an error in the following cases:

• The AIM file cannot be opened or read
• The journal file cannot be loaded or parsed
• The requested version is not found in the journal entries
• UTF-8 conversion fails when reading the file content

Examples

use std::path::Path;
use aimx::aim::{Journal, journal_load, read_version};

let mut journals = Vec::new();
let path = Path::new("workflow.aim");

// Load existing journal entries
journal_load(&mut journals, path)?;

// Read a specific version (e.g., version 2)
let version_content = read_version(&mut journals, path, 2)?;
println!("Version 2 content: {}", version_content);