Add some models classes

.gitignore

@@ -140,3 +140,4 @@ cython_debug/
 # Editors
 .vscode/
 .idea/
+.nova/

nextcord/core/gateway/gateway.py

@@ -36,9 +36,9 @@
     from typing import Any, Optional
 
     from nextcord.exceptions import NextcordException
-    from .protocols.shard import ShardProtocol
 
     from ...client.state import State
+    from .protocols.shard import ShardProtocol
 
 logger = getLogger(__name__)
 

nextcord/core/gateway/protocols/gateway.py

@@ -51,8 +51,12 @@ def should_reconnect(self, shard: ShardProtocol) -> bool:
     async def close(self) -> None:
         ...
 
-    def _shard_dispatch(self, event_name: str, shard: ShardProtocol, *args: Any) -> None:
+    def _shard_dispatch(
+        self, event_name: str, shard: ShardProtocol, *args: Any
+    ) -> None:
         ...
 
-    def _shard_raw_dispatch(self, opcode: int, shard: ShardProtocol, *args: Any) -> None:
+    def _shard_raw_dispatch(
+        self, opcode: int, shard: ShardProtocol, *args: Any
+    ) -> None:
         ...

nextcord/exceptions.py

@@ -25,3 +25,7 @@ def __init__(self) -> None:
             "You have been banned by Cloudflare. "
             "See https://discord.dev/topics/rate-limits#invalid-request-limit-aka-cloudflare-bans"
         )
+
+
+class InvalidArgument(NextcordException):
+    ...

nextcord/type_sheet.py

@@ -29,8 +29,8 @@
     T = TypeVar("T")
 
     from .core.gateway.gateway import GatewayProtocol
-    from .core.protocols.http import BucketProtocol, HTTPClientProtocol
     from .core.gateway.protocols.shard import ShardProtocol
+    from .core.protocols.http import BucketProtocol, HTTPClientProtocol
 
 
 @dataclass
@@ -49,5 +49,8 @@ def default(cls: Type[T]) -> T:
         from .core.http import HTTPClient as DefaultHTTPClient
 
         return cls(
-            http_client=DefaultHTTPClient, http_bucket=DefaultBucket, gateway=Gateway, shard=Shard
+            http_client=DefaultHTTPClient,
+            http_bucket=DefaultBucket,
+            gateway=Gateway,
+            shard=Shard,
         )

nextcord/types/allowed_mentions.py

@@ -0,0 +1,78 @@
+"""
+The MIT License (MIT)
+Copyright (c) 2021-present vcokltfre & tag-epic
+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 logging import getLogger
+from typing import TYPE_CHECKING, Union
+
+if TYPE_CHECKING:
+    ...
+
+
+Role, User = None  # TODO: DEFINE and import
+
+logger = getLogger(__name__)
+
+
+class AllowedMentions:
+    def __init__(
+        self,
+        *,
+        everyone: bool = False,
+        roles: Union[bool, list[Role], Role] = False,
+        users: Union[bool, User, list[User]] = True,
+        replied_user: bool = None,
+    ):
+        self.everyone = everyone
+        self.roles = roles
+        self.users = users
+        self.replied_user = replied_user
+
+    def to_dict(self):
+        allowed = {"parse": []}
+        if self.everyone:
+            allowed["parse"].append("everyone")
+
+        if isinstance(self.roles, bool) and self.roles:
+            allowed["parse"].append("roles")
+        elif isinstance(self.roles, list):
+            allowed["roles"] = [r.id for r in self.roles]
+        elif isinstance(self.roles, Role):
+            allowed["roles"] = [self.roles.id]
+
+        if isinstance(self.users, bool) and self.roles:
+            allowed["parse"].append("users")
+        elif isinstance(self.users, list):
+            allowed["users"] = [u.id for u in self.roles]
+        elif isinstance(self.users, User):
+            allowed["users"] = [self.users.id]
+
+        if self.replied_user:
+            allowed["replied_user"] = bool(self.replied_user)
+
+    @classmethod
+    def none(cls):
+        return cls.__init__(
+            everyone=False, roles=False, users=False, replied_user=False
+        )
+
+    @classmethod
+    def all(cls):
+        return cls.__init__(everyone=True, roles=True, users=True, replied_user=True)

nextcord/types/channel.py

@@ -0,0 +1,33 @@
+"""
+The MIT License (MIT)
+Copyright (c) 2021-present vcokltfre & tag-epic
+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 logging import getLogger
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..client.state import State
+
+logger = getLogger(__name__)
+
+
+class Channel:
+    def __init__(self, *, state: State, data: dict):
+        pass

