pincer.objects.guild.permissions.Permissions.allow() - Code Metrics - Inspection of ":sparkles: Add permission handler" - Pincer-org/Pincer - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Pull Request — main (#378)

unknown

created 2022-01-14 09:31 UTC

Permissions.allow() A

↳ Parent: pincer.objects.guild.permissions

Complexity

Conditions

Size

Total Lines	11
Code Lines	7

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
eloc	7
dl	0
loc	11
rs	10
c	0
b	0
f	0
cc	3
nop	1

# Copyright Pincer 2021-Present

# Full MIT License can be found in `LICENSE` at the project root.

from __future__ import annotations

from dataclasses import dataclass
from enum import IntEnum
from typing import Tuple, Optional


class PermissionEnum(IntEnum):
    """
    Represents the permissions for a guild.
    """
    CREATE_INSTANT_INVITE = 1 << 0
    KICK_MEMBERS = 1 << 1
    BAN_MEMBERS = 1 << 2
    ADMINISTRATOR = 1 << 3
    MANAGE_CHANNELS = 1 << 4
    MANAGE_GUIlD = 1 << 5
    ADD_REACTIONS = 1 << 6
    VIEW_AUDIT_LOG = 1 << 7
    PRIORITY_SPEAKER = 1 << 8
    STREAM = 1 << 9
    VIEW_CHANNEL = 1 << 10
    SEND_MESSAGES = 1 << 11
    SEND_TTS_MESSAGES = 1 << 12
    MANAGE_MESSAGES = 1 << 13
    EMBED_LINKS = 1 << 14
    ATTACH_FILES = 1 << 15
    READ_MESSAGE_HISTORY = 1 << 16
    MENTION_EVERYONE = 1 << 17
    USE_EXTERNAL_EMOJIS = 1 << 18
    VIEW_GUILD_INSIGHTS = 1 << 19
    CONNECT = 1 << 20
    SPEAK = 1 << 21
    MUTE_MEMBERS = 1 << 22
    DEAFEN_MEMBERS = 1 << 23
    MOVE_MEMBERS = 1 << 24
    USE_VAD = 1 << 25
    CHANGE_NICKNAME = 1 << 26
    MANAGE_NICKNAMES = 1 << 27
    MANAGE_ROLES = 1 << 28
    MANAGE_WEBHOOKS = 1 << 29
    MANAGE_EMOJIS_AND_STICKERS = 1 << 30
    USE_APPLICATION_COMMANDS = 1 << 31
    REQUEST_TO_SPEAK = 1 << 32
    MANAGE_EVENTS = 1 << 33
    MANAGE_THREADS = 1 << 34
    CREATE_PUBLIC_THREADS = 1 << 35
    CREATE_PRIVATE_THREADS = 1 << 36
    USE_EXTERNAL_STICKERS = 1 << 37
    SEND_MESSAGES_IN_THREADS = 1 << 38
    START_EMBEDDED_ACTIVITIES = 1 << 39
    MODERATE_MEMBERS = 1 << 40


@dataclass
class Permissions:

    """
    Allows for easier access to the permissions

    Parameters
    ----------
    create_instant_invite: :class:Optional[:class:`bool`]
        Allows creation of instant invites
    kick_members: :class:Optional[:class:`bool`]
        Allows kicking members
    ban_members: :class:Optional[:class:`bool`]
        Allows banning members
    administrator: :class:Optional[:class:`bool`]
        Allows all permissions and bypasses channel permission overwrites
    manage_channels: :class:Optional[:class:`bool`]
        Allows management and editing of channels
    manage_guild: :class:Optional[:class:`bool`]
        Allows management and editing of the guild
    add_reactions: :class:Optional[:class:`bool`]
        Allows for the addition of reactions to messages
    view_audit_log: :class:Optional[:class:`bool`]
        Allows for viewing of audit logs
    priority_speaker: :class:Optional[:class:`bool`]
        Allows for using priority speaker in a voice channel
    stream: :class:Optional[:class:`bool`]
        Allows the user to go live
    view_channel: :class:Optional[:class:`bool`]
        Allows guild members to view a channel, which includes reading messages in text channels
    send_messages: :class:Optional[:class:`bool`]
        Allows for sending messages in a channel (does not allow sending messages in threads)
    send_tts_messages: :class:Optional[:class:`bool`]
        Allows for sending of tts messages
    manage_messages: :class:Optional[:class:`bool`]
        Allows for deletion of other users messages
    embed_links: :class:Optional[:class:`bool`]
        Links sent by users with this permission will be auto-embedded
    attach_files: :class:Optional[:class:`bool`]
        Allows for uploading images and files
    read_message_history: :class:Optional[:class:`bool`]
        Allows for reading of message history
    mention_everyone: :class:Optional[:class:`bool`]
        Allows for using the @everyone tag to notify all users in a channel, and the @here tag to notify all online users in a channel

    use_external_emojis: :class:Optional[:class:`bool`]
        Allows the usage of custom emojis from other servers
    view_guild_insights: :class:Optional[:class:`bool`]
        Allows for viewing of guild insights
    connect: :class:Optional[:class:`bool`]
        Allows for joining of a voice channel
    speak: :class:Optional[:class:`bool`]
        Allows for speaking in a voice channel
    mute_members: :class:Optional[:class:`bool`]
        Allows for muting members in a voice channel
    deafen_members: :class:Optional[:class:`bool`]
        Allows for deafening of members in a voice channel
    move_members: :class:Optional[:class:`bool`]
        Allows for moving of members between voice channels
    use_vad: :class:Optional[:class:`bool`]
        Allows for using voice activity detection in a voice channel
    change_nickname: :class:Optional[:class:`bool`]
        Allows for modification of own nickname
    manage_nicknames: :class:Optional[:class:`bool`]
        Allows for modification of other users nicknames
    manage_roles: :class:Optional[:class:`bool`]
        Allows for management and editing of roles
    manage_webhooks: :class:Optional[:class:`bool`]
        Allows for management and editing of webhooks
    manage_emojis_and_stickers: :class:Optional[:class:`bool`]
        Allows for management and editing of emojis and stickers
    use_application_commands: :class:Optional[:class:`bool`]
        Allows for using application-specific commands
    request_to_speak: :class:Optional[:class:`bool`]
        Allows for requesting to speak in a voice channel
    manage_events: :class:Optional[:class:`bool`]
        Allows for management and editing of events
    manage_threads: :class:Optional[:class:`bool`]
        Allows for management and editing of threads
    create_public_threads: :class:Optional[:class:`bool`]
        Allows for the creation of public threads
    create_private_threads: :class:Optional[:class:`bool`]
        Allows for the creation of private threads
    use_external_stickers: :class:Optional[:class:`bool`]
        Allows for the usage of stickers from other servers
    send_messages_in_threads: :class:Optional[:class:`bool`]
        Allows for sending messages in threads
    start_embedded_activities: :class:Optional[:class:`bool`]
        Allows for starting of embedded activities
    moderate_members: :class:Optional[:class:`bool`]
        Allows for moderation of members in a guild
    """

    create_instant_invite: Optional[bool] = None
    kick_members: Optional[bool] = None
    ban_members: Optional[bool] = None
    administrator: Optional[bool] = None
    manage_channels: Optional[bool] = None
    manage_guild: Optional[bool] = None
    add_reactions: Optional[bool] = None
    view_audit_log: Optional[bool] = None
    priority_speaker: Optional[bool] = None
    stream: Optional[bool] = None
    view_channel: Optional[bool] = None
    send_messages: Optional[bool] = None
    send_tts_messages: Optional[bool] = None
    manage_messages: Optional[bool] = None
    embed_links: Optional[bool] = None
    attach_files: Optional[bool] = None
    read_message_history: Optional[bool] = None
    mention_everyone: Optional[bool] = None
    use_external_emojis: Optional[bool] = None
    view_guild_insights: Optional[bool] = None
    connect: Optional[bool] = None
    speak: Optional[bool] = None
    mute_members: Optional[bool] = None
    deafen_members: Optional[bool] = None
    move_members: Optional[bool] = None
    use_vad: Optional[bool] = None
    change_nickname: Optional[bool] = None
    manage_nicknames: Optional[bool] = None
    manage_roles: Optional[bool] = None
    manage_webhooks: Optional[bool] = None
    manage_emojis_and_stickers: Optional[bool] = None
    use_application_commands: Optional[bool] = None
    request_to_speak: Optional[bool] = None
    manage_events: Optional[bool] = None
    manage_threads: Optional[bool] = None
    create_public_threads: Optional[bool] = None
    create_private_threads: Optional[bool] = None
    use_external_stickers: Optional[bool] = None
    send_messages_in_threads: Optional[bool] = None
    start_embedded_activities: Optional[bool] = None
    moderate_members: Optional[bool] = None

    def __setattr__(self, name: str, value: Optional[bool]) -> None:
        if not isinstance(value, bool) and value is not None:
            raise ValueError(f"Permission {name!r} must be a boolean or None")
        return super().__setattr__(name, value)

    @classmethod
    def from_ints(cls, allow: int, deny: int) -> Permissions:
        """
        Create a Permission object from an integer representation of the permissions (deny and allow)


        Parameters
        ----------
        allow: :class:`int`
            The integer representation of the permissions that are allowed
        deny: :class:`int`
            The integer representation of the permissions that are denied
        """
        clsobj = cls()

        for enum in PermissionEnum:
            value = None
            if enum.value & allow:
                value = True
            elif enum.value & deny:
                value = False

            setattr(clsobj, enum.name.lower(), value)

        return clsobj

    def to_ints(self) -> Tuple[int]:
        """
        Convert the Permission object to an integer representation of the permissions (deny and allow)


        Returns
        -------
        :class:`Tuple[:class:`int`]`
            The integer representation of the permissions that are allowed and denied
        """
        allow = 0
        deny = 0
        for enum in PermissionEnum:
            if getattr(self, enum.name.lower()):
                allow |= enum.value
            elif getattr(self, enum.name.lower()) is False:
                deny |= enum.value

        return allow, deny

    @property
    def allow(self) -> int:
        """
        Returns the integer representation of the permissions that are allowed
        """
        allow = 0
        for enum in PermissionEnum:
            if getattr(self, enum.name.lower()):
                allow |= enum.value

        return allow

    @property
    def deny(self) -> int:
        """
        Returns the integer representation of the permissions that are denied
        """
        deny = 0
        for enum in PermissionEnum:
            if getattr(self, enum.name.lower()) is False:
                deny |= enum.value

        return deny


1			# Copyright Pincer 2021-Present
			0 ignored issues – show introduced 2021-09-06 08:54 UTC by Report Bug Copy Issue Report Missing module docstring Loading history...
2			# Full MIT License can be found in `LICENSE` at the project root.
3
4			from __future__ import annotations
5
6			from dataclasses import dataclass
7			from enum import IntEnum
8			from typing import Tuple, Optional
9
10
11			class PermissionEnum(IntEnum):
12			"""
13			Represents the permissions for a guild.
14			"""
15			CREATE_INSTANT_INVITE = 1 << 0
16			KICK_MEMBERS = 1 << 1
17			BAN_MEMBERS = 1 << 2
18			ADMINISTRATOR = 1 << 3
19			MANAGE_CHANNELS = 1 << 4
20			MANAGE_GUIlD = 1 << 5
21			ADD_REACTIONS = 1 << 6
22			VIEW_AUDIT_LOG = 1 << 7
23			PRIORITY_SPEAKER = 1 << 8
24			STREAM = 1 << 9
25			VIEW_CHANNEL = 1 << 10
26			SEND_MESSAGES = 1 << 11
27			SEND_TTS_MESSAGES = 1 << 12
28			MANAGE_MESSAGES = 1 << 13
29			EMBED_LINKS = 1 << 14
30			ATTACH_FILES = 1 << 15
31			READ_MESSAGE_HISTORY = 1 << 16
32			MENTION_EVERYONE = 1 << 17
33			USE_EXTERNAL_EMOJIS = 1 << 18
34			VIEW_GUILD_INSIGHTS = 1 << 19
35			CONNECT = 1 << 20
36			SPEAK = 1 << 21
37			MUTE_MEMBERS = 1 << 22
38			DEAFEN_MEMBERS = 1 << 23
39			MOVE_MEMBERS = 1 << 24
40			USE_VAD = 1 << 25
41			CHANGE_NICKNAME = 1 << 26
42			MANAGE_NICKNAMES = 1 << 27
43			MANAGE_ROLES = 1 << 28
44			MANAGE_WEBHOOKS = 1 << 29
45			MANAGE_EMOJIS_AND_STICKERS = 1 << 30
46			USE_APPLICATION_COMMANDS = 1 << 31
47			REQUEST_TO_SPEAK = 1 << 32
48			MANAGE_EVENTS = 1 << 33
49			MANAGE_THREADS = 1 << 34
50			CREATE_PUBLIC_THREADS = 1 << 35
51			CREATE_PRIVATE_THREADS = 1 << 36
52			USE_EXTERNAL_STICKERS = 1 << 37
53			SEND_MESSAGES_IN_THREADS = 1 << 38
54			START_EMBEDDED_ACTIVITIES = 1 << 39
55			MODERATE_MEMBERS = 1 << 40
56
57
58			@dataclass
59			class Permissions:
			0 ignored issues – show best-practice introduced 2022-01-11 21:15 UTC by Report Bug Copy Issue Report Too many instance attributes (41/7) Loading history...
60			"""
61			Allows for easier access to the permissions
62
63			Parameters
64			----------
65			create_instant_invite: :class:Optional[:class:`bool`]
66			Allows creation of instant invites
67			kick_members: :class:Optional[:class:`bool`]
68			Allows kicking members
69			ban_members: :class:Optional[:class:`bool`]
70			Allows banning members
71			administrator: :class:Optional[:class:`bool`]
72			Allows all permissions and bypasses channel permission overwrites
73			manage_channels: :class:Optional[:class:`bool`]
74			Allows management and editing of channels
75			manage_guild: :class:Optional[:class:`bool`]
76			Allows management and editing of the guild
77			add_reactions: :class:Optional[:class:`bool`]
78			Allows for the addition of reactions to messages
79			view_audit_log: :class:Optional[:class:`bool`]
80			Allows for viewing of audit logs
81			priority_speaker: :class:Optional[:class:`bool`]
82			Allows for using priority speaker in a voice channel
83			stream: :class:Optional[:class:`bool`]
84			Allows the user to go live
85			view_channel: :class:Optional[:class:`bool`]
86			Allows guild members to view a channel, which includes reading messages in text channels
87			send_messages: :class:Optional[:class:`bool`]
88			Allows for sending messages in a channel (does not allow sending messages in threads)
89			send_tts_messages: :class:Optional[:class:`bool`]
90			Allows for sending of tts messages
91			manage_messages: :class:Optional[:class:`bool`]
92			Allows for deletion of other users messages
93			embed_links: :class:Optional[:class:`bool`]
94			Links sent by users with this permission will be auto-embedded
95			attach_files: :class:Optional[:class:`bool`]
96			Allows for uploading images and files
97			read_message_history: :class:Optional[:class:`bool`]
98			Allows for reading of message history
99			mention_everyone: :class:Optional[:class:`bool`]
100			Allows for using the @everyone tag to notify all users in a channel, and the @here tag to notify all online users in a channel
			0 ignored issues – show Coding Style introduced 2022-01-11 21:51 UTC by Report Bug Copy Issue Report This line is too long as per the coding-style (134/100). This check looks for lines that are too long. You can specify the maximum line length. Loading history...
101			use_external_emojis: :class:Optional[:class:`bool`]
102			Allows the usage of custom emojis from other servers
103			view_guild_insights: :class:Optional[:class:`bool`]
104			Allows for viewing of guild insights
105			connect: :class:Optional[:class:`bool`]
106			Allows for joining of a voice channel
107			speak: :class:Optional[:class:`bool`]
108			Allows for speaking in a voice channel
109			mute_members: :class:Optional[:class:`bool`]
110			Allows for muting members in a voice channel
111			deafen_members: :class:Optional[:class:`bool`]
112			Allows for deafening of members in a voice channel
113			move_members: :class:Optional[:class:`bool`]
114			Allows for moving of members between voice channels
115			use_vad: :class:Optional[:class:`bool`]
116			Allows for using voice activity detection in a voice channel
117			change_nickname: :class:Optional[:class:`bool`]
118			Allows for modification of own nickname
119			manage_nicknames: :class:Optional[:class:`bool`]
120			Allows for modification of other users nicknames
121			manage_roles: :class:Optional[:class:`bool`]
122			Allows for management and editing of roles
123			manage_webhooks: :class:Optional[:class:`bool`]
124			Allows for management and editing of webhooks
125			manage_emojis_and_stickers: :class:Optional[:class:`bool`]
126			Allows for management and editing of emojis and stickers
127			use_application_commands: :class:Optional[:class:`bool`]
128			Allows for using application-specific commands
129			request_to_speak: :class:Optional[:class:`bool`]
130			Allows for requesting to speak in a voice channel
131			manage_events: :class:Optional[:class:`bool`]
132			Allows for management and editing of events
133			manage_threads: :class:Optional[:class:`bool`]
134			Allows for management and editing of threads
135			create_public_threads: :class:Optional[:class:`bool`]
136			Allows for the creation of public threads
137			create_private_threads: :class:Optional[:class:`bool`]
138			Allows for the creation of private threads
139			use_external_stickers: :class:Optional[:class:`bool`]
140			Allows for the usage of stickers from other servers
141			send_messages_in_threads: :class:Optional[:class:`bool`]
142			Allows for sending messages in threads
143			start_embedded_activities: :class:Optional[:class:`bool`]
144			Allows for starting of embedded activities
145			moderate_members: :class:Optional[:class:`bool`]
146			Allows for moderation of members in a guild
147			"""
148
149			create_instant_invite: Optional[bool] = None
150			kick_members: Optional[bool] = None
151			ban_members: Optional[bool] = None
152			administrator: Optional[bool] = None
153			manage_channels: Optional[bool] = None
154			manage_guild: Optional[bool] = None
155			add_reactions: Optional[bool] = None
156			view_audit_log: Optional[bool] = None
157			priority_speaker: Optional[bool] = None
158			stream: Optional[bool] = None
159			view_channel: Optional[bool] = None
160			send_messages: Optional[bool] = None
161			send_tts_messages: Optional[bool] = None
162			manage_messages: Optional[bool] = None
163			embed_links: Optional[bool] = None
164			attach_files: Optional[bool] = None
165			read_message_history: Optional[bool] = None
166			mention_everyone: Optional[bool] = None
167			use_external_emojis: Optional[bool] = None
168			view_guild_insights: Optional[bool] = None
169			connect: Optional[bool] = None
170			speak: Optional[bool] = None
171			mute_members: Optional[bool] = None
172			deafen_members: Optional[bool] = None
173			move_members: Optional[bool] = None
174			use_vad: Optional[bool] = None
175			change_nickname: Optional[bool] = None
176			manage_nicknames: Optional[bool] = None
177			manage_roles: Optional[bool] = None
178			manage_webhooks: Optional[bool] = None
179			manage_emojis_and_stickers: Optional[bool] = None
180			use_application_commands: Optional[bool] = None
181			request_to_speak: Optional[bool] = None
182			manage_events: Optional[bool] = None
183			manage_threads: Optional[bool] = None
184			create_public_threads: Optional[bool] = None
185			create_private_threads: Optional[bool] = None
186			use_external_stickers: Optional[bool] = None
187			send_messages_in_threads: Optional[bool] = None
188			start_embedded_activities: Optional[bool] = None
189			moderate_members: Optional[bool] = None
190
191			def __setattr__(self, name: str, value: Optional[bool]) -> None:
192			if not isinstance(value, bool) and value is not None:
193			raise ValueError(f"Permission {name!r} must be a boolean or None")
194			return super().__setattr__(name, value)
195
196			@classmethod
197			def from_ints(cls, allow: int, deny: int) -> Permissions:
198			"""
199			Create a Permission object from an integer representation of the permissions (deny and allow)
			0 ignored issues – show Coding Style introduced 2022-01-11 21:51 UTC by Report Bug Copy Issue Report This line is too long as per the coding-style (101/100). This check looks for lines that are too long. You can specify the maximum line length. Loading history...
200
201			Parameters
202			----------
203			allow: :class:`int`
204			The integer representation of the permissions that are allowed
205			deny: :class:`int`
206			The integer representation of the permissions that are denied
207			"""
208			clsobj = cls()
209
210			for enum in PermissionEnum:
211			value = None
212			if enum.value & allow:
213			value = True
214			elif enum.value & deny:
215			value = False
216
217			setattr(clsobj, enum.name.lower(), value)
218
219			return clsobj
220
221			def to_ints(self) -> Tuple[int]:
222			"""
223			Convert the Permission object to an integer representation of the permissions (deny and allow)
			0 ignored issues – show Coding Style introduced 2022-01-11 21:51 UTC by Report Bug Copy Issue Report This line is too long as per the coding-style (102/100). This check looks for lines that are too long. You can specify the maximum line length. Loading history...
224
225			Returns
226			-------
227			:class:`Tuple[:class:`int`]`
228			The integer representation of the permissions that are allowed and denied
229			"""
230			allow = 0
231			deny = 0
232			for enum in PermissionEnum:
233			if getattr(self, enum.name.lower()):
234			allow \|= enum.value
235			elif getattr(self, enum.name.lower()) is False:
236			deny \|= enum.value
237
238			return allow, deny
239
240			@property
241			def allow(self) -> int:
242			"""
243			Returns the integer representation of the permissions that are allowed
244			"""
245			allow = 0
246			for enum in PermissionEnum:
247			if getattr(self, enum.name.lower()):
248			allow \|= enum.value
249
250			return allow
251
252			@property
253			def deny(self) -> int:
254			"""
255			Returns the integer representation of the permissions that are denied
256			"""
257			deny = 0
258			for enum in PermissionEnum:
259			if getattr(self, enum.name.lower()) is False:
260			deny \|= enum.value
261
262			return deny
263

Pincer-org / Pincer

Pull Request — main (#378)

Permissions.allow() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like