github-mirrors/VictoriaMetrics
1
0
Fork 0
mirror of https://github.com/VictoriaMetrics/VictoriaMetrics.git synced 2024-12-01 14:47:38 +00:00
Code Issues Projects Releases Packages Wiki Activity
VictoriaMetrics/vendor/github.com/valyala/gozstd
History
Aliaksandr Valialkin 1836c415e6 all: open-sourcing single-node version
2019-05-23 00:18:06 +03:00
..
.gitignore all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
.travis.yml all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
dict.go all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
go.mod all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
gozstd.go all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
libzstd_darwin_amd64.a all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
libzstd_darwin_amd64.go all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
libzstd_linux_amd64.a all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
libzstd_linux_amd64.go all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
libzstd_linux_arm.a all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
libzstd_linux_arm.go all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
libzstd_linux_arm64.a all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
libzstd_linux_arm64.go all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
libzstd_windows_amd64.a all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
libzstd_windows_amd64.go all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
LICENSE all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
Makefile all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
reader.go all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
README.md all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
stream.go all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
writer.go all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
zdict.h all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
zstd.h all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00
zstd_errors.h all: open-sourcing single-node version 2019-05-23 00:18:06 +03:00

README.md

Build Status GoDoc Go Report codecov

gozstd - go wrapper for zstd

Features

  • Vendors upstream zstd without any modifications.

  • Simple API.

  • Optimized for speed. The API may be easily used in zero allocations mode.

  • Compress* and Decompress* 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.

FAQ

  • Q: Which go version is supported?
    A: go1.10 and newer. Pull requests for older go versions support are accepted.

  • Q: Which platforms/architectures are supported?
    A: linux/amd64, linux/arm, linux/arm64, darwin/amd64, windows/amd64. Pull requests for other platforms/architectures support 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 run make clean libzstd.a if your OS/ARCH is supported.

  • Q: Why the repo contains libzstd*.a binary files?
    A: This simplifies package installation to usual go get without additional steps for building the libzstd*.a