Add book entry

Author: BenFordTytherington

book/src/bridge/attributes.md

@@ -43,3 +43,8 @@ For [`#[qproperty]`](./extern_rustqt.md#properties), a CXX or Rust name can be p
 The `#[auto_cxx_name]` and `#[auto_rust_name]` attributes can be used to automatically rename cxx and rust names.
 These are placed at a block level on `extern "RustQt"` or `extern "C++Qt"` blocks, and will automatically case convert the items inside, unless they specify either a `rust_name` or `cxx_name`.
 By default `#[auto_cxx_name]` will generate a camelCase conversion for`cxx_name` and `#[auto_rust_name]` will generate a snake_case conversion for `rust_name`.
+
+### Automatic wrapping
+
+A fairly common operation is calling a method on the inner rust type, via the `.rust()` accessor. This can be simplified
+with the `#[auto_wrap]` attribute. This will generate a wrapper for your function which accesses the rust method of that name.

crates/cxx-qt-gen/src/generator/rust/method.rs

@@ -56,10 +56,16 @@ pub fn generate_rust_methods(
                 Some(quote! { unsafe })
             };
 
+            let method_safety = if invokable.safe {
+                None
+            } else {
+                Some(quote! { unsafe })
+            };
+
             let wrapper_fn = if invokable.wrap {
                 vec![parse_quote_spanned! {
                     invokable.method.span() =>
-                    #unsafe_call fn #invokable_ident_rust(#parameter_signatures) #return_type {
+                    #method_safety fn #invokable_ident_rust(#parameter_signatures) #return_type {
                         self.rust().#invokable_ident_rust(#call_parameters)
                     }
                 }]

crates/cxx-qt-gen/test_outputs/passthrough_and_naming.rs

@@ -780,7 +780,7 @@ cxx_qt::static_assertions::assert_eq_size!(
     cxx_qt::signalhandler::CxxQtSignalHandler<SecondObjectCxxQtSignalClosurepropertyNameChanged>,
     [usize; 2]
 );
-unsafe fn my_function(self: &SecondObject, param: i32) {
+fn my_function(self: &SecondObject, param: i32) {
     self.rust().my_function(param)
 }
 impl ffi::SecondObject {