⚡

Pure Native Zig (0.17.0)

Engineered from first principles in native Zig without `@cImport`, C compiler requirements, or external runtime dependencies.

🗜️

Dual LZMA2 & LZMA Support

Modern LZMA2 chunk protocol (`lzma2.compress`), legacy `.lzma` 13-byte header files (`lzma.compress`), and raw continuous LZMA streams (`lzma.compressRaw`).

📦

Real LZMA2 Chunk Protocol

Implements the true LZMA2 stream format supporting uncompressed copy chunks (`0x01`/`0x02`), LZMA chunks, all 4 reset modes, and end-of-stream control bytes.

🌊

First-Class Streaming I/O

Incremental chunk-by-chunk and reader/writer streaming pipelines (`compressStream`, `decompressStream`, `compressStreamAlone`) with bounded memory.

🛡️

Defensive & Bomb-Proof

Strict bounds checking, safe handling of corrupted bitstreams, and configurable `max_output_size` guards against decompression bomb attacks.

🔄

Context Reuse & Zero Heap Allocations

Stateful `Compressor` and `Decompressor` contexts eliminate buffer allocation churn; caller-buffer APIs (`compressInto`, `decompressInto`) operate with zero heap overhead.

⚙️

Presets & Configurable Dictionaries

Standard presets (`.fastest`, `.fast`, `.normal`, `.maximum`) and fine-grained controls for dictionary sizes up to 1 GiB and literal context bits.

Installation

lzma2.zig is production-ready. The recommended method for applications and downstream libraries is to pin to the tagged stable release:

bash

# Recommended: Tagged stable release (0.0.1)
zig fetch --save https://github.com/muhammad-fiaz/lzma2.zig/archive/refs/tags/0.0.1.tar.gz

# Alternative: Latest development build (main branch)
zig fetch --save git+https://github.com/muhammad-fiaz/lzma2.zig.git

Then expose the module in your build.zig:

zig

const lzma2_dep = b.dependency("lzma2", .{
    .target = target,
    .optimize = optimize,
});
exe.root_module.addImport("lzma2", lzma2_dep.module("lzma2"));

Quick Example

Compress and decompress data in just a few lines of idiomatic Zig:

zig

const std = @import("std");
const lzma2 = @import("lzma2");

pub fn main() !void {
    const allocator = std.heap.page_allocator;

    const payload = "Native LZMA2 compression in pure Zig 0.17.0! High-ratio dictionary encoding.";

    // One-shot heap compression
    const compressed = try lzma2.compress(allocator, payload, .{});
    defer allocator.free(compressed);

    // One-shot heap decompression
    const restored = try lzma2.decompress(allocator, compressed, .{});
    defer allocator.free(restored);

    std.debug.print("Original size:   {d} bytes\n", .{payload.len});
    std.debug.print("Compressed size: {d} bytes\n", .{compressed.len});
    std.debug.print("Restored:        {s}\n", .{restored});
}

lzma2.zigNative LZMA2 Compression for Zig