A Rust implementation of the Zopfli compression algorithm.
Clone or download
Pull request Compare This branch is 509 commits ahead, 26 commits behind google:master.
Latest commit 1902c61 Dec 7, 2018

README.md

Zopfli in Rust

Build Status

This is a reimplementation of the Zopfli compression tool in Rust.

I have totally ignored zopflipng.

More info about why and how I did this can be found in the slides for a talk I gave about it.

How to build

To build the code, run:

$ cargo build --release

and the executable will be in target/release/zopfli.

This should work on stable or beta Rust.

You can also run make zopfli, which will run cargo build and then symlink target/release/zopfli to just zopfli in the project root; this is what the C library does and it was useful for scripting purposes during the rewrite process to keep the command and resulting artifacts the same.

Running the tests

There are some unit tests, mostly around the boundary package merge algorithm implementation in katajainen.rs, that can be run with:

$ cargo test

Golden master tests, to check that compressed files are exactly the same as the C implementation would generate, can be run using:

$ ./test/run.sh

and then checking that git reports no changes to the files in test/results.

Or you can run make test, which will run cargo test, then ./test/run.sh, and then will fail if there are any changed files according to git. Note that if you have uncommitted changes and you run this, your changes will cause this command to fail, but the tests actually passed.