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 | |
rmp-serialize | RMP Serialize | |
rmps | RMP Serde | |
rmpv | RMP Value |
-
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.
- Rust 1.16
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.