getset
Getset, we're ready to go!
A procedural macro for generating the most basic getters and setters on fields.
Getters are generated as fn field(&self) -> &type, while setters are generated as fn field(&mut self, val: type).
These macros are not intended to be used on fields which require custom logic inside of their setters and getters. Just write your own in that case!
```rust
use getset::{Getters, MutGetters, Setters};
[derive(Getters, Setters, MutGetters, Default)]
pub struct Foo
where
T: Copy + Clone + Default,
{
/// Doc comments are supported!
/// Multiline, even.
#[get]
#[set]
#[get_mut]
private: T,
/// Doc comments are supported!
/// Multiline, even.
#[get = "pub"]
#[set = "pub"]
#[get_mut = "pub"]
public: T,
}
fn main() {
let mut foo = Foo::default();
foo.setprivate(1);
(*foo.privatemut()) += 1;
assert_eq!(*foo.private(), 2);
}
```
The above structure definition generates the following output with cargo expand.
```rust
![feature(prelude_import)]
![no_std]
[prelude_import]
use ::std::prelude::v1::*;
[macro_use]
extern crate std as std;
use getset::{Getters, MutGetters, Setters};
pub struct Foo
where
T: Copy + Clone + Default,
{
/// Doc comments are supported!
/// Multiline, even.
#[get]
#[set]
#[getmut]
private: T,
/// Doc comments are supported!
/// Multiline, even.
#[get = "pub"]
#[set = "pub"]
#[getmut = "pub"]
public: T,
}
impl Foo
where
T: Copy + Clone + Default,
{
/// Doc comments are supported!
/// Multiline, even.
#[inline(always)]
fn private(&self) -> &T {
&self.private
}
/// Doc comments are supported!
/// Multiline, even.
#[inline(always)]
pub fn public(&self) -> &T {
&self.public
}
}
impl Foo
where
T: Copy + Clone + Default,
{
/// Doc comments are supported!
/// Multiline, even.
#[inline(always)]
fn setprivate(&mut self, val: T) -> &mut Self {
self.private = val;
self
}
/// Doc comments are supported!
/// Multiline, even.
#[inline(always)]
pub fn setpublic(&mut self, val: T) -> &mut Self {
self.public = val;
self
}
}
impl Foo
where
T: Copy + Clone + Default,
{
/// Doc comments are supported!
/// Multiline, even.
#[inline(always)]
fn privatemut(&mut self) -> &mut T {
&mut self.private
}
/// Doc comments are supported!
/// Multiline, even.
#[inline(always)]
pub fn publicmut(&mut self) -> &mut T {
&mut self.public
}
}
[automatically_derived]
[allow(unused_qualifications)]
impl ::core::default::Default for Foo
where
T: Copy + Clone + Default,
{
#[inline]
fn default() -> Foo {
Foo {
private: ::core::default::Default::default(),
public: ::core::default::Default::default(),
}
}
}
```
Attributes can be set on struct level for all fields in struct as well. Field level attributes take
precedence.
```rust
[macro_use]
extern crate getset;
mod submodule {
#[derive(Getters, Default)]
#[get = "pub"] // By default add a pub getting for all fields.
pub struct Foo {
public: i32,
#[get] // Override as private
private: i32,
}
fn demo() {
let mut foo = Foo::default();
foo.private();
}
}
fn main() {
let mut foo = submodule::Foo::default();
foo.public();
}
```
For some purposes, it's useful to have the get_ prefix on the getters for
either legacy of compatability reasons. It is done with get-prefix.
```rust
[macro_use]
extern crate getset;
[derive(Getters, Default)]
pub struct Foo {
#[get = "pub with_prefix"]
field: bool,
}
fn main() {
let mut foo = Foo::default();
let val = foo.get_field();
}
```