gfarch 0.3.0

gfarch is a Rust crate for Good-Feel's GoodFeelArchives.
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

# GfArch

Rust crate for handling Good-Feel's [GfArch files](https://swiftshine.github.io/doc/gfa.html).

## Capabilities

### Archive Creation

- [X] Archives with Byte Pair Encoding
- [X] Archives with LZ10

### Archive Extraction

- [X] Archives with Byte Pair Encoding
- [X] Archives with LZ10

## Usage

### Archive Creation

```rust
    // "archive_1" is now a GoodFeelArchive
    let archive_1 = gfarch::pack_from_files(
        &files,
        Version::V3,
        CompressionType::BPE,
        GFCPOffset::Default
    );

    // "archive_2" is now also a GoodFeelArchive
    let archive_2 = gfarch::pack_from_bytes(
        &byte_vectors,
        &filenames,
        Version::V3,
        CompressionType::BPE,
        GFCPOffset::Default
    );

```
### Archive Extraction

```rust
    let archive = fs::read("my_file.gfa")?;
    // "files" is now a collection of file data and filenames
    let files = gfarch::extract(&archive)?;
```


## Notable Dependencies

- [bpe-rs](https://crates.io/crates/bpe-rs/)
    - Byte Pair Encoding
- [nintendo_lz](https://crates.io/crates/nintendo-lz)
    - LZ10/LZ11 compression/decompression