bytelike-derive

Crates.iobytelike-derive
lib.rsbytelike-derive
version0.1.9
sourcesrc
created_at2024-11-15 03:03:18.519874
updated_at2024-11-20 17:29:44.913869
descriptionDerive macros for bytelike new types
homepage
repository
max_upload_size
id1448569
size16,788
Louis Thiery (lthiery)

documentation

README

ByteLike-Derive

CI Crates.io Version

ByteLike Derive is a procedural macro crate for deriving ByteLike functions for deriving byte-like new types.

It's a procedural macro that was created based off the implementation of ByteSize.

Usage

Add this to your Cargo.toml

[dependencies]
bytelike = { version = "0.1" }
bytelike-derive = { version = "0.1", features = ["serde"] }
serde = { version = "1.0" }
serde_derive = { version = "1.0" }

Or if don't want serde:

[dependencies]
bytelike = { version = "0.1" }
bytelike-derive = { version = "0.1" }

Next, define your new type and derive ByteLike for it:

use bytelike_derive::ByteLike;

#[derive(ByteLike)]
pub struct NewType(pub u64);

Now you can do lots of useful byte-like things with your new type:

let new_type_a: NewType = "5KiB".parse().unwrap();
let new_type_b: NewType = NewType::kib(5);
let sum = new_type + other_type;
let sum = new_type + 5;

See the documentation for ByteSize to see more examples of what you can do with the ByteLike new type (just replace ByteSize with your new type name).

In addition, if you only want some of the ByteLike functions derived, you can use any of the following derives in an additive manner:

  • ByteLikeConstructor
  • ByteLikeDisplay
  • ByteLikeParse
  • ByteLikeOps
  • ByteLikeFromStr
  • ByteLikeSerde (requires the serde feature)
Commit count: 0

cargo fmt