3 unstable releases

0.2.1 Aug 16, 2023
0.2.0 Jun 27, 2023
0.1.0 Jun 23, 2023

#506 in Compression

Download history 10/week @ 2024-09-15 25/week @ 2024-09-22 14/week @ 2024-09-29 10/week @ 2024-10-06 48/week @ 2024-10-13 18/week @ 2024-10-20 3/week @ 2024-10-27 16/week @ 2024-11-03 2/week @ 2024-11-10 1/week @ 2024-11-17 9/week @ 2024-11-24 22/week @ 2024-12-01 18/week @ 2024-12-08 13/week @ 2024-12-15 38/week @ 2024-12-22 151/week @ 2024-12-29

225 downloads per month
Used in 2 crates

GPL-3.0 license

14KB
260 lines

bsatool_rs

crates.io cli crates.io lib

A rust implementation of the openmw bsatool.

Note: Currently this project only supports BSA files compatible with TES III: Morrowind.

Install

The easiest way right now is to install with cargo:

cargo install bsatool_rs

Library

There is also a library option for manipulating BSAs from other rust code available on crates.io and can be added to a project with:

cargo add bsatoollib

Example Usage

use bsatoollib as bsa;

// open an existing BSA file
let bsa = bsa::BSAFile::new("SomeFile.BSA").unwrap();

// print all file names in the BSA
for file in bsa.get_list().iter() {
    println!(file.name);
}

Command line options

> bsatool_rs --help
A tool for working with BSA files

Usage: bsatool_rs <FILE> <COMMAND>

Commands:
  list         List the files presents in the given BSA file
  extract      Extract a file from the given BSA file
  extract-all  Extract all files from the given BSA file
  create       Create a new BSA file with given files for archiving
  help         Print this message or the help of the given subcommand(s)

Arguments:
  <FILE>  BSA file to use

Options:
  -h, --help     Print help
  -V, --version  Print version

Licensing

Since bsatool_rs is derivative work of OpenMW's bsatool, it is released under the same license as the openmw code.


lib.rs:

A simple library to using Bethesda BSA files.

Usage

use bsatoollib as bsa;

// open an existing BSA file
let bsa = bsa::BSAFile::new("SomeFile.BSA").unwrap();

// print all file names in the BSA
for file in bsa.get_list().iter() {
    println!(file.name);
}

Dependencies

~235–690KB
~16K SLoC