diff options
author | 6543 <6543@obermui.de> | 2020-11-06 19:41:42 +0100 |
---|---|---|
committer | GitHub <noreply@github.com> | 2020-11-06 13:41:42 -0500 |
commit | 30ce3731a17913155436cee323b1e7016ad8eb49 (patch) | |
tree | d03230684af7dfcfff7705ac547a35b3089f02fb /vendor/github.com/pierrec/lz4/v4/README.md | |
parent | eebaa81f43a6fd982dcd96571a020242f0ea3276 (diff) | |
download | gitea-30ce3731a17913155436cee323b1e7016ad8eb49.tar.gz gitea-30ce3731a17913155436cee323b1e7016ad8eb49.zip |
Vendor Update Go Libs (#13444)
* 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>
Diffstat (limited to 'vendor/github.com/pierrec/lz4/v4/README.md')
-rw-r--r-- | vendor/github.com/pierrec/lz4/v4/README.md | 90 |
1 files changed, 90 insertions, 0 deletions
diff --git a/vendor/github.com/pierrec/lz4/v4/README.md b/vendor/github.com/pierrec/lz4/v4/README.md new file mode 100644 index 0000000000..4ee388e81b --- /dev/null +++ b/vendor/github.com/pierrec/lz4/v4/README.md @@ -0,0 +1,90 @@ +# 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. |