4 releases
0.2.9 | Apr 23, 2021 |
---|---|
0.2.8 | Apr 9, 2021 |
0.2.5 |
|
0.2.2 |
|
0.2.1 |
|
#90 in Compression
8,710 downloads per month
Used in 7 crates
(2 directly)
375KB
7.5K
SLoC
Cf-Zlib
This is Rust wrapper for Cloudflare's SIMD-accelerated fork of zlib.
It requires x86-64 CPU with SSE 4.2 or ARM64 with NEON & CRC. It does not support 32-bit CPUs at all.
Note: you will have to ensure that the program using cloudflare-zlib
does not link with any other version of libz
. Otherwise the accelerated version may not be used, or the program could even crash. Because of a Cargo issue this crate doesn't prevent this problem.
ARM vs Nightly Rust
- If
arm-always
feature is set (build with--features=arm-always
), ARM will be supported on Rust stable, but without a runtime check (i.e. it will crash if run on an unsupported ARM CPU). - If
arm-conditional
feature is set, ARM will be supported, and will fail gracefully on an incompatible CPU. However, the check requires (as of Rust 1.51) a nightly version of Rust. - Support for x86-64 works fully out of the box on Rust stable.
Example
extern crate cloudflare_zlib;
use cloudflare_zlib::*;
let mut stream = Deflate::new(Z_BEST_COMPRESSION, Z_DEFAULT_STRATEGY, 15)?;
stream.compress(b"lorem")?;
stream.compress(b" ipsum")?;
let compressed = stream.finish()?;
Cloning
This repository uses git submodules, so when cloning make sure to add --recursive
git clone --recursive https://gitlab.com/kornelski/cloudflare-zlib-sys
If you cloned without --recursive
you can fix it with:
git submodule update --init
Licenses
Zlib
(C) 1995-2017 Jean-loup Gailly and Mark Adler
This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.
Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:
- The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
- Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
- This notice may not be removed or altered from any source distribution.
Jean-loup Gailly jloup@gzip.org Mark Adler madler@alumni.caltech.edu
If you use the zlib library in a product, we would appreciate not receiving lengthy legal documents to sign. The sources are provided for free but without warranty of any kind. The library has been entirely written by Jean-loup Gailly and Mark Adler; it does not include third-party code.
If you redistribute modified sources, we would appreciate that you include in the file ChangeLog history information documenting your changes. Please read the FAQ for more information on the distribution of modified source versions.
libz-sys
This project is licensed under either of
at your option.