#traits #struct #getter-setter #mut #from-map

macro hashmap_derive

A proc_macro to derive the FromMap trait

1 unstable release

0.1.0 Jan 26, 2020

#36 in #getter-setter

Download history 231/week @ 2024-04-03 158/week @ 2024-04-10 154/week @ 2024-04-17 127/week @ 2024-04-24 110/week @ 2024-05-01 92/week @ 2024-05-08 119/week @ 2024-05-15 114/week @ 2024-05-22 119/week @ 2024-05-29 122/week @ 2024-06-05 80/week @ 2024-06-12 141/week @ 2024-06-19 133/week @ 2024-06-26 284/week @ 2024-07-03 524/week @ 2024-07-10 880/week @ 2024-07-17

1,841 downloads per month
Used in 8 crates (via from_map)

Unlicense OR MIT OR Apache-2.0

5KB
81 lines

shorthand

Crates.io: shorthand Documentation Build Status

shorthand is defined as a system of fast writing and that is exactly what this library is for; to remove the annoying boilerplate code, that comes with writing your own library.

What does this library do?

It makes coding in rust a lot more convenient, by deriving getters and setters for the fields of a struct.

use shorthand::ShortHand;

#[derive(ShortHand, Default)]
pub struct Example {
    number: usize,
    data: String,
}

let mut example = Example::default();

assert_eq!(example.number(), 0);
example.set_number(1);
assert_eq!(example.number(), 1);

assert_eq!(example.data(), &"".to_string());
example.set_data("hi".to_string());
assert_eq!(example.data(), &"hi".to_string());

Otherwise, you would have to write the this by hand

pub struct Example {
    number: usize,
    data: String,
}

#[allow(dead_code)]
impl Example {
    #[inline(always)]
    pub fn number(&self) -> usize { self.number }

    #[inline(always)]
    pub fn set_number(&mut self, value: usize) -> &mut Self {
        self.number = value;
        self
    }

    #[inline(always)]
    pub fn data(&self) -> &String { &self.data }

    #[inline(always)]
    pub fn set_data(&mut self, value: String) -> &mut Self {
        self.data = value;
        self
    }
}

How do I get started?

Simply add this library under [dependencies] to your Cargo.toml

[dependencies]
shorthand = "0.1"

You can then derive ShortHand for any struct

use shorthand::ShortHand;

#[derive(ShortHand)]
struct Example {
    field: usize,
}

You can find the documentation here.

Feature Requests and Bug Reports

Feel free to ask questions or report bugs here. There are no stupid questions.

This library should be as convenient as possible, so please do not hesitate to request a feature.

Reference

This library has been inspired by the following crates


lib.rs:

This crate only exists, because it is not possible to export a trait and a proc_macro in the same crate.

You should instead use the from_map crate.

Dependencies

~1.5MB
~34K SLoC