Update (#560)

Update:
 * add decoder API to avoid ringbuffer reallocation
 * fix MSVC warnings
 * remove dead code
9 files changed
tree: 452a38544c2107493ad0ff5cb92545991748f5ab
  1. c/
  2. csharp/
  3. docs/
  4. go/
  5. java/
  6. python/
  7. research/
  8. scripts/
  9. tests/
  10. .gitignore
  11. .gitmodules
  12. .travis.yml
  13. BUILD
  14. CMakeLists.txt
  15. configure
  16. configure-cmake
  17. CONTRIBUTING.md
  18. LICENSE
  19. Makefile
  20. MANIFEST.in
  21. premake5.lua
  22. README.md
  23. setup.cfg
  24. setup.py
  25. WORKSPACE
README.md

Introduction

Brotli is a generic-purpose lossless compression algorithm that compresses data using a combination of a modern variant of the LZ77 algorithm, Huffman coding and 2nd order context modeling, with a compression ratio comparable to the best currently available general-purpose compression methods. It is similar in speed with deflate but offers more dense compression.

The specification of the Brotli Compressed Data Format is defined in RFC 7932.

Brotli is open-sourced under the MIT License, see the LICENSE file.

Brotli mailing list: https://groups.google.com/forum/#!forum/brotli

TravisCI Build Status AppVeyor Build Status

Build instructions

Autotools-style CMake

configure-cmake is an autotools-style configure script for CMake-based projects.

The basic commands to build, test and install brotli are:

$ mkdir out && cd out
$ ../configure-cmake
$ make
$ make test
$ make install

To build static libraries use --disable-shared-libs argument:

$ mkdir out-static && cd out-static
$ ../configure-cmake --disable-shared-libs
$ make install

Bazel

See Bazel

CMake

The basic commands to build, test and install brotli are:

$ mkdir out && cd out
$ cmake ..
$ make
$ make test
$ make install

You can use other CMake configuration. For example, to build static libraries:

$ mkdir out-static && cd out-static
$ cmake .. -DBUILD_SHARED_LIBS=OFF
$ make

Premake5

See Premake5

Python

To install the Python module from source, run the following:

$ python setup.py install

See the Python readme for more details on testing and development.

Benchmarks

Related projects

Independent decoder implementation by Mark Adler, based entirely on format specification.

JavaScript port of brotli decoder. Could be used directly via npm install brotli