arkive 0.8.13

Immutable archive manipulation library.
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

//! Read files from disk.
//!
//! ```
//! use arkive::*;
//!
//! let ark = Ark::scan("fixture")?.read()?;
//! # Ok::<(), std::io::Error>(())
//! ```

use crate::types::*;
use std::io::Result;
use std::path::PathBuf;
use std::rc::Rc;

impl Ark<PathBuf> {
    /// Fetch file contents from disk into memory.
    ///
    /// Be warned that this may be a very bad idea if the directory is larger
    /// than you have RAM for.
    pub fn read(self) -> Result<Ark<Vec<u8>>> {
        let (paths, attrs, contents) = self.decompose();
        let contents: Result<Vec<Vec<u8>>> = contents.iter().map(|pb| std::fs::read(&pb)).collect();
        Ok(Ark::compose(paths, attrs, Rc::new(contents?)))
    }
}

#[cfg(test)]
mod test {
    use super::*;
    use crate::at;

    #[test]
    fn read() -> Result<()> {
        let ark = Ark::scan("fixture")?.read()?;
        assert_eq!(
            ark.paths(),
            &vec![
                "dir1/dir2/nested.txt",
                "file_at_root.txt",
                "dir1",
                "dir1/dir2",
            ]
        );
        assert_eq!(
            ark.attrs(),
            &vec![
                at! { UNIX_MODE => "33204" },
                at! { UNIX_MODE => "33204" },
                at! { UNIX_MODE => "16893" },
                at! { UNIX_MODE => "16893" },
            ]
        );
        assert_eq!(
            ark.contents(),
            &vec![
                "A file nested under multiple directories\n".into(),
                "Here are some file contents, teehee!\n".into(),
            ] as &Vec<Vec<u8>>
        );
        Ok(())
    }
}