pincer.objects.application_command.ApplicationCommandOption.__post_init__() - Code Metrics - Inspection of ":twisted_rightwards_arrows: Merge with local" - Pincer-org/Pincer - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — main ( 0ee062...64dd9a )

unknown

created 2021-09-08 18:24 UTC

ApplicationCommandOption.__post_init__() A

↳ Parent: pincer.objects.application_command

Complexity

Conditions

Size

Total Lines	11
Code Lines	10

Duplication

Lines	0
Ratio	0 %

Importance

Changes

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

# -*- coding: utf-8 -*-

# MIT License
#
# Copyright (c) 2021 Pincer
#
# Permission is hereby granted, free of charge, to any person obtaining
# a copy of this software and associated documentation files
# (the "Software"), to deal in the Software without restriction,
# including without limitation the rights to use, copy, modify, merge,
# publish, distribute, sublicense, and/or sell copies of the Software,
# and to permit persons to whom the Software is furnished to do so,
# subject to the following conditions:
#
# The above copyright notice and this permission notice shall be
# included in all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
# IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
# CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

from __future__ import annotations

from dataclasses import dataclass
from enum import IntEnum
from typing import List, Union, Optional

from ..utils import APIObject, APINullable, Coro, convert, MISSING, Snowflake, \
    get_index


class ApplicationCommandType(IntEnum):
    """
    Defines the different types of application commands.

    :param CHAT_INPUT:
        Slash commands; a text-based command that shows up when a user
        types /

    :param USER:
        A UI-based command that shows up when you right click or tap on
        a user

    :param MESSAGE:
        A UI-based command that shows up when you right click or tap on
        a message
    """
    CHAT_INPUT = 1
    USER = 2
    MESSAGE = 3


class ApplicationCommandOptionType(IntEnum):
    """
    Represents a parameter type.

    :param SUB_COMMAND:
        The parameter will be a subcommand.

    :param SUB_COMMAND_GROUP:
        The parameter will be a group of subcommands.

    :param STRING:
        The parameter will be a string.

    :param INTEGER:
        The parameter will be an integer/number. (-2^53 and 2^53)

    :param BOOLEAN:
        The parameter will be a boolean.

    :param USER:
        The parameter will be a Discord user object.

    :param CHANNEL:
        The parameter will be a Discord channel object.

    :param ROLE:
        The parameter will be a Discord role object.

    :param MENTIONABLE:
        The parameter will be mentionable.

    :param NUMBER:
        The parameter will be a float. (-2^53 and 2^53)
    """
    SUB_COMMAND = 1
    SUB_COMMAND_GROUP = 2
    STRING = 3
    INTEGER = 4  # 54-bit
    BOOLEAN = 5
    USER = 6
    CHANNEL = 7
    ROLE = 8
    MENTIONABLE = 9
    NUMBER = 10  # 54-bit


@dataclass
class ApplicationCommandInteractionDataOption(APIObject):
    """
    Represents a Discord Application Command Interaction Data Option

    :param name:
        the name of the parameter

    :param type:
        value of application command option type

    :param value:
        the value of the pair

    :param options:
        present if this option is a group or subcommand
    """
    name: str
    type: int
    value: APINullable[ApplicationCommandOptionType] = MISSING
    options: APINullable[
        List[ApplicationCommandInteractionDataOption]] = MISSING

    def __post_init__(self):
        self.value = convert(self.value, ApplicationCommandOptionType)
        self.options = convert(
            self.options,
            ApplicationCommandInteractionDataOption.from_dict,
            ApplicationCommandInteractionDataOption
        )


@dataclass
class ApplicationCommandOptionChoice(APIObject):
    """
    Represents a Discord Application Command Option Choice object

    :param name:
        1-100 character choice name

    :param value:
        value of the choice, up to 100 characters if string
    """
    name: str
    value: Union[str, int, float]


