#pkg #archive #sync #read #seek #write #sil

nightly no-std silpkg

A library for working with SIL's PKG archives

1 unstable release

0.1.3 Feb 8, 2025
0.1.2 Jan 12, 2025
0.1.1 Dec 13, 2024
0.1.0 Dec 8, 2024

#260 in Compression

Download history 195/week @ 2024-12-07 79/week @ 2024-12-14 1/week @ 2024-12-21 2/week @ 2025-01-04 128/week @ 2025-01-11 12/week @ 2025-01-18 4/week @ 2025-02-01 129/week @ 2025-02-08

149 downloads per month

GPL-3.0-or-later

88KB
2K SLoC

silpkg

silpkg is a library for interacting with SIL PKG files.

Documentation for the library can be generated through rustdoc (cargo doc). The main entry point to the library is silpkg::sync::Pkg which allows for reading and writing archives backed by a Read + Seek (+ Write (+ silpkg::sync::Truncate)) type.

CLI

A CLI that allows performing basic operations on archives is also included and can be easily installed with cargo install --git https://github.com/afishhh/silpkg cli.

MSRV

Nightly rust is required to use this library. This is because I experimented with using Rust's Coroutines for IO agnostic parsing logic.

no_std

While the crate will build without std, it still depends on alloc and since std::io is absent the only way to actually use the library is through the silpkg::base module with the unstable_base feature. Theoretically a slice-backed Pkg could be implemented to allow for easy no_std use, although currently I have too little time (and see little reason) to do this myself. For implementing your own IO frontend for the silpkg::base module, look at how silpkg::sync::Pkg is currently implemented.

License

silpkg itself is licensed under the GNU General Public License 3.0, silpkg-macros in the macros/ directory is licensed under MIT OR Apache-2.0.

Dependencies

~1.4–2MB
~37K SLoC