10 releases

0.3.0 Dec 17, 2021
0.2.2 Mar 8, 2021
0.2.0 Feb 8, 2021
0.1.5 Feb 6, 2021
0.1.1 Jun 10, 2020

#92 in Procedural macros

Download history 864/week @ 2024-07-21 2490/week @ 2024-07-28 2650/week @ 2024-08-04 2726/week @ 2024-08-11 1953/week @ 2024-08-18 1367/week @ 2024-08-25 1454/week @ 2024-09-01 1922/week @ 2024-09-08 2164/week @ 2024-09-15 3757/week @ 2024-09-22 2763/week @ 2024-09-29 5356/week @ 2024-10-06 8266/week @ 2024-10-13 8823/week @ 2024-10-20 7042/week @ 2024-10-27 6810/week @ 2024-11-03

31,359 downloads per month
Used in 14 crates (10 directly)

Custom license

14KB
173 lines

Format-bytes

This crate exposes a procedural macro that allows you to format bytestrings. For more background on why you would want to do that, read this article.

Usage

Add this to your Cargo.toml:

[dependencies]
format-bytes = "0.2"

then use the macro like so:

use format_bytes::format_bytes;

fn main() {
    assert_eq!(
        format_bytes!(b"look at those {} bytes", &[0u8, 1, 2]),
        b"look at those \x00\x01\x02 bytes"
    );
}

See more examples of how it works on the documentation of format_bytes! itself.

Missing features

  • Named arguments, but they should be added in a future version
  • Python-like "f-string" functionality is not planned because of its more complex implementation and limited actual benefit
  • format!-like padding helpers: if the need manifests itself, they might appear
  • #[no_std] support

Why not 1.0?

Not until named arguments have landed and the macro gets a bit of mileage (it will be used in Mercurial).

Dependencies

~1.5MB
~37K SLoC