Skip to content
/ lz4.cr Public
forked from naqvis/lz4.cr

Crystal bindings to the LZ4 compression library

License

Notifications You must be signed in to change notification settings

84codes/lz4.cr

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Crystal LZ4 Compression

Crystal bindings to the LZ4 compression library. Bindings provided in this shard cover the frame format as the frame format is the recommended one to use and guarantees interoperability with other implementations and language bindings.

LZ4 is a lossless compression algorithm, providing compression speeds > 500 MB/s per core (>0.15 Bytes/cycle). It features an extremely fast decoder, with speeds in multiple GB/s per core (~1 Byte/cycle).

Installation

  1. Add the dependency to your shard.yml:

    dependencies:
      lz4:
        github: naqvis/lz4.cr
  2. Run shards install

Usage

require "lz4"

LZ4 shard provides both Compress::LZ4::Reader and Compress::LZ4::Writer as well as Compress::LZ4#decode and Compress::LZ4#encode methods for quick usage.

Example: decompress an lz4 file

require "lz4"

string = File.open("file.lz4") do |file|
   Compress::LZ4::Reader.open(file) do |lz4|
     lz4.gets_to_end
   end
end
pp string

Example: compress to lz4 compression format

require "lz4"

File.write("file.txt", "abcd")

File.open("./file.txt", "r") do |input_file|
  File.open("./file.lz4", "w") do |output_file|
    Compress::LZ4::Writer.open(output_file) do |lz4|
      IO.copy(input_file, lz4)
    end
  end
end

Contributing

  1. Fork it (https://github.com/naqvis/lz4.cr/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

About

Crystal bindings to the LZ4 compression library

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Crystal 100.0%