Merge pull request #42 from rust-amplify/wrapper

Wrapper improvements

.rustfmt.toml

@@ -6,17 +6,17 @@ array_width = 100
 attr_fn_like_width = 100
 fn_call_width = 100
 
-format_code_in_doc_comments = true
+format_code_in_doc_comments = false
 fn_single_line = true
 format_macro_matchers = true
-format_macro_bodues = true
+format_macro_bodies = true
 format_strings = true
 merge_derives = false
 overflow_delimited_expr = true
 reorder_modules = false
 use_field_init_shorthand = true
 use_try_shorthand = true
-wrap_comments = true
+wrap_comments = false
 where_single_line = true
 unstable_features = true
 empty_item_single_line = true

src/lib.rs

@@ -648,11 +648,13 @@ pub fn derive_getters(input: TokenStream) -> TokenStream {
 /// * `amplify::Wrapper`
 /// * [`AsRef`]
 /// * [`core::borrow::Borrow`]
+/// You may skip `AsRef` and `Borrow` implementations with `#[wrapper(NoRefs)]`.
 ///
 /// You can implement additional derives, it they are implemented for the
 /// wrapped type, using `#[wrapper()]` proc macro:
 /// 1. Reference access to the inner type:
 /// * `Deref` for implementing [`core::ops::Deref`]
+/// * `AsSlice` for implementing [`AsRef`]`<[u8]>`
 /// * `BorrowSlice` for implementing
 /// [`core::borrow::Borrow`]`<[Self::Inner]>`
 /// 2. Formatting:
@@ -775,11 +777,14 @@ pub fn derive_wrapper(input: TokenStream) -> TokenStream {
 /// * `amplify::WrapperMut`
 /// * [`AsMut`]
 /// * [`core::borrow::BorrowMut`]
+/// You may skip `AsMut` and `BorrowMut` implementations with
+/// `#[wrapper_mut(NoRefs)]`.
 ///
 /// You can implement additional derives, it they are implemented for the
 /// wrapped type, using `#[wrapper()]` proc macro:
 /// 1. Reference access to the inner type:
 /// * `DerefMut` for implementing [`core::ops::DerefMut`]
+/// * `AsSliceMut` for implementing [`AsMut`]`<[u8]>`
 /// * `BorrowSliceMut` for implementing
 /// [`core::borrow::BorrowMut`]`<[Self::Inner]>`
 /// 2. Indexed access to the inner type:
@@ -832,7 +837,7 @@ pub fn derive_wrapper(input: TokenStream) -> TokenStream {
 /// Display
 /// )]
 /// #[display(inner)]
-/// #[wrapper(NumberFmt, MathOps, BoolOps)]
+/// #[wrapper(NumberFmt, MathOps, BoolOps, FromStr)]
 /// #[wrapper_mut(MathAssign, BitAssign)]
 /// struct Int64(i64);
 /// ```