.. | ||
.gitignore | ||
.travis.yml | ||
dict.go | ||
doc.go | ||
go.mod | ||
gozstd.go | ||
libzstd_darwin_amd64.a | ||
libzstd_darwin_amd64.go | ||
libzstd_freebsd_amd64.a | ||
libzstd_freebsd_amd64.go | ||
libzstd_linux_amd64.a | ||
libzstd_linux_amd64.go | ||
libzstd_linux_arm64.a | ||
libzstd_linux_arm64.go | ||
libzstd_linux_arm.a | ||
libzstd_linux_arm.go | ||
libzstd_windows_amd64.a | ||
libzstd_windows_amd64.go | ||
LICENSE | ||
Makefile | ||
reader.go | ||
README.md | ||
stream.go | ||
writer.go | ||
zdict.h | ||
zstd_errors.h | ||
zstd.h |
gozstd - go wrapper for zstd
Features
-
Vendors upstream zstd without any modifications.
-
Optimized for speed. The API may be easily used in zero allocations mode.
-
Compress*
andDecompress*
functions are optimized for high concurrency. -
Proper Writer.Flush for network apps.
-
Supports the following features from upstream zstd:
- Block / stream compression / decompression with all the supported compression levels and with dictionary support.
- Dictionary building from a sample set. The created dictionary may be saved to persistent storage / transfered over the network.
- Dictionary loading for compression / decompression.
Pull requests for missing upstream
zstd
features are welcome.
Quick start
How to install gozstd
?
go get -u github.com/valyala/gozstd
How to compress data?
The easiest way is just to use Compress:
compressedData := Compress(nil, data)
There is also StreamCompress and Writer for stream compression.
How to decompress data?
The easiest way is just to use Decompress:
data, err := Decompress(nil, compressedData)
There is also StreamDecompress and Reader for stream decompression.
Who uses gozstd?
FAQ
-
Q: Which go version is supported?
A:go1.10
and newer. Pull requests for older go versions are accepted. -
Q: Which platforms/architectures are supported?
A:linux/amd64
,linux/arm
,linux/arm64
,freebsd/amd64
,darwin/amd64
,windows/amd64
. Pull requests for other platforms/architectures are accepted. -
Q: I don't trust
libzstd*.a
binary files from the repo or these files dont't work on my OS/ARCH. How to rebuild them? A: Just runmake clean libzstd.a
if your OS/ARCH is supported. -
Q: How do I specify custom build flags when recompiling
libzstd*.a
? A: You can specify MOREFLAGS=... variable when runningmake
like this:MOREFLAGS=-fPIC make clean libzstd.a
. -
Q: Why the repo contains
libzstd*.a
binary files?
A: This simplifies package installation to usualgo get
without additional steps for building thelibzstd*.a