shrinkwraprs
Making wrapper types allows us to give more compile-time guarantees about our code being correct:
// Now we can't mix up widths and heights; the compiler will yell at us!
;
;
But... they're kind of a pain to work with. If you ever need to get at
that wrapped u64
, you need to constantly pattern-match back and forth
to wrap and unwrap the values.
shrinkwraprs
aims to alleviate this pain by allowing you to derive
implementations of various conversion traits by deriving
Shrinkwrap
and ShrinkwrapMut
.
Traits implemented
Currently, using #[derive(Shrinkwrap)]
will derive the following traits
for all structs:
AsRef<InnerType>
Borrow<InnerType>
Deref<Target=InnerType>
Additionally, using #[derive(Shrinkwrap, ShrinkwrapMut)]
will also
derive the following traits:
AsMut<InnerType>
BorrowMut<InnerType>
DerefMut<Target=InnerType>
Cool, how do I use it?
First, add shrinkwraprs
as a dependency in your Cargo.toml
:
[]
= "0.1.0"
Then, just slap a #[derive(Shrinkwrap)]
on any structs you want
convenient-ified:
extern crate shrinkwraprs;
;
If you have multiple fields, but there's only one field you want to be able
to deref/borrow as, mark it with #[shrinkwrap(main_field)]
:
;
] Token)
If you also want to be able to modify the wrapped value directly,
derive ShrinkwrapMut
as well:
...
let mut input_buffer = /* ... */;
input_buffer.push_str;
...