- C 63%
- Rust 32.2%
- C++ 4.5%
- Shell 0.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Reynard User
a7f1ed3e4e
Some checks failed
CI tests / TestSerde (push) Has been cancelled
CI tests / Test (push) Has been cancelled
CI tests / Test-1 (push) Has been cancelled
CI tests / Test-2 (push) Has been cancelled
CI tests / Test-3 (push) Has been cancelled
CI tests / Test-4 (push) Has been cancelled
CI tests / Test-5 (push) Has been cancelled
CI tests / TestB (push) Has been cancelled
CI tests / WebAssembly (push) Has been cancelled
CI tests / WebAssembly-1 (push) Has been cancelled
|
||
| .github/workflows | ||
| benches | ||
| examples | ||
| fuzz | ||
| miniz | ||
| miniz_oxide | ||
| miniz_oxide_test | ||
| miniz_stub | ||
| src | ||
| tests | ||
| .gitattributes | ||
| .gitignore | ||
| .travis.yml | ||
| build.sh | ||
| build_orig_miniz.sh | ||
| Cargo.toml | ||
| cbindgen.toml | ||
| CHANGELOG.md | ||
| cliff.toml | ||
| clippy.toml | ||
| LICENSE-MIT.md | ||
| miniz.h | ||
| miniz_extra_defs.h | ||
| miniz_zip.h | ||
| performance.sh | ||
| README.md | ||
| redefine.txt | ||
| run_fuzz.sh | ||
| test.sh | ||
| travis-after-success.sh | ||
Main library 
C API 
miniz_oxide
Pure rust replacement for the miniz deflate/zlib encoder/decoder using no unsafe code. Builds in no_std mode, though requires the use of alloc and collections crates or preallocated memory slices.
This project is organized into a C API shell and a rust crate. The Rust crate is found in the miniz_oxide subdirectory. See the subdirectory for the full README.
For a friendlier streaming API using readers and writers, flate2 can be used, which can use miniz_oxide as a rust-only back-end.
IMPORTANT! Versions prior to 0.8.4 have a massive regression in compression performance in versions of rust 1.81 and newer due to a upstream regression. If miniz_oxide is part of your dependencies, please update to the latest version to avoid performance regressions!
miniz_oxide_C_API
The C API is intended to replicate the API exported from miniz, and in turn also part of zlib. The C header is generated using cbindgen. The current implementation has not seen a lot of testing outside of automated tests, is a bit weak in documentation and should be seen as experimental.
The data structures do not share the exact same layout that is specified in miniz.h (from the original miniz), and should thus be allocated via the included functions.
API documentation
TODO
Testing
$ cargo test
$ ./test.sh
Including in C/C++ projects
Link against the libminiz_oxide_c_api.a generated by build.sh. The generated header that can be used is miniz.h (using the original miniz headers may or may not work), which currently also uses miniz_extra_defs.h for some static definitions.
Cargo-fuzz testing
Install fuzzer:
$ cargo install cargo-fuzz
Currently the inflate_nonwrapping and roundtrip_target fuzz targets work
$ cargo +nightly fuzz run inflate_nonwrapping
License
This library (excluding the original miniz C code used for tests) is dual licensed under the MIT license and Apache 2.0 license. The library is based on the miniz C library by Rich Geldreich which is released under the MIT license.