zstd

Crystal CI GitHub release GitHub commits since latest release (by date) for a branch Docs

Crystal bindings to the Zstandard (zstd) compression library

Features

Experimental Features. API's subject to change.

Todo

Installation

  1. On OSX ensure that zstd is installed (brew install zstd).
    On Linux it will be downloaded and compiled automatically if missing.

  2. Add the dependency to your shard.yml:

    dependencies:
      zstd:
        github: didactic-drunk/zstd.cr
  3. Run shards install

Usage

require "zstd"

Buffer API

cctx = Zstd::Compress::Context.new(level: 1)
cbuf = cctx.compress buf

dctx = Zstd::Decompress::Context.new
dbuf = dctx.decompress cbuf

Streaming API

buf = Bytes.new 5
mio = IO::Memory.new
Zstd::Compress::IO.open(mio, level: 1) do |cio|
  cio.write buf
end

mio.rewind
str = Zstd::Decompress::IO.open(mio) do |dio|
  dio.gets_to_end
end

Dictionary API

dict_buffer = File.read("dictionary").to_slice
dict = Zstd::Dict.new dict_buffer, level: 3

cctx = Zstd::Compress::Context.new dict: dict
dctx = Zstd::Decompress::Context.new dict: dict

# Compress or decompress using the Buffer or Streaming API's

p dict.dict_id
p dict.memsize

Contributing

  1. Fork it (https://github.com/your-github-user/zstd/fork)
  2. Install a formatting check git hook (ln -sf ../../scripts/git/pre-commit .git/hooks)
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Commit your changes (git commit -am 'Add some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create a new Pull Request

Contributors