@xingrz/cppzst

@xingrz/cppzst 
=====

[![][npm-version]][npm-url] [![][npm-downloads]][npm-url] [![license][license-img]][license-url] [![issues][issues-img]][issues-url] [![stars][stars-img]][stars-url] [![commits][commits-img]][commits-url]

Zstd binding for Nodejs, with TypeScript support.

Installation

``sh
$ npm install @xingrz/cppzst --save
`

Usage

$3

#### compress(buffer[, zstdCompressParams])

`ts
import { compress } from '@xingrz/cppzst';

try {
const output = await compress(input);
} catch(err) {
// ...
}
`

#### decompress(buffer[, zstdDecompressParams])

`ts
import { decompress } from '@xingrz/cppzst';

try {
const output = await decompress(input);
} catch(err) {
// ...
}
`

$3

#### compressSync(buffer[, zstdCompressParams])

`ts
import { compressSync } from '@xingrz/cppzst';

try {
const output = compressSync(input);
} catch(err) {
// ...
}
`

#### decompressSync(buffer[, zstdCompressParams])

`ts
import { decompressSync } from '@xingrz/cppzst';

try {
const output = decompressSync(input);
} catch(err) {
// ...
}
`

$3

#### compressStream([zstdCompressParams])

`ts
import { compressStream } from '@xingrz/cppzst';
import { createReadStream, createWriteStream } from 'fs';

createReadStream('path/to/input')
.pipe(compressStream())
.pipe(createWriteStream('path/to/output'));
`

#### decompressStream([zstdCompressParams])

`ts
import { decompressStream } from '@xingrz/cppzst';
import { createReadStream, createWriteStream } from 'fs';

createReadStream('path/to/input')
.pipe(decompressStream())
.pipe(createWriteStream('path/to/output'));
`

$3

The compress, compressSync and compressStream methods may accept an optional zstdCompressParams object to define compress level and/or dict.

`ts
const zstdCompressParams = {
level: 5, // default 1
dict: new Buffer('hello zstd'), // if dict null, left level only.
dictSize: dict.length, // if dict null, left level only.
};
`

The decompress, decompressSync and decompressStream methods may accept an optional zstdDecompressParams object to define dict.

`ts
const zdtdDecompressParams = {
dict: new Buffer('hello zstd'),
dictSize: dict.length,
};
`

Tests

`sh
$ npm test
``

License

MIT

[npm-version]: https://img.shields.io/npm/v/@xingrz/cppzst.svg?style=flat-square
[npm-downloads]: https://img.shields.io/npm/dm/@xingrz/cppzst.svg?style=flat-square
[npm-url]: https://www.npmjs.org/package/@xingrz/cppzst
[license-img]: https://img.shields.io/github/license/xingrz/cppzst?style=flat-square
[license-url]: LICENSE
[issues-img]: https://img.shields.io/github/issues/xingrz/cppzst?style=flat-square
[issues-url]: https://github.com/xingrz/cppzst/issues
[stars-img]: https://img.shields.io/github/stars/xingrz/cppzst?style=flat-square
[stars-url]: https://github.com/xingrz/cppzst/stargazers
[commits-img]: https://img.shields.io/github/last-commit/xingrz/cppzst?style=flat-square
[commits-url]: https://github.com/xingrz/cppzst/commits/master