Skip to main content

twilight_http/request/guild/member/
get_guild_member_permissions.rs

1//! Request builder and response body for getting a guild member's permissions.
2
3use crate::{
4    client::Client,
5    error::Error,
6    request::{Request, TryIntoRequest},
7    response::{Response, ResponseFuture},
8    routing::Route,
9};
10use serde::Deserialize;
11use std::future::IntoFuture;
12use twilight_model::{
13    guild::Permissions,
14    id::{
15        Id,
16        marker::{GuildMarker, UserMarker},
17    },
18};
19
20/// Response body for the [`GetGuildMemberPermissions`] request.
21#[derive(Clone, Debug, Deserialize)]
22#[non_exhaustive]
23pub struct GetGuildMemberPermissionsResponseBody {
24    /// Computed permissions.
25    pub permissions: Permissions,
26}
27
28struct GetGuildMemberPermissionsPath {
29    guild_id: Id<GuildMarker>,
30    user_id: Id<UserMarker>,
31}
32
33/// Get a member's computed guild permissions, combining their roles with
34/// `@everyone`.
35#[must_use = "requests must be configured and executed"]
36pub struct GetGuildMemberPermissions<'a> {
37    http: &'a Client,
38    path: GetGuildMemberPermissionsPath,
39}
40
41impl<'a> GetGuildMemberPermissions<'a> {
42    pub(crate) const fn new(
43        http: &'a Client,
44        guild_id: Id<GuildMarker>,
45        user_id: Id<UserMarker>,
46    ) -> Self {
47        Self {
48            http,
49            path: GetGuildMemberPermissionsPath { guild_id, user_id },
50        }
51    }
52}
53
54impl IntoFuture for GetGuildMemberPermissions<'_> {
55    type Output = Result<Response<GetGuildMemberPermissionsResponseBody>, Error>;
56
57    type IntoFuture = ResponseFuture<GetGuildMemberPermissionsResponseBody>;
58
59    fn into_future(self) -> Self::IntoFuture {
60        let http = self.http;
61
62        match self.try_into_request() {
63            Ok(request) => http.request(request),
64            Err(source) => ResponseFuture::error(source),
65        }
66    }
67}
68
69impl TryIntoRequest for GetGuildMemberPermissions<'_> {
70    fn try_into_request(self) -> Result<Request, Error> {
71        let GetGuildMemberPermissionsPath { guild_id, user_id } = self.path;
72
73        Ok(Request::from_route(&Route::GetGuildMemberPermissions {
74            guild_id: guild_id.get(),
75            user_id: user_id.get(),
76        }))
77    }
78}