Support options debug

src/common/options.rs

@@ -658,6 +658,24 @@ impl Options {
     pub fn builder() -> OptionsBuilder {
         OptionsBuilder::new()
     }
+
+    /// Return the Options in urlencoded format. If serialization would
+    /// fail, this will also return an error.
+    ///
+    /// This is intended primarily to help with debugging API requests.
+    ///
+    /// ```
+    /// use deepgram::common::options::{DetectLanguage, Model, Options};
+    /// let options = Options::builder()
+    ///     .model(Model::Nova2)
+    ///     .detect_language(DetectLanguage::Enabled)
+    ///     .build();
+    /// assert_eq!(&options.urlencoded().unwrap(), "model=nova-2&detect_language=true")
+    /// ```
+    ///
+    pub fn urlencoded(&self) -> Result<String, serde_urlencoded::ser::Error> {
+        serde_urlencoded::to_string(SerializableOptions(self))
+    }
 }
 
 impl OptionsBuilder {

src/manage/keys/options.rs

@@ -55,6 +55,25 @@ impl Options {
     ) -> OptionsBuilder {
         OptionsBuilder::new(comment, scopes)
     }
+
+    /// Return the Options in json format. If serialization would
+    /// fail, this will also return an error.
+    ///
+    /// This is intended primarily to help with debugging API requests.
+    ///
+    /// ```
+    /// use deepgram::manage::keys::options::Options;
+    /// let options = Options::builder("API Key", ["member"])
+    ///     .tag(["my-tag", "another-tag"])
+    ///     .build();
+    /// assert_eq!(
+    ///     &options.json().unwrap(),
+    ///     r#"{"comment":"API Key","tags":["my-tag","another-tag"],"scopes":["member"]}"#)
+    /// ```
+    ///
+    pub fn json(&self) -> Result<String, serde_json::Error> {
+        serde_json::to_string(&SerializableOptions::from(self))
+    }
 }
 
 impl OptionsBuilder {
@@ -110,7 +129,7 @@ impl OptionsBuilder {
     /// #
     /// let options1 = Options::builder("New Key", ["member"])
     ///     .tag(["Tag 1"])
-    ///     .tag(["Tag 2"])
+    ///     .tag(vec!["Tag 2"])
     ///     .build();
     ///
     /// let options2 = Options::builder("New Key", ["member"])

src/manage/projects.rs

@@ -52,7 +52,7 @@ impl Projects<'_> {
     /// ```no_run
     /// # use std::env;
     /// #
-    /// # use deepgram::{manage::projects::options::Options, Deepgram, DeepgramError};
+    /// # use deepgram::{Deepgram, DeepgramError};
     /// #
     /// # #[tokio::main]
     /// # async fn main() -> Result<(), DeepgramError> {
@@ -86,7 +86,7 @@ impl Projects<'_> {
     /// ```no_run
     /// # use std::env;
     /// #
-    /// # use deepgram::{manage::projects::options::Options, Deepgram, DeepgramError};
+    /// # use deepgram::{Deepgram, DeepgramError};
     /// #
     /// # #[tokio::main]
     /// # async fn main() -> Result<(), DeepgramError> {
@@ -170,7 +170,7 @@ impl Projects<'_> {
     /// ```no_run
     /// # use std::env;
     /// #
-    /// # use deepgram::{manage::projects::options::Options, Deepgram, DeepgramError};
+    /// # use deepgram::{Deepgram, DeepgramError};
     /// #
     /// # #[tokio::main]
     /// # async fn main() -> Result<(), DeepgramError> {

src/manage/projects/options.rs

@@ -37,6 +37,26 @@ impl Options {
     pub fn builder() -> OptionsBuilder {
         OptionsBuilder::new()
     }
+
+    /// Return the Options in json format. If serialization would
+    /// fail, this will also return an error.
+    ///
+    /// This is intended primarily to help with debugging API requests.
+    ///
+    /// ```
+    /// use deepgram::manage::projects::options::Options;
+    /// let options = Options::builder()
+    ///     .company("Deepgram")
+    ///     .name("DG Project")
+    ///     .build();
+    /// assert_eq!(
+    ///     &options.json().unwrap(),
+    ///     r#"{"name":"DG Project","company":"Deepgram"}"#)
+    /// ```
+    ///
+    pub fn json(&self) -> Result<String, serde_json::Error> {
+        serde_json::to_string(&SerializableOptions::from(self))
+    }
 }
 
 impl OptionsBuilder {

src/manage/usage/get_fields_options.rs

@@ -37,6 +37,24 @@ impl Options {
     pub fn builder() -> OptionsBuilder {
         OptionsBuilder::new()
     }
+
+    /// Return the Options in urlencoded format. If serialization would
+    /// fail, this will also return an error.
+    ///
+    /// This is intended primarily to help with debugging API requests.
+    ///
+    /// ```
+    /// use deepgram::manage::usage::get_fields_options::Options;
+    /// let options = Options::builder()
+    ///     .start("2024-04-10T00:00:00Z")
+    ///     .end("2024-10-10")
+    ///     .build();
+    /// assert_eq!(&options.urlencoded().unwrap(), "start=2024-04-10T00%3A00%3A00Z&end=2024-10-10")
+    /// ```
+    ///
+    pub fn urlencoded(&self) -> Result<String, serde_urlencoded::ser::Error> {
+        serde_urlencoded::to_string(SerializableOptions::from(self))
+    }
 }
 
 impl OptionsBuilder {

src/manage/usage/get_usage_options.rs

@@ -61,6 +61,24 @@ impl Options {
     pub fn builder() -> OptionsBuilder {
         OptionsBuilder::new()
     }
+
+    /// Return the Options in urlencoded format. If serialization would
+    /// fail, this will also return an error.
+    ///
+    /// This is intended primarily to help with debugging API requests.
+    ///
+    /// ```
+    /// use deepgram::manage::usage::get_usage_options::{Options, Method};
+    /// let options = Options::builder()
+    ///     .method([Method::Sync, Method::Async])
+    ///     .ner(true)
+    ///     .build();
+    /// assert_eq!(&options.urlencoded().unwrap(), "method=sync&method=async&ner=true")
+    /// ```
+    ///
+    pub fn urlencoded(&self) -> Result<String, serde_urlencoded::ser::Error> {
+        serde_urlencoded::to_string(SerializableOptions::from(self))
+    }
 }
 
 impl OptionsBuilder {

src/manage/usage/list_requests_options.rs

@@ -56,6 +56,25 @@ impl Options {
     pub fn builder() -> OptionsBuilder {
         OptionsBuilder::new()
     }
+
+    /// Return the Options in urlencoded format. If serialization would
+    /// fail, this will also return an error.
+    ///
+    /// This is intended primarily to help with debugging API requests.
+    ///
+    /// ```
+    /// use deepgram::manage::usage::list_requests_options::Options;
+    /// let options = Options::builder()
+    ///     .start("2024-04-10T00:00:00Z")
+    ///     .end("2024-10-10")
+    ///     .limit(100)
+    ///     .build();
+    /// assert_eq!(&options.urlencoded().unwrap(), "start=2024-04-10T00%3A00%3A00Z&end=2024-10-10&limit=100")
+    /// ```
+    ///
+    pub fn urlencoded(&self) -> Result<String, serde_urlencoded::ser::Error> {
+        serde_urlencoded::to_string(SerializableOptions::from(self))
+    }
 }
 
 impl OptionsBuilder {

src/speak/options.rs

@@ -177,6 +177,24 @@ impl Options {
     pub fn builder() -> OptionsBuilder {
         OptionsBuilder::new()
     }
+
+    /// Return the Options in urlencoded format. If serialization would
+    /// fail, this will also return an error.
+    ///
+    /// This is intended primarily to help with debugging API requests.
+    ///
+    /// ```
+    /// use deepgram::speak::options::{Encoding, Model, Options};
+    /// let options = Options::builder()
+    ///     .model(Model::AuraArcasEn)
+    ///     .encoding(Encoding::Flac)
+    ///     .build();
+    /// assert_eq!(&options.urlencoded().unwrap(), "model=aura-arcas-en&encoding=flac")
+    /// ```
+    ///
+    pub fn urlencoded(&self) -> Result<String, serde_urlencoded::ser::Error> {
+        serde_urlencoded::to_string(SerializableOptions(self))
+    }
 }
 
 impl OptionsBuilder {