Merge OAuth2 featue in developer (#65)

feat: Implement Discord OAuth2 API as a sub-package #65

Author: mccoderpy

.gitignore

@@ -1,6 +1,6 @@
 todo.md
 test.py
-examples-test.py
+/local-tests/
 voice_test.py
 main-api.py
 cprint.py
@@ -17,3 +17,4 @@ __pycache__
 # Default ignored files
 /shelf/
 workspace.xml
+/loca-tests/

MANIFEST.in

@@ -1,6 +1,7 @@
 include README.rst
 include LICENSE.txt
 include discord/*
+include discord/oauth2/*
 include discord/bin/*.dll
 include discord/ext/commands/*
 include discord/ext/tasks/__init__.py

discord/abc.py

@@ -161,6 +161,7 @@ def __subclasshook__(cls, C):
             return True
         return NotImplemented
 
+
 class PrivateChannel(metaclass=abc.ABCMeta):
     """An ABC that details the common operations on a private Discord channel.
 
@@ -1112,9 +1113,10 @@ async def send(
         else:
             reference = MISSING
 
-        if suppress_embeds or suppress_notifications:
+        if suppress_embeds or suppress_notifications or is_voice_message:
             from .flags import MessageFlags
-            flags = MessageFlags._from_value(4)
+            flags = MessageFlags._from_value(0)
+            flags.suppress_embeds = suppress_embeds
             flags.suppress_notifications = suppress_notifications
         else:
             flags = MISSING

discord/appinfo.py

@@ -23,13 +23,47 @@
 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
 DEALINGS IN THE SOFTWARE.
 """
+from __future__ import annotations
+
+from typing import (
+    TYPE_CHECKING,
+    Optional,
+    List,
+    NamedTuple
+)
+from typing_extensions import Literal
+
 
 from . import utils
 from .user import User
 from .asset import Asset
 from .team import Team
 from .flags import ApplicationFlags
 
+if TYPE_CHECKING:
+    from .state import ConnectionState
+    from .guild import Guild
+    from .types.appinfo import AppInfo as AppInfoPayload
+
+__all__ = (
+    'InstallParams',
+    'AppInfo',
+)
+
+
+class InstallParams(NamedTuple):
+    """Represents the default install-parameters for an application.
+
+    Attributes
+    -------------
+    scopes: List[:class:`str`]
+        The scopes to add the application to the server with
+    permissions: :class:`str`
+        The permissions to request for the bot role
+    """
+    scopes: List[str]
+    permissions: str
+
 
 class AppInfo:
     """Represents the application info for the bot provided by Discord.
@@ -63,8 +97,11 @@ class AppInfo:
     summary: :class:`str`
         If this application is a game sold on Discord,
         this field will be the summary field for the store page of its primary SKU.
-
+        
+        Deprecated: This field is deprecated and will be removed in API v11
+        
         .. versionadded:: 1.3
+        .. deprecated:: 2.0
 
     verify_key: :class:`str`
         The hex encoded key for verification in interactions and the
@@ -99,7 +136,10 @@ class AppInfo:
 
     custom_install_url: Optional[:class:`str`]
         The default invite-url for the bot if its set.
-
+    
+    install_params: Optional[:class:`InstallParams`]
+        The settings for the application's default in-app authorization link, if enabled.
+    
     privacy_policy_url: Optional[:class:`str`]
         The link to this application's Privacy Policy if set.
 
@@ -114,43 +154,48 @@ class AppInfo:
                  'bot_public', 'bot_require_code_grant', 'owner', 'icon',
                  'summary', 'verify_key', 'team', 'guild_id', 'primary_sku_id',
                  'slug', 'custom_install_url', 'tags', '_flags', 'cover_image',
-                 'privacy_policy_url', 'terms_of_service_url', 'interactions_endpoint_url')
-
-    def __init__(self, state, data):
-        self._state = state
-        self.id = int(data['id'])
-        self.name = data['name']
-        self.description = data['description']
-        self.icon = data['icon']
-        self.rpc_origins = data['rpc_origins']
-        self.bot_public = data['bot_public']
-        self.bot_require_code_grant = data['bot_require_code_grant']
-        self.custom_install_url = data.get('custom_install_url', None)
-        self.tags = data.get('tags', [])
-        self._flags = data.get('flags', 0)
-        self.owner = User(state=self._state, data=data['owner'])
+                 'privacy_policy_url', 'terms_of_service_url', 'install_params',
+                 'interactions_endpoint_url')
+
+    def __init__(self, *, state: ConnectionState, data: AppInfoPayload):
+        self._state: ConnectionState = state
+        self.id: int = int(data['id'])
+        self.name: str = data['name']
+        self.description: str = data['description']
+        self.icon: str = data['icon']
+        self.rpc_origins: Optional[List[str]] = data['rpc_origins']
+        self.bot_public: bool = data['bot_public']
+        self.bot_require_code_grant: bool = data['bot_require_code_grant']
+        self.custom_install_url: Optional[str] = data.get('custom_install_url', None)
+        install_params = data.get('install_params', None)
+        
+        self.install_params: Optional[InstallParams] = InstallParams(install_params) if install_params else None
+        
+        self.tags: List[str] = data.get('tags', [])
+        self._flags: int = data.get('flags', 0)
+        self.owner: User = User(state=self._state, data=data['owner'])
 
         team = data.get('team')
-        self.team = Team(state, team) if team else None
+        self.team: Optional[Team] = Team(state, team) if team else None
 
-        self.summary = data['summary']
-        self.verify_key = data['verify_key']
+        self.summary = ''  # Deprecated - Will be removed in API v11
+        self.verify_key: str = data['verify_key']
 
-        self.guild_id = utils._get_as_snowflake(data, 'guild_id')
+        self.guild_id: Optional[int] = utils._get_as_snowflake(data, 'guild_id')
 
-        self.primary_sku_id = utils._get_as_snowflake(data, 'primary_sku_id')
-        self.slug = data.get('slug')
-        self.cover_image = data.get('cover_image')
-        self.privacy_policy_url = data.get('privacy_policy_url', None)
-        self.terms_of_service_url = data.get('terms_of_service_url', None)
-        self.interactions_endpoint_url = data.get('interactions_endpoint_url', None)
+        self.primary_sku_id: Optional[int] = utils._get_as_snowflake(data, 'primary_sku_id')
+        self.slug: Optional[str] = data.get('slug')
+        self.cover_image: Optional[str] = data.get('cover_image')
+        self.privacy_policy_url: Optional[str] = data.get('privacy_policy_url', None)
+        self.terms_of_service_url: Optional[str] = data.get('terms_of_service_url', None)
+        self.interactions_endpoint_url: Optional[str] = data.get('interactions_endpoint_url', None)
 
     def __repr__(self):
         return '<{0.__class__.__name__} id={0.id} name={0.name!r} description={0.description!r} public={0.bot_public} ' \
                'owner={0.owner!r}>'.format(self)
 
     @property
-    def icon_url(self):
+    def icon_url(self) -> Asset:
         """:class:`.Asset`: Retrieves the application's icon asset.
 
         This is equivalent to calling :meth:`icon_url_as` with
@@ -160,7 +205,12 @@ def icon_url(self):
         """
         return self.icon_url_as()
 
-    def icon_url_as(self, *, format='webp', size=1024):
+    def icon_url_as(
+            self,
+            *,
+            format: Literal['png', 'jpeg', 'jpg', 'webp'] = 'webp',
+            size=1024
+    ) -> Asset:
         """Returns an :class:`Asset` for the icon the application has.
 
         The format must be one of 'webp', 'jpeg', 'jpg' or 'png'.
@@ -187,9 +237,8 @@ def icon_url_as(self, *, format='webp', size=1024):
         """
         return Asset._from_icon(self._state, self, 'app', format=format, size=size)
 
-
     @property
-    def cover_image_url(self):
+    def cover_image_url(self) -> Asset:
         """:class:`.Asset`: Retrieves the cover image on a store embed.
 
         This is equivalent to calling :meth:`cover_image_url_as` with
@@ -199,7 +248,7 @@ def cover_image_url(self):
         """
         return self.cover_image_url_as()
 
-    def cover_image_url_as(self, *, format='webp', size=1024):
+    def cover_image_url_as(self, *, format='webp', size=1024) -> Asset:
         """Returns an :class:`Asset` for the image on store embeds
         if this application is a game sold on Discord.
 
@@ -228,7 +277,7 @@ def cover_image_url_as(self, *, format='webp', size=1024):
         return Asset._from_cover_image(self._state, self, format=format, size=size)
 
     @property
-    def guild(self):
+    def guild(self) -> Optional[Guild]:
         """Optional[:class:`Guild`]: If this application is a game sold on Discord,
         this field will be the guild to which it has been linked
 
@@ -237,5 +286,6 @@ def guild(self):
         return self._state._get_guild(int(self.guild_id))
 
     @property
-    def flags(self):
+    def flags(self) -> ApplicationFlags:
         return ApplicationFlags._from_value(self._flags)
+