Vendors upstream zstd without any modifications.
Optimized for speed. The API may be easily used in zero allocations mode.
Decompress* functions are optimized for high concurrency.
Proper Writer.Flush for network apps.
Supports the following features from upstream zstd:
Pull requests for missing upstream
zstd features are welcome.
go get -u github.com/valyala/gozstd
The easiest way is just to use Compress:
compressedData := Compress(nil, data)
The easiest way is just to use Decompress:
data, err := Decompress(nil, compressedData)
If you're cross-compiling some code that uses gozstd and you stumble upon the following error:
# github.com/valyala/gozstd /go/pkg/mod/github.com/valyala/[email protected]/stream.go:31:59: undefined: CDict /go/pkg/mod/github.com/valyala/[email protected]/stream.go:35:64: undefined: CDict /go/pkg/mod/github.com/valyala/[email protected]/stream.go:47:20: undefined: Writer
You can easily fix it by enabling CGO and using a cross-compiler (e.g.
env CC=arm-linux-gnueabi-gcc GOOS=linux GOARCH=arm CGO_ENABLED=1 go build ./main.go
NOTE: Check #21 for more info.
Q: Which go version is supported?
go1.10 and newer. Pull requests for older go versions are accepted.
Q: Which platforms/architectures are supported?
windows/amd64. Pull requests for other platforms/architectures
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 run
make clean libzstd.a if your OS/ARCH is supported.
Q: How do I specify custom build flags when recompiling
A: You can specify MOREFLAGS=... variable when running
make like this:
MOREFLAGS=-fPIC make clean libzstd.a.
Q: Why the repo contains
libzstd*.a binary files?
A: This simplifies package installation to usual
go get without additional steps for building the