@dataclass
class ApplicationCommandOption(APIObject):
    """
    Represents a Discord Application Command Option object

    :param type:
        the type of option

    :param name:
        1-32 lowercase character name matching `^[\w-]{1,32}$`

    :param description:
        1-100 character description

    :param required:
        if the parameter is required or optional--default `False`

    :param choices:
        choices for `STRING`, `INTEGER`, and `NUMBER`
        types for the user to pick from, max 25

    :param options:
        if the option is a subcommand or subcommand group type,
        this nested options will be the parameters
    """
    type: ApplicationCommandOptionType
    name: str
    description: str

    required: APINullable[bool] = False
    choices: APINullable[List[ApplicationCommandOptionChoice]] = MISSING
    options: APINullable[List[ApplicationCommandOption]] = MISSING

    def __post_init__(self):
        self.type = ApplicationCommandOptionType(self.type)
        self.choices = convert(
            self.choices,
            ApplicationCommandOptionChoice.from_dict,
            ApplicationCommandOptionChoice
        )
        self.options = convert(
            self.options,
            ApplicationCommandOption.from_dict,
            ApplicationCommandOption
        )


@dataclass

class ApplicationCommand(APIObject):
    """
    Represents a Discord Application Command object

    :param id:
        unique id of the command

    :param type:
        the type of command, defaults `1` if not set

    :param application_id:
        unique id of the parent application

    :param guild_id:
        guild id of the command, if not global

    :param name:
        1-32 character name

    :param description:
        1-100 character description for `CHAT_INPUT` commands,
        empty string for `USER` and `MESSAGE` commands

    :param options:
        the parameters for the command, max 25

    :param default_permission:
        whether the command is enabled by default
        when the app is added to a guild

    :param version:
        autoincrementing version identifier updated during substantial
        record changes
    """
    type: ApplicationCommandType
    name: str
    description: str

    id: APINullable[Snowflake] = MISSING
    version: APINullable[Snowflake] = MISSING
    application_id: APINullable[Snowflake] = MISSING
    options: APINullable[List[ApplicationCommandOption]] = MISSING
    guild_id: APINullable[Snowflake] = MISSING
    default_permission: APINullable[bool] = True

    _eq_props = [
        "type", "name", "description", "guild_id", "default_permission"
    ]

    # def __post_init__(self):
    #     self.id = convert(self.id, Snowflake.from_string)
    #     self.version = convert(self.version, Snowflake.from_string)
    #     self.application_id = convert(self.application_id,
    #                                   Snowflake.from_string)
    #     self.options = convert(
    #         self.options,
    #         ApplicationCommandOption.from_dict,
    #         ApplicationCommandOption
    #     )
    #     self.guild_id = convert(self.guild_id, Snowflake.from_string)

    def __eq__(self, other: Union[ApplicationCommand, ClientCommandStructure]):
        if isinstance(other, ClientCommandStructure):
            other = other.app

        is_equal = all(
            self.__getattribute__(prop) == other.__getattribute__(prop)
            for prop in self._eq_props
        )

        if is_equal and len(other.options) == len(self.options):
            for idx, option in enumerate(other.options):
                option_comp: Optional[ApplicationCommandOption] = \
                    get_index(self.options, idx)

                if not option_comp or \
                        option != ApplicationCommandOption.from_dict(
                    option_comp):

                    is_equal = False

        return is_equal

    def add_option(self, option: ApplicationCommandOption):
        """
        Add a new option field to the current application command.

        :param option: The option which will be appended.
        """
        if self.options:
            self.options.append(option)
        else:
            self.options = [option]


@dataclass
class ClientCommandStructure:
    """
    Represents the structure of how the client saves the existing
    commands in the register.

    :param app:
        The command application.

    :param call:
        The coroutine which should be called when the command gets
        executed.
    """
    app: ApplicationCommand
    call: Coro


1			# -- coding: utf-8 --
			0 ignored issues – show introduced 2021-09-06 08:54 UTC by Report Bug Copy Issue Report Missing module docstring Loading history...
