mrkrk/melisa
1
0
Fork 0
mirror of https://github.com/MelisaDev/melisa.git synced 2024-09-22 19:22:01 +03:00
Code Issues Projects Releases Packages Wiki Activity Actions

feat(GuildMember): add [add_role(), remove_role()] methods

Browse source
This commit is contained in:
grey-cat-1908 2022-05-28 17:03:14 +03:00
parent 677f7de3e3
commit a229593d8e
2 changed files with 146 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

66
melisa/models/guild/member.py
View file

@ -242,3 +242,69 @@ class GuildMember(APIModelBase):
delete_message_days=delete_message_days,
reason=reason,
)
async def add_role(
self,
role_id: Union[Snowflake, str, int],
*,
reason: Optional[str] = None,
):
"""|coro|
Add a role to a guild member.
**Required permissions:** ``MANAGE_ROLES``
Parameters
----------
role_id: Optional[:class:`int`]
Id of role to add.
reason: Optional[:class:`str`]
The reason of the action.
Raises
-------
HTTPException
The request to perform the action failed with other http exception.
ForbiddenError
You do not have proper permissions to do the actions required.
BadRequestError
You provided a wrong guild, user or something else
"""
await self._client.rest.add_guild_member_role(
self.guild_id, self.user.id, role_id, reason=reason
)
async def remove_role(
self,
role_id: Union[Snowflake, str, int],
*,
reason: Optional[str] = None,
):
"""|coro|
Add a role to remove from a guild member.
**Required permissions:** ``MANAGE_ROLES``
Parameters
----------
role_id: Optional[:class:`int`]
Id of role to remove.
reason: Optional[:class:`str`]
The reason of the action.
Raises
-------
HTTPException
The request to perform the action failed with other http exception.
ForbiddenError
You do not have proper permissions to do the actions required.
BadRequestError
You provided a wrong guild, user or something else
"""
await self._client.rest.remove_guild_member_role(
self.guild_id, self.user.id, role_id, reason=reason
)

80
melisa/rest.py
View file

@ -534,3 +534,83 @@ class RESTApp:
data={"delete_message_days": delete_message_days},
headers={"X-Audit-Log-Reason": reason},
)
async def add_guild_member_role(
self,
guild_id: Union[Snowflake, str, int],
user_id: Union[Snowflake, str, int],
role_id: Union[Snowflake, str, int],
*,
reason: Optional[str] = None,
):
"""|coro|
[**REST API**] Adds a role to a guild member.
**Required permissions:** ``MANAGE_ROLES``
Parameters
----------
guild_id: Union[:class:`int`, :class:`str`, :class:`~.melisa.utils.snowflake.Snowflake`]
Id of guild where we will give member role
user_id: Union[:class:`int`, :class:`str`, :class:`~.melisa.utils.snowflake.Snowflake`]
Id of user to operate with.
role_id: Optional[:class:`int`]
Id of role to give.
reason: Optional[:class:`str`]
The reason of the action.
Raises
-------
HTTPException
The request to perform the action failed with other http exception.
ForbiddenError
You do not have proper permissions to do the actions required.
BadRequestError
You provided a wrong guild, user or something else
"""
await self._http.put(
f"guilds/{guild_id}/members/{user_id}/roles/{role_id}",
headers={"X-Audit-Log-Reason": reason},
)
async def remove_guild_member_role(
self,
guild_id: Union[Snowflake, str, int],
user_id: Union[Snowflake, str, int],
role_id: Union[Snowflake, str, int],
*,
reason: Optional[str] = None,
):
"""|coro|
[**REST API**] Removes a role from a guild member.
**Required permissions:** ``MANAGE_ROLES``
Parameters
----------
guild_id: Union[:class:`int`, :class:`str`, :class:`~.melisa.utils.snowflake.Snowflake`]
Id of guild where we will remove member role
user_id: Union[:class:`int`, :class:`str`, :class:`~.melisa.utils.snowflake.Snowflake`]
Id of user to operate with.
role_id: Optional[:class:`int`]
Id of role to remove.
reason: Optional[:class:`str`]
The reason of the action.
Raises
-------
HTTPException
The request to perform the action failed with other http exception.
ForbiddenError
You do not have proper permissions to do the actions required.
BadRequestError
You provided a wrong guild, user or something else
"""
await self._http.delete(
f"guilds/{guild_id}/members/{user_id}/roles/{role_id}",
headers={"X-Audit-Log-Reason": reason},
)