#hex #serde #byte

no-std hex-buffer-serde

Helper for serializing byte buffers as hex strings in serde

7 unstable releases

0.4.0 Nov 1, 2022
0.3.0 May 3, 2021
0.2.2 Dec 5, 2020
0.2.1 Mar 15, 2020
0.1.1 Nov 30, 2018

#1792 in Encoding

Download history 317/week @ 2024-12-25 1061/week @ 2025-01-01 1220/week @ 2025-01-08 1082/week @ 2025-01-15 1076/week @ 2025-01-22 979/week @ 2025-01-29 1667/week @ 2025-02-05 1253/week @ 2025-02-12 1144/week @ 2025-02-19 1079/week @ 2025-02-26 863/week @ 2025-03-05 1225/week @ 2025-03-12 2184/week @ 2025-03-19 1267/week @ 2025-03-26 1328/week @ 2025-04-02 1302/week @ 2025-04-09

6,312 downloads per month
Used in 37 crates (10 directly)

Apache-2.0

32KB
425 lines

Hex encoding helper for serde

Build Status License: Apache-2.0 rust 1.57+ required

Documentation: Docs.rs crate docs (master)

hex-buffer-serde is a helper crate allowing to serialize types, which logically correspond to a byte buffer, in hex encoding within serde.

Usage

Add this to your Crate.toml:

[dependencies]
hex-buffer-serde = "0.4.0"

Basic usage:

use hex_buffer_serde::{Hex as _, HexForm};
use serde_derive::{Deserialize, Serialize};

#[derive(Serialize, Deserialize)]
pub struct Example {
    // will be serialized as hex string in human-readable formats
    // (e.g., JSON or TOML), and as a byte array in binary formats
    // (e.g., bincode).
    #[serde(with = "HexForm")]
    buffer: [u8; 32],
    // other fields...
}

See crate docs for more examples of usage.

Alternatives

hex-serde provides similar functionality and is a viable alternative if you have the control over the type that needs hex-encoding. This crate differs from hex-serde in the following ways:

  • You don't need control over the (de)serialized type; it does not need to implement any specific "useful" traits (such as AsRef<[u8]>).
  • Hex encoding is used only with human-readable (de)serializers (e.g., JSON or TOML). If the (de)serializer is not human-readable (e.g., bincode), the type is serialized as a byte array.

serde-with also provides hex encoding / decoding functionality with similar constraints to hex-serde.

License

hex-buffer-serde is licensed under the Apache License (Version 2.0). See LICENSE for details.

Dependencies

~115–340KB