pincer.objects.guild.permissions.Permissions.from_int() - 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-12 14:16 UTC

Permissions.from_int() A

↳ Parent: pincer.objects.guild.permissions

Complexity

Conditions

Size

Total Lines	23
Code Lines	10

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
eloc	10
dl	0
loc	23
rs	9.9
c	0
b	0
f	0
cc	4
nop	3

# 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 Enum
from typing import Tuple, Optional


class PermissionEnum(Enum):
    """
    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_int(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:
            if bool(enum.value & allow):
                setattr(clsobj, enum.name.lower(), True)
            elif bool(enum.value & deny):
                setattr(clsobj, enum.name.lower(), False)
            else:
                setattr(clsobj, enum.name.lower(), None)

        return clsobj

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


        Returns
        _______
        :class:`Tuple[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 Enum
8			from typing import Tuple, Optional
9
10
11			class PermissionEnum(Enum):
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_int(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			if bool(enum.value & allow):
212			setattr(clsobj, enum.name.lower(), True)
213			elif bool(enum.value & deny):
214			setattr(clsobj, enum.name.lower(), False)
215			else:
216			setattr(clsobj, enum.name.lower(), None)
217
218			return clsobj
219
220			def to_int(self) -> Tuple[int]:
221			"""
222			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...
223
224			Returns
225			_______
226			:class:`Tuple[int]`
227			The integer representation of the permissions that are allowed and denied
228			"""
229			allow = 0
230			deny = 0
231			for enum in PermissionEnum:
232			if getattr(self, enum.name.lower()):
233			allow \|= enum.value
234			elif getattr(self, enum.name.lower()) is False:
235			deny \|= enum.value
236
237			return allow, deny
238
239			@property
240			def allow(self) -> int:
241			"""
242			Returns the integer representation of the permissions that are allowed
243			"""
244			allow = 0
245			for enum in PermissionEnum:
246			if getattr(self, enum.name.lower()):
247			allow \|= enum.value
248
249			return allow
250
251			@property
252			def deny(self) -> int:
253			"""
254			Returns the integer representation of the permissions that are denied
255			"""
256			deny = 0
257			for enum in PermissionEnum:
258			if getattr(self, enum.name.lower()) is False:
259			deny \|= enum.value
260
261			return deny
262

Pincer-org / Pincer

Pull Request — main (#378)

Permissions.from_int() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like