isabella232 / msgpack-rust

MessagePack implementation for Rust / msgpack.org[Rust]

RMP - Rust MessagePack

RMP is a pure Rust MessagePack implementation.

This repository consists of three separate crates: the RMP core and two implementations to ease serializing and deserializing Rust structs.

	crates.io	API Documentation
rmp		RMP
rmps		RMP Serde
rmpv		RMP Value

Features

• Convenient API

  RMP is designed to be lightweight and straightforward. There are low-level API, which gives you full control on data encoding/decoding process and makes no heap allocations. On the other hand there are high-level API, which provides you convenient interface using Rust standard library and compiler reflection, allowing to encode/decode structures using derive attribute.

• Zero-copy value decoding

  RMP allows to decode bytes from a buffer in a zero-copy manner easily and blazingly fast, while Rust static checks guarantees that the data will be valid as long as the buffer lives.

• Clear error handling

  RMP's error system guarantees that you never receive an error enum with unreachable variant.

• Robust and tested

  This project is developed using TDD and CI, so any found bugs will be fixed without breaking existing functionality.

Requirements

• Rust 1.34.2

Versioning

This project adheres to Semantic Versioning. However until 1.0.0 comes there will be the following rules:

• Any API/ABI breaking changes will be notified in the changelog explicitly and results in minor version bumping.
• API extending features results in patch version bumping.
• Non-breaking bug fixes and performance improving results in patch version bumping.