enfusion_pak 0.2.0

A library/cli for reading Enfusion game engine `.pak` files.
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

use std::path::PathBuf;
use std::sync::Arc;

use async_trait::async_trait;
use enfusion_pak::async_pak_vfs::AsyncReadAt;
use enfusion_pak::error::PakError;
use enfusion_pak::pak_vfs::ReadAt;
use enfusion_pak::vfs::VfsError;
use enfusion_pak::wrappers::bytes::BytesPakFileWrapper;
use memmap2::Mmap;

#[derive(Debug, Clone)]
#[repr(transparent)]
pub struct MmapWrapper(Arc<Mmap>);

#[async_trait]
impl AsyncReadAt for MmapWrapper {
    async fn read_at(
        &self,
        file_range: std::ops::Range<usize>,
    ) -> Result<impl AsRef<[u8]>, VfsError> {
        Ok(&self.0[file_range])
    }
}

impl ReadAt for MmapWrapper {
    fn read_at(&self, file_range: std::ops::Range<usize>) -> Result<impl AsRef<[u8]>, VfsError> {
        Ok(&self.0[file_range])
    }
}

impl AsRef<[u8]> for MmapWrapper {
    fn as_ref(&self) -> &[u8] {
        &self.0
    }
}

pub fn parse_pak_file(path: PathBuf) -> Result<BytesPakFileWrapper<MmapWrapper>, PakError> {
    let file = std::fs::File::open(&path)?;
    let mmap = unsafe { memmap2::Mmap::map(&file)? };

    let parsed_pak = enfusion_pak::PakFile::parse(&mmap)?;

    Ok(BytesPakFileWrapper::new(path, MmapWrapper(Arc::new(mmap)), parsed_pak))
}