2			# MIT License
3			#
4			# Copyright (c) 2021 Pincer
5			#
6			# Permission is hereby granted, free of charge, to any person obtaining
7			# a copy of this software and associated documentation files
8			# (the "Software"), to deal in the Software without restriction,
9			# including without limitation the rights to use, copy, modify, merge,
10			# publish, distribute, sublicense, and/or sell copies of the Software,
11			# and to permit persons to whom the Software is furnished to do so,
12			# subject to the following conditions:
13			#
14			# The above copyright notice and this permission notice shall be
15			# included in all copies or substantial portions of the Software.
16			#
17			# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
18			# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19			# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
20			# IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
21			# CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
22			# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
23			# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24
25			from __future__ import annotations
26
27			from dataclasses import dataclass
28			from enum import IntEnum
29			from typing import List, Union, Optional
30
31			from ..utils import APIObject, APINullable, Coro, convert, MISSING, Snowflake, \
32			get_index
33
34
35			class ApplicationCommandType(IntEnum):
36			"""
37			Defines the different types of application commands.
38
39			:param CHAT_INPUT:
40			Slash commands; a text-based command that shows up when a user
41			types /
42
43			:param USER:
44			A UI-based command that shows up when you right click or tap on
45			a user
46
47			:param MESSAGE:
48			A UI-based command that shows up when you right click or tap on
49			a message
50			"""
51			CHAT_INPUT = 1
52			USER = 2
53			MESSAGE = 3
54
55
56			class ApplicationCommandOptionType(IntEnum):
57			"""
58			Represents a parameter type.
59
60			:param SUB_COMMAND:
61			The parameter will be a subcommand.
62
63			:param SUB_COMMAND_GROUP:
64			The parameter will be a group of subcommands.
65
66			:param STRING:
67			The parameter will be a string.
68
69			:param INTEGER:
70			The parameter will be an integer/number. (-2^53 and 2^53)
71
72			:param BOOLEAN:
73			The parameter will be a boolean.
74
75			:param USER:
76			The parameter will be a Discord user object.
77
78			:param CHANNEL:
79			The parameter will be a Discord channel object.
80
81			:param ROLE:
82			The parameter will be a Discord role object.
83
84			:param MENTIONABLE:
85			The parameter will be mentionable.
86
87			:param NUMBER:
88			The parameter will be a float. (-2^53 and 2^53)
89			"""
90			SUB_COMMAND = 1
91			SUB_COMMAND_GROUP = 2
92			STRING = 3
93			INTEGER = 4 # 54-bit
94			BOOLEAN = 5
95			USER = 6
96			CHANNEL = 7
97			ROLE = 8
98			MENTIONABLE = 9
99			NUMBER = 10 # 54-bit
100
101
102			@dataclass
103			class ApplicationCommandInteractionDataOption(APIObject):
104			"""
105			Represents a Discord Application Command Interaction Data Option
106
107			:param name:
108			the name of the parameter
109
110			:param type:
111			value of application command option type
112
113			:param value:
114			the value of the pair
115
116			:param options:
117			present if this option is a group or subcommand
118			"""
119			name: str
120			type: int
121			value: APINullable[ApplicationCommandOptionType] = MISSING
122			options: APINullable[
123			List[ApplicationCommandInteractionDataOption]] = MISSING
124
125			def __post_init__(self):
126			self.value = convert(self.value, ApplicationCommandOptionType)
127			self.options = convert(
128			self.options,
129			ApplicationCommandInteractionDataOption.from_dict,
130			ApplicationCommandInteractionDataOption
131			)
132
133
134			@dataclass
135			class ApplicationCommandOptionChoice(APIObject):
136			"""
137			Represents a Discord Application Command Option Choice object
138
139			:param name:
140			1-100 character choice name
141
142			:param value:
143			value of the choice, up to 100 characters if string
144			"""
145			name: str
146			value: Union[str, int, float]
147
148
149			@dataclass
150			class ApplicationCommandOption(APIObject):
151			"""
152			Represents a Discord Application Command Option object
153
154			:param type:
155			the type of option
156
157			:param name:
158			1-32 lowercase character name matching `^[\w-]{1,32}$`
159
160			:param description:
161			1-100 character description
162
163			:param required:
164			if the parameter is required or optional--default `False`
165
166			:param choices:
167			choices for `STRING`, `INTEGER`, and `NUMBER`
168			types for the user to pick from, max 25
169
170			:param options:
171			if the option is a subcommand or subcommand group type,
172			this nested options will be the parameters
173			"""
174			type: ApplicationCommandOptionType
175			name: str
176			description: str
177
178			required: APINullable[bool] = False
179			choices: APINullable[List[ApplicationCommandOptionChoice]] = MISSING
180			options: APINullable[List[ApplicationCommandOption]] = MISSING
181
182			def __post_init__(self):
183			self.type = ApplicationCommandOptionType(self.type)
184			self.choices = convert(
185			self.choices,
186			ApplicationCommandOptionChoice.from_dict,
187			ApplicationCommandOptionChoice
188			)
189			self.options = convert(
190			self.options,
191			ApplicationCommandOption.from_dict,
192			ApplicationCommandOption
193			)
194
195
196			@dataclass
			0 ignored issues – show best-practice introduced 2021-09-07 19:46 UTC by Report Bug Copy Issue Report Too many instance attributes (10/7) Loading history...
