#macro-derive #original #abomonation

macro abomonation_derive_ng

A custom derive plugin for abomonation

1 unstable release

0.1.0 Nov 8, 2023

#95 in #original

Download history 55/week @ 2024-07-22 81/week @ 2024-07-29 95/week @ 2024-08-05 72/week @ 2024-08-12 73/week @ 2024-08-19 56/week @ 2024-08-26 50/week @ 2024-09-02 80/week @ 2024-09-09 157/week @ 2024-09-16 273/week @ 2024-09-23 261/week @ 2024-09-30 246/week @ 2024-10-07 319/week @ 2024-10-14 227/week @ 2024-10-21 160/week @ 2024-10-28 237/week @ 2024-11-04

947 downloads per month
Used in 3 crates

MIT license

17KB
423 lines

abomonation_derive_ng

Derive macro implementation for the Abomonation crate. Forked & improved from the original abomonation_derive crate from @mystor.

This crate provides a custom derive macro #[derive(Abomonation)] for types that should be serializable with the abomonation crate.

Usage

Add this to your Cargo.toml:

[dependencies]
abomonation_derive_ng = "0.1"
abomonation = "0.5"

Then, derive Abomonation on your types:

#[macro_use]
extern crate abomonation_derive_ng;
extern crate abomonation;
use abomonation::Abomonation;

#[derive(Abomonation, PartialEq, Debug)]
struct MyStruct {
    a: u64,
    b: String,
    c: Vec<u8>,
}

// Now you can use `MyStruct` with `abomonation`'s `encode` and `decode`.

Attributes

  • #[abomonation_omit_bounds] : Omits automatic trait bound generation for the Abomonation trait.
  • #[abomonation_bounds(Trait1, Trait2)] : Adds custom trait bounds.
  • #[abomonate_with = "path::to::function"] : Specifies a custom method to use for serialization.
  • #[abomonation_skip] : Skips the field when serializing.

Limitations

The crate does not currently support union types. The use of unsafe is necessary due to the nature of abomonation's serialization technique.

Safety

This crate relies on the same unsafe serialization strategy as abomonation, and the same caveats apply. It is not suitable for untrusted inputs and requires care when used. For detailed information on the safety concerns and how to use this crate, consult the abomonation documentation.

License

This project is licensed under the MIT License, same as the original abomonation-derive crate.

Dependencies

~240–690KB
~16K SLoC