* denisenkom/go-mssqldb untagged -> v0.9.0 * github.com/editorconfig/editorconfig-core-go v2.3.7 -> v2.3.8 * github.com/go-testfixtures/testfixtures v3.4.0 -> v3.4.1 * github.com/mholt/archiver v3.3.2 -> v3.5.0 * github.com/olivere/elastic v7.0.20 -> v7.0.21 * github.com/urfave/cli v1.22.4 -> v1.22.5 * github.com/xanzy/go-gitlab v0.38.1 -> v0.39.0 * github.com/yuin/goldmark-meta untagged -> v1.0.0 * github.com/ethantkoenig/rupture 0a76f03a811a -> c3b3b810dc77 * github.com/jaytaylor/html2text 8fb95d837f7d -> 3577fbdbcff7 * github.com/kballard/go-shellquote cd60e84ee657 -> 95032a82bc51 * github.com/msteinert/pam 02ccfbfaf0cc -> 913b8f8cdf8b * github.com/unknwon/paginater 7748a72e0141 -> 042474bd0eae * CI.restart() Co-authored-by: techknowlogick <techknowlogick@gitea.io>
90 lines
2.4 KiB
Markdown
Vendored
90 lines
2.4 KiB
Markdown
Vendored
# lz4 : LZ4 compression in pure Go
|
|
|
|
[![GoDoc](https://godoc.org/github.com/pierrec/lz4?status.svg)](https://godoc.org/github.com/pierrec/lz4)
|
|
[![Build Status](https://travis-ci.org/pierrec/lz4.svg?branch=master)](https://travis-ci.org/pierrec/lz4)
|
|
[![Go Report Card](https://goreportcard.com/badge/github.com/pierrec/lz4)](https://goreportcard.com/report/github.com/pierrec/lz4)
|
|
[![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/pierrec/lz4.svg?style=social)](https://github.com/pierrec/lz4/tags)
|
|
|
|
## Overview
|
|
|
|
This package provides a streaming interface to [LZ4 data streams](http://fastcompression.blogspot.fr/2013/04/lz4-streaming-format-final.html) as well as low level compress and uncompress functions for LZ4 data blocks.
|
|
The implementation is based on the reference C [one](https://github.com/lz4/lz4).
|
|
|
|
## Install
|
|
|
|
Assuming you have the go toolchain installed:
|
|
|
|
```
|
|
go get github.com/pierrec/lz4
|
|
```
|
|
|
|
There is a command line interface tool to compress and decompress LZ4 files.
|
|
|
|
```
|
|
go install github.com/pierrec/lz4/cmd/lz4c
|
|
```
|
|
|
|
Usage
|
|
|
|
```
|
|
Usage of lz4c:
|
|
-version
|
|
print the program version
|
|
|
|
Subcommands:
|
|
Compress the given files or from stdin to stdout.
|
|
compress [arguments] [<file name> ...]
|
|
-bc
|
|
enable block checksum
|
|
-l int
|
|
compression level (0=fastest)
|
|
-sc
|
|
disable stream checksum
|
|
-size string
|
|
block max size [64K,256K,1M,4M] (default "4M")
|
|
|
|
Uncompress the given files or from stdin to stdout.
|
|
uncompress [arguments] [<file name> ...]
|
|
|
|
```
|
|
|
|
|
|
## Example
|
|
|
|
```
|
|
// Compress and uncompress an input string.
|
|
s := "hello world"
|
|
r := strings.NewReader(s)
|
|
|
|
// The pipe will uncompress the data from the writer.
|
|
pr, pw := io.Pipe()
|
|
zw := lz4.NewWriter(pw)
|
|
zr := lz4.NewReader(pr)
|
|
|
|
go func() {
|
|
// Compress the input string.
|
|
_, _ = io.Copy(zw, r)
|
|
_ = zw.Close() // Make sure the writer is closed
|
|
_ = pw.Close() // Terminate the pipe
|
|
}()
|
|
|
|
_, _ = io.Copy(os.Stdout, zr)
|
|
|
|
// Output:
|
|
// hello world
|
|
```
|
|
|
|
## Contributing
|
|
|
|
Contributions are very welcome for bug fixing, performance improvements...!
|
|
|
|
- Open an issue with a proper description
|
|
- Send a pull request with appropriate test case(s)
|
|
|
|
## Contributors
|
|
|
|
Thanks to all [contributors](https://github.com/pierrec/lz4/graphs/contributors) so far!
|
|
|
|
Special thanks to [@Zariel](https://github.com/Zariel) for his asm implementation of the decoder.
|
|
|
|
Special thanks to [@klauspost](https://github.com/klauspost) for his work on optimizing the code.
|