Github Actions	Codecov

LZW streaming compressor/decompressor based on LZW AB compatible with UNIX compress.

• Linked list (idea from LZW AB). It has low memory usage <= 327 KB (16 bit codes). It is slow in general, recommended for small amount of data.
• Sparse array (enabled by default). It has high memory usage <= 33.5 MB (16 bit codes). It is fast, recommended for large amount of data.

You can add your own implementation, see api for dictionary.

• You can compress and decompress .Z (tar.Z) archives.
• You can resurrect legacy apis (like Content-Encoding: compress in HTTP 1.1).
• You can support ancient software and make your application looks like ancient software.

• Accurate ratio calculation without overhead, compressor provides smaller archive (compatible with UNIX compress).
• Unaligned bit groups switch (only disabled mode is compatible with UNIX compress).
• LSB/MSB switch (only LSB mode is compatible with UNIX compress).
• Magic header switch (only enabled magic header is compatible with UNIX compress).

Operating systems: GNU/Linux, OSX, FreeBSD, Windows (Visual Studio, MinGW, Cygwin).

• Runtime and compilation dependencies: GMP or TomMath.
• Compilation dependencies: cmake, gcc or clang or msvc, asciidoc, docbook xml 4.5.
• Additional development tools: yq.

You can download and install prebuilt packages on releases page.

You can use scripts/release.sh, it will create package for your system from source. You can also use overlay for gentoo.

Installation for Windows (Visual Studio) from source is not so trivial:

1. Install Visual Studio with components: msvc, windows sdk, ucrt.
2. Install chocolatey with components: cmake, curl, git, python, xsltproc, docbook-bundle, zip, nsis.
3. Install asciidoc.
4. Download docbook-xml-4.5.zip and unpack it to C:\ProgramData\chocolatey\lib\docbook-bundle\docbook-4.5.
5. Edit C:\ProgramData\chocolatey\lib\docbook-bundle\catalog.xml and append <nextCatalog catalog="./docbook-4.5/catalog.xml"/>.
6. Launch x64 Native Tools Command Promp as admin.

git clone "https://github.com/libtom/libtommath.git" --depth 1 && cd "libtommath"
nmake -f "makefile.msvc" install && cd ".."
set "XML_CATALOG_FILES=C:\ProgramData\chocolatey\lib\docbook-bundle\catalog.xml"
set "INCLUDE=C:\devel\include;%INCLUDE%" && set "LIB=C:\devel\lib;%LIB%"
set "PATH=C:\devel\bin;C:\Program Files\Git\bin;C:\Program Files\CMake\bin;%PATH%"
cd build && bash "..\scripts\release.sh"

Please use the following command for OSX.

export XML_CATALOG_FILES=/usr/local/etc/xml/catalog

cd build
cmake -DLZWS_COMPRESSOR_DICTIONARY="sparse-array" ".." && cmake --build "."
echo -n "TOBEORNOTTOBEORTOBEORNOT" | ./src/cli/lzws | ./src/cli/lzws -d

See examples, man and doc folders.

Please visit scripts/test-images. See test script scripts/toolchains.sh and test script scripts/coverage_toolchains.sh for CI.

See lzws archive collector.

Copyright (c) 2016 David Bryant, 2018+ other authors, all rights reserved (see AUTHORS). Distributed under the BSD Software License (see LICENSE).

Releases with GMP provided without static linked binaries (GMP LGPL license limitation).