Snappy bindings for Rust

Jeff Belgum

Last update: Jan 21, 2022

Related tags

Compression rust-snappy

Overview

Snappy

[ Originally forked from https://github.com/thestinger/rust-snappy ]

Documentation

Usage

Add this to your Cargo.toml:

[dependencies]
snappy = "0.4"

and this to your crate root:

extern crate snappy;

Installing Snappy

The Snappy C++ library can be installed on Mac OS X using homebrew brew install snappy.
If that library is not installed in the usual path, you can export the LD_LIBRARY_PATH and LD_RUN_PATH environment variables before issueing cargo build.
Static linking can be requested by an export SNAPPY_SYS_STATIC=1 prior to cargo build.
As a fallback, this crate will try to compile the Snappy C++ library itself and statically link against it. (This behavior can be enforced by an export SNAPPY_SYS_STATIC_FROM_SOURCE=1 prior to cargo build.)

Building

The Snappy C++ library is also optionally bundled as a submodule. A

git submodule update --init

will fetch a copy of the library for local compilation. This can will then be used if the c++ library cannot be found on your system or if SNAPPY_SYS_STATIC_FROM_SOURCE is set to 1.

Like pigz, but rust - a cross platform, fast, compression and decompression tool.

🦀 crabz Like pigz, but rust. A cross platform, fast, compression and decompression tool. Synopsis This is currently a proof of concept CLI tool using

232 Jan 2, 2023

Ribzip2 - A bzip2 implementation in pure Rust.

ribzip2 - a comprehensible bzip2 implementation ribzip2 is command line utility providing bzip2 compression and decompression written in pure Rust. It

16 Oct 24, 2022

A reimplementation of the Zopfli compression tool in Rust.

Zopfli in Rust This is a reimplementation of the Zopfli compression tool in Rust. Carol Nichols started the Rust implementation as an experiment in in

11 Dec 26, 2022

A Rust application that compress files and folders

Quick Storer This is a Rust application that compress files and folders. Usage Download or build the binary and place it on your desktop, or any other

1 Feb 2, 2022

banzai: pure rust bzip2 encoder

banzai banzai is a bzip2 encoder with linear-time complexity, written entirely in safe Rust. It is currently alpha software, which means that it is no

27 Oct 24, 2022

An extremely fast alternative to zip which is written in rust.

Zap Compress and/or encrypt folders fast. Like, really fast. or as some say, blazingly fast. Installation To install Zap, run the following command fr

39 Dec 23, 2022

An extremely fast alternative to zip which is written in rust.

Zap Compress and/or encrypt folders fast. Like, really fast. or as some say, blazingly fast. Installation To install Zap, run the following command fr

37 Nov 9, 2022

Simple NoNG songs manager for GD, written in Rust.

nong-manager Simple NoNG songs manager for GD, written in Rust. Powered by Song File Hub (https://songfilehub.com/home) How to use Enter song ID that

4 May 13, 2023

Basic (and naïve) LZW and Huffman compression algorithms in Rust.

Naive implementation of the LZW and Huffman compression algorithms. To run, install the Rust toolchain. Cargo may be used to compile the source. Examp

9 May 22, 2023

Comments

Add uncompress_to
Upgrade libc dependency

Switch to Result instead of Option to force usage of the return types

Add uncompress_to to allow buffer reuse

Custom build.rs to support alternative snappy installations
opened by xitep 5
Build snappy lib directly if not present on the host
Includes the sources for the c++ lib as a submodule

Separates into snappy (higher-level functions) and snappy-sys (pure bindings)

Requires git submodule update --init prior to building/publishing

Requires publishing snappy and snappy-sys

Seems to work fine on debian wheezy and jessie

Would love this to be tested on mac os x
opened by xitep 3
proposal: build from sources by default

Snappy tries to link to system library by default. If it's not installed yet, it will fallback to compile from sources instead. This strategy works out of box and very convenient when there people wants to link the system library.

However, because the version in submodule may not be the same as the installed one on host machine, so it doesn't produce consistent binary, compilation/tests may work on some machine but fail on others. Second, the linking policy in rust is static by default, which is different from this crate, it may be confusing for users.

I propose to build the library from sources by default and no automatically fallback. So the problems described above will all be solved. For those really want to link to system library, environment variables can still work. This is a broken changes though. After #4 is merged, machine without cmake installed will fail.

Any thoughts?

opened by BusyJay 0
Adjust build

This pr updates snappy to the latest version and use cmake to build the native library. Using config/make only works on *nix system, and cmake is also recommended by the upstream.

CMake is supported and autotools will soon be deprecated.

Also can you turn on the issues tab? I want to raise an issue to discuss about whether to build and link to sources by default. But can't find any places to write it down.

opened by BusyJay 1