feat(http): get guild role member counts (#2489)

Author: HTGAzureX1212

twilight-http/src/client/mod.rs

@@ -71,7 +71,8 @@ use crate::{
                 RemoveRoleFromMember, SearchGuildMembers, UpdateGuildMember,
             },
             role::{
-                CreateRole, DeleteRole, GetGuildRoles, GetRole, UpdateRole, UpdateRolePositions,
+                CreateRole, DeleteRole, GetGuildRoleMemberCounts, GetGuildRoles, GetRole,
+                UpdateRole, UpdateRolePositions,
             },
             sticker::{
                 CreateGuildSticker, DeleteGuildSticker, GetGuildSticker, GetGuildStickers,
@@ -1671,6 +1672,14 @@ impl Client {
         GetGuildRoles::new(self, guild_id)
     }
 
+    /// Get the role member counts of a guild.
+    pub const fn role_member_counts(
+        &self,
+        guild_id: Id<GuildMarker>,
+    ) -> GetGuildRoleMemberCounts<'_> {
+        GetGuildRoleMemberCounts::new(self, guild_id)
+    }
+
     /// Get a role of a guild.
     pub const fn role(&self, guild_id: Id<GuildMarker>, role_id: Id<RoleMarker>) -> GetRole<'_> {
         GetRole::new(self, guild_id, role_id)

twilight-http/src/request/guild/role/get_guild_role_member_counts.rs

@@ -0,0 +1,47 @@
+use crate::{
+    client::Client,
+    error::Error,
+    request::{Request, TryIntoRequest},
+    response::{Response, ResponseFuture},
+    routing::Route,
+};
+use std::{collections::HashMap, future::IntoFuture};
+use twilight_model::id::{
+    Id,
+    marker::{GuildMarker, RoleMarker},
+};
+
+#[must_use = "requests must be configured and executed"]
+pub struct GetGuildRoleMemberCounts<'a> {
+    guild_id: Id<GuildMarker>,
+    http: &'a Client,
+}
+
+impl<'a> GetGuildRoleMemberCounts<'a> {
+    pub(crate) const fn new(http: &'a Client, guild_id: Id<GuildMarker>) -> Self {
+        Self { guild_id, http }
+    }
+}
+
+impl IntoFuture for GetGuildRoleMemberCounts<'_> {
+    type Output = Result<Response<HashMap<Id<RoleMarker>, u64>>, Error>;
+
+    type IntoFuture = ResponseFuture<HashMap<Id<RoleMarker>, u64>>;
+
+    fn into_future(self) -> Self::IntoFuture {
+        let http = self.http;
+
+        match self.try_into_request() {
+            Ok(request) => http.request(request),
+            Err(source) => ResponseFuture::error(source),
+        }
+    }
+}
+
+impl TryIntoRequest for GetGuildRoleMemberCounts<'_> {
+    fn try_into_request(self) -> Result<Request, Error> {
+        Ok(Request::from_route(&Route::GetGuildRoleMemberCounts {
+            guild_id: self.guild_id.get(),
+        }))
+    }
+}

twilight-http/src/request/guild/role/mod.rs

@@ -1,11 +1,13 @@
 mod create_role;
 mod delete_role;
+mod get_guild_role_member_counts;
 mod get_guild_roles;
 mod get_role;
 mod update_role;
 mod update_role_positions;
 
 pub use self::{
-    create_role::CreateRole, delete_role::DeleteRole, get_guild_roles::GetGuildRoles,
+    create_role::CreateRole, delete_role::DeleteRole,
+    get_guild_role_member_counts::GetGuildRoleMemberCounts, get_guild_roles::GetGuildRoles,
     get_role::GetRole, update_role::UpdateRole, update_role_positions::UpdateRolePositions,
 };

twilight-http/src/request/try_into_request.rs

@@ -76,7 +76,8 @@ mod private {
                 RemoveRoleFromMember, SearchGuildMembers, UpdateGuildMember,
             },
             role::{
-                CreateRole, DeleteRole, GetGuildRoles, GetRole, UpdateRole, UpdateRolePositions,
+                CreateRole, DeleteRole, GetGuildRoleMemberCounts, GetGuildRoles, GetRole,
+                UpdateRole, UpdateRolePositions,
             },
             sticker::{
                 CreateGuildSticker, DeleteGuildSticker, GetGuildSticker, GetGuildStickers,
@@ -221,6 +222,7 @@ mod private {
     impl Sealed for GetGuildOnboarding<'_> {}
     impl Sealed for GetGuildPreview<'_> {}
     impl Sealed for GetGuildPruneCount<'_> {}
+    impl Sealed for GetGuildRoleMemberCounts<'_> {}
     impl Sealed for GetGuildRoles<'_> {}
     impl Sealed for GetGuildScheduledEvent<'_> {}
     impl Sealed for GetGuildScheduledEventUsers<'_> {}

twilight-http/src/routing.rs

@@ -648,6 +648,10 @@ pub enum Route<'a> {
         /// pruned.
         include_roles: &'a [Id<RoleMarker>],
     },
+    /// Route information to get guild's roles' member counts.
+    GetGuildRoleMemberCounts {
+        guild_id: u64,
+    },
     /// Route information to get guild's roles.
     GetGuildRoles {
         /// The ID of the guild.
@@ -1304,6 +1308,7 @@ impl Route<'_> {
             | Self::GetGuildPreview { .. }
             | Self::GetGuildPruneCount { .. }
             | Self::GetGuildRoles { .. }
+            | Self::GetGuildRoleMemberCounts { .. }
             | Self::GetGuildScheduledEvent { .. }
             | Self::GetGuildScheduledEventUsers { .. }
             | Self::GetGuildScheduledEvents { .. }
@@ -1715,6 +1720,12 @@ impl Display for Route<'_> {
 
                 f.write_str("/roles")
             }
+            Route::GetGuildRoleMemberCounts { guild_id } => {
+                f.write_str("guilds/")?;
+                Display::fmt(guild_id, f)?;
+
+                f.write_str("/roles/member-counts")
+            }
             Route::CreateStageInstance { .. } => f.write_str("stage-instances"),
             Route::CreateTemplate { guild_id } | Route::GetTemplates { guild_id } => {
                 f.write_str("guilds/")?;