nextcord/types/embed.py

@@ -0,0 +1,179 @@
+"""
+The MIT License (MIT)
+Copyright (c) 2021-present vcokltfre & tag-epic
+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 logging import getLogger
+from typing import TYPE_CHECKING, Optional
+
+if TYPE_CHECKING:
+    from datetime import datetime
+
+
+logger = getLogger(__name__)
+
+
+@dataclass(frozen=True)
+class EmbedFile:
+    url: str
+    proxy_url: Optional[str] = None
+    height: Optional[int] = None
+    width: Optional[int] = None
+
+
+@dataclass(frozen=True)
+class EmbedThumbnail(EmbedFile):
+    ...
+
+
+@dataclass(frozen=True)
+class EmbedVideo(EmbedFile):
+    url: Optional[str] = None
+
+
+@dataclass(frozen=True)
+class EmbedImage(EmbedFile):
+    ...
+
+
+@dataclass(frozen=True)
+class EmbedProvider:
+    name: Optional[str] = None
+    url: Optional[str] = None
+
+
+@dataclass(frozen=True)
+class EmbedAuthor:
+    name: str
+    url: Optional[str] = None
+    icon_url: Optional[str] = None
+    proxy_icon_url: Optional[str] = None
+
+
+@dataclass(frozen=True)
+class EmbedFooter:
+    text: str
+    icon_url: Optional[str] = None
+    proxy_icon_url: Optional[str] = None
+
+
+class EmbedField:
+    def __init__(self, name: str, value: str, *, inline: bool = None):
+        self.name = str(name)
+        self.value = str(value)
+        self.inline = bool(inline)
+
+
+class Embed:
+    __slots__ = (
+        "title",
+        "description",
+        "url",
+        "timestamp",
+        "color",
+        "footer",
+        "image",
+        "thumbnail",
+        "author",
+        "fields",
+        "provider",
+        "video",
+    )
+
+    def __init__(
+        self,
+        *,
+        title: Optional[str] = None,
+        description: Optional[str] = None,
+        url: Optional[str] = None,
+        timestamp: Optional[datetime] = None,
+        color: Optional[int] = None,
+        footer: Optional[EmbedFooter] = None,
+        image: Optional[EmbedImage] = None,
+        thumbnail: Optional[EmbedThumbnail] = None,
+        author: Optional[EmbedAuthor] = None,
+        fields: Optional[list[EmbedField]] = [],
+    ):
+        self.title = str(title) if title is not None else None
+        self.description = str(description) if description is not None else None
+        self.url = str(url) if url is not None else None
+        self.color = int(color) if color is not None else None
+        self.timestamp = timestamp
+
+        self.footer = footer if isinstance(footer, EmbedFooter) else None
+        self.image = image if isinstance(image, EmbedImage) else None
+        self.thumbnail = thumbnail if isinstance(thumbnail, EmbedThumbnail) else None
+        self.author = author if isinstance(author, EmbedAuthor) else None
+        self.fields = fields if isinstance(fields, list) else []
+
+    def add_field(
+        self, name: str, value: str, *, inline: bool = None, position: int = None
+    ) -> None:
+        if position is not None:
+            self.fields.insert(position, EmbedField(name, value, inline=inline))
+        else:
+            self.fields.append(EmbedField(name, value, inline=inline))
+
+    def edit_field(
+        self, index: int, name: str = None, value: str = None, *, inline: bool = None
+    ) -> None:
+        if name is not None:
+            self.fields[index].name = name
+        if value is not None:
+            self.fields[index].value = value
+        if inline is not None:
+            self.fields[index].inline = inline
+
+    def remove_field(self, *, index: int) -> None:
+        try:
+            del self.fields[index]
+        except IndexError:
+            pass
+
+    @property
+    def video(self):
+        return self._video
+
+    @property
+    def provider(self):
+        return self._provider
+
+    @classmethod
+    def from_dict(cls, data: dict):
+        embed = cls.__init__()
+        for key, value in data.items():
+            if key in ["video", "provider"]:
+                setattr(embed, "_" + key, value)
+            elif key in embed.__slots__:
+                setattr(embed, key, value)
+            else:
+                continue  # TODO: Unknown key, should it raise an error?
+
+        return embed
+
+    def to_dict(self):
+        data = {}
+        for key in self.__slots__:
+            if key in ["video", "provider"]:
+                data[key] = getattr(self, "_" + key)
+            else:
+                data[key] = getattr(self, key)
+
+        return data