Mark unstable parts of config unstable (#3215)

* Mark unstable parts of config unstable

* Unstable

Author: bjoernQ

esp-hal-procmacros/src/builder.rs

@@ -25,6 +25,8 @@ const KNOWN_HELPERS: &[&str] = &[
     "skip_setter",
     // Do not generate a getter
     "skip_getter",
+    // Feature gate the generated setters and getters by the "unstable" feature
+    "unstable",
 ];
 
 pub fn builder_lite_derive(item: TokenStream) -> TokenStream {
@@ -53,6 +55,15 @@ pub fn builder_lite_derive(item: TokenStream) -> TokenStream {
             continue;
         }
 
+        let unstable = if helper_attributes.iter().any(|h| h == "unstable") {
+            quote! {
+                #[cfg_attr(docsrs, doc(cfg(feature = "unstable")))]
+                #[cfg(feature = "unstable")]
+            }
+        } else {
+            quote! {}
+        };
+
         let field_ident = field.ident.as_ref().unwrap();
         let field_type = &field.ty;
 
@@ -86,6 +97,7 @@ pub fn builder_lite_derive(item: TokenStream) -> TokenStream {
         if !helper_attributes.iter().any(|h| h == "skip_setter") {
             fns.push(quote! {
                 #[doc = concat!(" Assign the given value to the `", stringify!(#field_ident) ,"` field.")]
+                #unstable
                 #[must_use]
                 pub fn #function_ident(mut self, #field_ident: #field_setter_type) -> Self {
                     self.#field_ident = #field_assigns;
@@ -97,6 +109,7 @@ pub fn builder_lite_derive(item: TokenStream) -> TokenStream {
                 let function_ident = format_ident!("with_{}_none", field_ident);
                 fns.push(quote! {
                     #[doc = concat!(" Set the value of `", stringify!(#field_ident), "` to `None`.")]
+                    #unstable
                     #[must_use]
                     pub fn #function_ident(mut self) -> Self {
                         self.#field_ident = None;
@@ -121,6 +134,7 @@ pub fn builder_lite_derive(item: TokenStream) -> TokenStream {
             });
             fns.push(quote! {
                 #(#docs)*
+                #unstable
                 pub fn #field_ident(&self) -> #field_type {
                     self.#field_ident
                 }

esp-hal/src/spi/master.rs

@@ -449,7 +449,7 @@ pub struct Config {
     frequency: Rate,
 
     /// The clock source
-    #[cfg_attr(not(feature = "unstable"), builder_lite(skip))]
+    #[builder_lite(unstable)]
     #[builder_lite(skip_setter)]
     clock_source: ClockSource,
 

esp-hal/src/uart.rs

@@ -242,6 +242,7 @@ pub struct Config {
     baudrate: u32,
     /// Determines how close to the desired baud rate value the driver should
     /// set the baud rate.
+    #[builder_lite(unstable)]
     baudrate_tolerance: BaudrateTolerance,
     /// Number of data bits in each frame (5, 6, 7, or 8 bits).
     data_bits: DataBits,
@@ -250,7 +251,7 @@ pub struct Config {
     /// Number of stop bits in each frame (1, 1.5, or 2 bits).
     stop_bits: StopBits,
     /// Clock source used by the UART peripheral.
-    #[cfg_attr(not(feature = "unstable"), builder_lite(skip))]
+    #[builder_lite(unstable)]
     clock_source: ClockSource,
     /// UART Receive part configuration.
     rx: RxConfig,