197			class ApplicationCommand(APIObject):
198			"""
199			Represents a Discord Application Command object
200
201			:param id:
202			unique id of the command
203
204			:param type:
205			the type of command, defaults `1` if not set
206
207			:param application_id:
208			unique id of the parent application
209
210			:param guild_id:
211			guild id of the command, if not global
212
213			:param name:
214			1-32 character name
215
216			:param description:
217			1-100 character description for `CHAT_INPUT` commands,
218			empty string for `USER` and `MESSAGE` commands
219
220			:param options:
221			the parameters for the command, max 25
222
223			:param default_permission:
224			whether the command is enabled by default
225			when the app is added to a guild
226
227			:param version:
228			autoincrementing version identifier updated during substantial
229			record changes
230			"""
231			type: ApplicationCommandType
232			name: str
233			description: str
234
235			id: APINullable[Snowflake] = MISSING
236			version: APINullable[Snowflake] = MISSING
237			application_id: APINullable[Snowflake] = MISSING
238			options: APINullable[List[ApplicationCommandOption]] = MISSING
239			guild_id: APINullable[Snowflake] = MISSING
240			default_permission: APINullable[bool] = True
241
242			_eq_props = [
243			"type", "name", "description", "guild_id", "default_permission"
244			]
245
246			# def __post_init__(self):
247			# self.id = convert(self.id, Snowflake.from_string)
248			# self.version = convert(self.version, Snowflake.from_string)
249			# self.application_id = convert(self.application_id,
250			# Snowflake.from_string)
251			# self.options = convert(
252			# self.options,
253			# ApplicationCommandOption.from_dict,
254			# ApplicationCommandOption
255			# )
256			# self.guild_id = convert(self.guild_id, Snowflake.from_string)
257
258			def __eq__(self, other: Union[ApplicationCommand, ClientCommandStructure]):
259			if isinstance(other, ClientCommandStructure):
260			other = other.app
261
262			is_equal = all(
263			self.__getattribute__(prop) == other.__getattribute__(prop)
264			for prop in self._eq_props
265			)
266
267			if is_equal and len(other.options) == len(self.options):
268			for idx, option in enumerate(other.options):
269			option_comp: Optional[ApplicationCommandOption] = \
270			get_index(self.options, idx)
271
272			if not option_comp or \
273			option != ApplicationCommandOption.from_dict(
274			option_comp):
			0 ignored issues – show Coding Style introduced 2021-09-08 18:25 UTC by Report Bug Copy Issue Report Wrong hanging indentation before block. Loading history...
275			is_equal = False
276
277			return is_equal
278
279			def add_option(self, option: ApplicationCommandOption):
280			"""
281			Add a new option field to the current application command.
282
283			:param option: The option which will be appended.
284			"""
285			if self.options:
286			self.options.append(option)
287			else:
288			self.options = [option]
289
290
291			@dataclass
292			class ClientCommandStructure:
293			"""
294			Represents the structure of how the client saves the existing
295			commands in the register.
296
297			:param app:
298			The command application.
299
300			:param call:
301			The coroutine which should be called when the command gets
302			executed.
303			"""
304			app: ApplicationCommand
305			call: Coro
306

Pincer-org / Pincer

Push — main ( 0ee062...64dd9a )

ApplicationCommandOption.__post_init__() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like