圧縮伸張ライブラリ lz4 (https://github.com/lz4/lz4/) の非公式 ruby バインディングライブラリです。
LZ4 データストリームを圧縮・伸張できます。lz4-cli で扱うことが出来ます。
$ dmesg | ruby -r extlz4 -e 'LZ4.encode_file($stdin.binmode, $stdout.binmode)' | lz4c -d | more
ほかの ruby 向けの lz4 バインディングライブラリとしては KOMIYA Atsushi さんによる lz4-ruby (http://rubygems.org/gems/lz4-ruby) があります。
- Generic LZ4 frame data process (for
.lz4file format)- Decode LZ4 Frame data :
LZ4.decode - Encode LZ4 Frame data :
LZ4.encode
- Decode LZ4 Frame data :
- Generic LZ4 frame data file process (for
.lz4file format)- Decode LZ4 Frame data file :
LZ4.decode_file - Encode LZ4 Frame data file :
LZ4.encode_file
- Decode LZ4 Frame data file :
- LZ4 block data process
- Decode LZ4 block data :
LZ4.block_decode - Encode LZ4 block data :
LZ4.block_encode(supporting high compression level) - Streaming Decode LZ4 block data :
LZ4.block_stream_decodeandLZ4::BlockDecoder#update - Streaming Encode LZ4 block data :
LZ4.block_stream_encodeandLZ4::BlockEncoder#update(supporting high compression level)
- Decode LZ4 block data :
See Quick reference for more details.
-
Many documents are written in japanese.
(ドキュメントの多くは日本語で記述されています)
extlz4-0.1 に不正な lz4 ストリームを出力する不具合がありました。
詳しく説明すると、ブロックデータとともに格納時ブロックデータサイズも出力しますが、常に圧縮後のデータサイズを出力していました。圧縮していない (圧縮後のデータサイズが圧縮前のデータサイズを上回った) 場合であれば、圧縮前のデータサイズを出力するべきところですが、そうはなっていません。
これによって無圧縮ブロックデータが正しく読み込めず、ひいてはそのブロック以降のデータが正しく読み込めないということになります。
extlz4-0.1.1 でその不具合の修正を行いました。
また、不正な lz4 ストリームファイルを生成しなおかつオリジナルファイルも失われた場合は、同梱してある bin/extlz4 プログラムに --fix-extlz4-0.1-bug を指定することで正しい lz4 ストリームファイルを出力できます。
extlz4 --fix-extlz4-0.1-bug <file>...
出力ファイル名は、入力ファイル名の頭に "fixed-" を追加したものとなります。
必要であれば -f スイッチが利用できます。
-k スイッチは無視されます。修復した lz4 ストリームファイルが正しいかを検査したあとで不正な lz4 ストリームファイルと差し替えて下さい。
修復できるのはあくまで extlz4-0.1 のこの不具合に起因するファイルのみとなります。
First, load extlz4. (最初に extlz4 を読み込んでください)
require "extlz4"
uncompressed_data_string = LZ4.decode(compressed_data_string)
compressed_data_string = LZ4.encode(uncompressed_data_string)
compressed_data_string = LZ4.encode(uncompressed_data_string, 9)
File.open("sample.txt.lz4", "rb") do |file|
LZ4.decode(file) do |lz4|
lz4.read(50) # read 50 bytes as string
lz4.getc # read 1 byte as integer
lz4.read # read rest bytes as string
end
end
File.open("sample.txt.lz4", "wb") do |file|
LZ4.encode(file, 9) do |lz4|
lz4 << "#{Time.now}: abcdefghijklmnopqrstuvwxyz\n"
lz4.write "#{Time.now}: abcdefghijklmnopqrstuvwxyz\n"
end
end
file = File.open("sample.txt.lz4", "wb")
lz4 = LZ4.encode(file)
lz4 << "abcdefghijklmnopqrstuvwxyz\n"
lz4.close # VERY IMPORTANT!
src = "abcdefg" * 100
lz4data = LZ4.block_encode(src)
data = LZ4.block_decode(lz4data)
p src == data # => true
src = "abcdefg" * 100
level = 8
lz4data = LZ4.block_encode(level, src)
data = LZ4.block_decode(lz4data)
p src == data # => true
src = "abcdefg" * 100
level = -19 # transform to one's complement as acceleration
lz4data = LZ4.block_encode(level, src)
level = 8 # (OPTIONAL PARAMETER)
predict = "abcdefg" # with preset dictionary (OPTIONAL PARAMETER)
encoder = LZ4.block_stream_encode(level, predict)
src = "abcdefg" * 100
lz4data1 = encoder.update(src)
decoder = LZ4.block_stream_decode(predict)
data = decoder.update(lz4data1)
p src == data # => true
src2 = "ABCDEFG" * 100
lz4data2 = encoder.update(src2)
p "lz4data1.bytesize" => lz4data1.bytesize,
"lz4data2.bytesize" => lz4data2.bytesize
data = decoder.update(lz4data2)
p src2 == data # => true
Ruby3 で追加された Ractor に対応しています。
コマンドラインプログラムとして extlz4 が追加されます。
これは lz4 と同程度の機能を持ちます (車輪の再発明とも言う)。
とはいえ、引数のとり方を変えてあり、gzip のような形で利用できます。
- package name: extlz4
- author: dearblue (mailto:dearblue@users.osdn.me)
- project page: https://github.com/dearblue/ruby-extlz4
- how to install:
gem install extlz4 - version: 0.3.4
- product quality: technical preview
- licensing: 2 clause BSD License
- dependency gems: none
- dependency external c libraries: none
- bundled external c libraries (git submodules):
- lz4 version 1.9.3 under 2 clause BSD license by Yann Collet