#pkg #archive #sync #seek #write #entry #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 95/week @ 2024-12-04 171/week @ 2024-12-11 9/week @ 2024-12-18 118/week @ 2025-01-08 24/week @ 2025-01-15 127/week @ 2025-02-05 33/week @ 2025-02-12 10/week @ 2025-02-19 13/week @ 2025-02-26

183 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.3–2MB
~37K SLoC