History

Miek Gieben 30217a4cb2 Drop caddy from vendor (#700 ) * Removed caddy * new stuff * Now need to go get caddy * Duh		2017-06-03 08:27:41 +01:00
..
.travis.yml	Update vendor with `go dep`	2017-04-28 09:14:54 -07:00
block.go	Drop caddy from vendor (#700 )	2017-06-03 08:27:41 +01:00
export_test.go	Update vendor with `go dep`	2017-04-28 09:14:54 -07:00
LICENSE	Update vendor with `go dep`	2017-04-28 09:14:54 -07:00
lz4.go	Drop caddy from vendor (#700 )	2017-06-03 08:27:41 +01:00
lz4_test.go	Drop caddy from vendor (#700 )	2017-06-03 08:27:41 +01:00
reader.go	Update vendor with `go dep`	2017-04-28 09:14:54 -07:00
README.md	Update vendor with `go dep`	2017-04-28 09:14:54 -07:00
writer.go	Drop caddy from vendor (#700 )	2017-06-03 08:27:41 +01:00

README.md

lz4

LZ4 compression and decompression in pure Go

Usage

import "github.com/pierrec/lz4"

Description

Package lz4 implements reading and writing lz4 compressed data (a frame), as specified in http://fastcompression.blogspot.fr/2013/04/lz4-streaming-format-final.html, using an io.Reader (decompression) and io.Writer (compression). It is designed to minimize memory usage while maximizing throughput by being able to [de]compress data concurrently.

The Reader and the Writer support concurrent processing provided the supplied buffers are large enough (in multiples of BlockMaxSize) and there is no block dependency. Reader.WriteTo and Writer.ReadFrom do leverage the concurrency transparently. The runtime.GOMAXPROCS() value is used to apply concurrency or not.

Although the block level compression and decompression functions are exposed and are fully compatible with the lz4 block format definition, they are low level and should not be used directly. For a complete description of an lz4 compressed block, see: http://fastcompression.blogspot.fr/2011/05/lz4-explained.html

See https://github.com/Cyan4973/lz4 for the reference C implementation.