apply suggestions

Co-authored-by Nerixyz <[email protected]>

Author: Emilgardis

examples/channel_information_custom.rs

@@ -27,7 +27,7 @@ async fn run() -> Result<(), Box<dyn std::error::Error + Send + Sync + 'static>>
 
     let resp = client
         .req_get_custom(
-            helix::channels::GetChannelInformationRequest::broadcaster_ids(vec![&token.user_id]),
+            helix::channels::GetChannelInformationRequest::broadcaster_ids(&token.user_id),
             &token,
         )
         .await

src/helix/client/client_ext.rs

@@ -970,7 +970,7 @@ impl<'client, C: crate::HttpClient + Sync + 'client> HelixClient<'client, C> {
         Ok(self.req_delete(req, token).await?.data)
     }
 
-    /// Get a users chat color
+    /// Update a user's chat color
     pub async fn update_user_chat_color<'b, T>(
         &'client self,
         user_id: impl types::IntoCow<'b, types::UserIdRef> + Send + 'b,
@@ -988,7 +988,9 @@ impl<'client, C: crate::HttpClient + Sync + 'client> HelixClient<'client, C> {
         Ok(self.req_put(req, helix::EmptyBody, token).await?.data)
     }
 
-    /// Get a users chat color
+    /// Get a user's chat color
+    ///
+    /// [`None`](Option::None) is returned if the user never set their color in the settings.
     pub async fn get_user_chat_color<T>(
         &'client self,
         user_id: impl Into<&types::UserIdRef> + Send,
@@ -1006,7 +1008,9 @@ impl<'client, C: crate::HttpClient + Sync + 'client> HelixClient<'client, C> {
             .first())
     }
 
-    /// Get multiple users chat colors
+    /// Get multiple users' chat colors
+    ///
+    /// Users that never set their color in the settings are not returned.
     ///
     /// # Examples
     ///
@@ -1217,9 +1221,6 @@ impl<'client, C: crate::HttpClient + Sync + 'client> HelixClient<'client, C> {
     where
         T: TwitchToken + Send + Sync + ?Sized,
     {
-        if ids.len() > 50 {
-            return Err(ClientRequestError::Custom("too many IDs, max 50".into()));
-        }
         Ok(self
             .req_get(
                 helix::points::GetCustomRewardRequest::broadcaster_id(broadcaster_id)
@@ -1276,8 +1277,9 @@ impl<'client, C: crate::HttpClient + Sync + 'client> HelixClient<'client, C> {
     ///
     /// # Notes
     ///
-    /// The return item is a struct [`EventSubSubscriptions`](helix::eventsub::EventSubSubscriptions) which contains the subscriptions.
-    /// See the example for getting only the subscriptions
+    /// The return item is a struct [`EventSubSubscriptions`](helix::eventsub::EventSubSubscriptions)
+    /// which contains a field with all the subscriptions.
+    /// See the example for collecting all _specific_ subscriptions
     ///
     /// # Examples
     ///

src/helix/endpoints/chat/get_emote_sets.rs

@@ -3,13 +3,14 @@
 //!
 //! # Accessing the endpoint
 //!
+//!
 //! ## Request: [GetEmoteSetsRequest]
 //!
 //! To use this endpoint, construct a [`GetEmoteSetsRequest`] with the [`GetEmoteSetsRequest::emote_set_ids()`] method.
 //!
 //! ```rust
 //! use twitch_api::helix::chat::get_emote_sets;
-//! let request = get_emote_sets::GetEmoteSetsRequest::emote_set_ids(&["1234"]);
+//! let request = get_emote_sets::GetEmoteSetsRequest::emote_set_ids(&"1234");
 //! ```
 //!
 //! ## Response: [Emote]
@@ -24,7 +25,7 @@
 //! # let client: helix::HelixClient<'static, client::DummyHttpClient> = helix::HelixClient::default();
 //! # let token = twitch_oauth2::AccessToken::new("validtoken".to_string());
 //! # let token = twitch_oauth2::UserToken::from_existing(&client, token, None, None).await?;
-//! let request = get_emote_sets::GetEmoteSetsRequest::emote_set_ids(&["1234"]);
+//! let request = get_emote_sets::GetEmoteSetsRequest::emote_set_ids(&"1234");
 //! let response: Vec<helix::chat::get_emote_sets::Emote> = client.req_get(request, &token).await?.data;
 //! # Ok(())
 //! # }

src/helix/endpoints/videos/delete_videos.rs

@@ -9,7 +9,7 @@
 //!
 //! ```rust
 //! use twitch_api::helix::videos::delete_videos;
-//! let request = delete_videos::DeleteVideosRequest::ids(&["1234"]);
+//! let request = delete_videos::DeleteVideosRequest::ids(&"1234");
 //! ```
 //!
 //! ## Response: [DeleteVideo]
@@ -24,7 +24,7 @@
 //! # let client: helix::HelixClient<'static, client::DummyHttpClient> = helix::HelixClient::default();
 //! # let token = twitch_oauth2::AccessToken::new("validtoken".to_string());
 //! # let token = twitch_oauth2::UserToken::from_existing(&client, token, None, None).await?;
-//! let request = delete_videos::DeleteVideosRequest::ids(&["1234"]);
+//! let request = delete_videos::DeleteVideosRequest::ids(&"1234");
 //! let response: delete_videos::DeleteVideo = client.req_delete(request, &token).await?.data;
 //! # Ok(())
 //! # }