3 unstable releases
0.2.1 | Aug 16, 2023 |
---|---|
0.2.0 | Jun 27, 2023 |
0.1.0 | Jun 23, 2023 |
#404 in Compression
86 downloads per month
Used in 2 crates
14KB
260 lines
bsatool_rs
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
~295–760KB
~18K SLoC