https://github.com/frugalos/liberasurecode

A Rust wrapper for `openstack/liberasurecode`
https://github.com/frugalos/liberasurecode

c-bindings erasure-coding rust

Last synced: about 2 months ago
JSON representation

A Rust wrapper for `openstack/liberasurecode`

• Host: GitHub
• URL: https://github.com/frugalos/liberasurecode
• Owner: frugalos
• License: mit
• Created: 2018-09-27T06:14:53.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2020-10-19T05:24:37.000Z (about 4 years ago)
• Last Synced: 2024-10-08T09:41:25.737Z (3 months ago)
• Topics: c-bindings, erasure-coding, rust
• Language: Rust
• Size: 46.9 KB
• Stars: 21
• Watchers: 8
• Forks: 8
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
liberasurecode

==============

[![Crates.io: liberasurecode](https://img.shields.io/crates/v/liberasurecode.svg)](https://crates.io/crates/liberasurecode)

[![Documentation](https://docs.rs/liberasurecode/badge.svg)](https://docs.rs/liberasurecode)

[![Build Status](https://travis-ci.org/frugalos/liberasurecode.svg?branch=master)](https://travis-ci.org/frugalos/liberasurecode)

[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

A Rust wrapper for [openstack/liberasurecode].

[Documentation](https://docs.rs/liberasurecode)

[openstack/liberasurecode]: https://github.com/openstack/liberasurecode

Prerequisites to Build

----------------------

This crate requires the following packages for building [openstack/liberasurecode] in the build script:

- C compiler (e.g., `gcc`)

- `git`

- `make`

- `automake`

- `autoconf`

- `libtool`

For example, on Ubuntu, you can install those by executing the following command:

```console

$ sudo apt install gcc git make automake autoconf libtool

```

Examples

--------

Basic usage:

```rust

use liberasurecode::{ErasureCoder, Error};

let mut coder = ErasureCoder::new(4, 2)?;

let input = vec![0, 1, 2, 3];

// Encodes `input` to data and parity fragments

let fragments = coder.encode(&input)?;

// Decodes the original data from the fragments (or a part of those)

assert_eq!(Ok(&input), coder.decode(&fragments[0..]).as_ref());

assert_eq!(Ok(&input), coder.decode(&fragments[1..]).as_ref());

assert_eq!(Ok(&input), coder.decode(&fragments[2..]).as_ref());

assert_eq!(Err(Error::InsufficientFragments), coder.decode(&fragments[3..]));

```