[PM-3434] Password generator

crates/bitwarden/src/tool/generators/client_generator.rs

@@ -10,6 +10,27 @@ pub struct ClientGenerator<'a> {
 }
 
 impl<'a> ClientGenerator<'a> {
+    /// Generates a random password.
+    ///
+    /// The character sets and password length can be customized using the `input` parameter.
+    ///
+    /// # Examples
+    ///
+    /// ```
+    /// use bitwarden::{Client, tool::PasswordGeneratorRequest, error::Result};
+    /// async fn test() -> Result<()> {
+    ///     let input = PasswordGeneratorRequest {
+    ///         lowercase: true,
+    ///         uppercase: true,
+    ///         numbers: true,
+    ///         length: 20,
+    ///         ..Default::default()
+    ///     };
+    ///     let password = Client::new(None).generator().password(input).await.unwrap();
+    ///     println!("{}", password);
+    ///     Ok(())
+    /// }
+    /// ```
     pub async fn password(&self, input: PasswordGeneratorRequest) -> Result<String> {
         password(input)
     }