Added client.generate_uri, from #6

Author: treeben77

README.md

@@ -37,6 +37,10 @@ client.update_linked_roles_metadata([
     }
 ])
 
+@app.route('/')
+def main():
+  return redirect(client.generate_uri(scope=["identify", "connections", "guilds", "role_connections.write"]))
+
 @app.route("/oauth2")
 def oauth2():
     code = request.args.get("code")
@@ -52,4 +56,4 @@ def oauth2():
     return f"""{identify}<br><br>{connections}<br><br>{guilds}"""
 
 app.run("0.0.0.0", 8080)
-```
+```

discordoauth2/__init__.py

@@ -1,6 +1,7 @@
 import requests
 from datetime import datetime
-from typing import Optional
+from typing import Optional, Union, Literal
+from urllib import parse
 
 class PartialAccessToken():
     def __init__(self, access_token, client) -> None:
@@ -254,6 +255,28 @@ def revoke_token(self, token: str, token_type: str=None):
         elif response.status_code == 429: raise exceptions.RateLimited(f"You are being Rate Limited. Retry after: {response.json()['retry_after']}", retry_after=response.json()['retry_after'])
         else:
             raise exceptions.HTTPException(f"Unexpected HTTP {response.status_code}")
+    
+    def generate_uri(self, scope: Union[str, list[str]], state: Optional[str]=None, response_type: Literal["code", "token"]="code", guild_id=None, disable_guild_select=None, permissions=None) -> str:
+        """Creates an authorization uri with client information prefilled.
+        
+        scope: a string, or list of strings for the scope
+        state: optional state parameter. Optional but recommended.
+        response_type: either code, or token. token means the server can't access it, but the client can use it without converting.
+        guild_id: the guild ID to add a bot/webhook.
+        disable_guild_select: wether to allow the authorizing user to change the selected guild
+        permissions: the permission bitwise integer for the bot being added.
+        """
+        params = {
+            "client_id": self.id,
+            "scope": " ".join(scope) if type(scope) == list else scope,
+            "state": state,
+            "redirect_uri": self.redirect_url,
+            "response_type": response_type,
+            "guild_id": guild_id,
+            "disable_guild_select": disable_guild_select,
+            "permissions": permissions
+        }
+        return f"https://discord.com/oauth2/authorize?{parse.urlencode({key: value for key, value in params.items() if value is not None})}"
 
 class exceptions():
     class BaseException(Exception):

docs/source/client.rst

@@ -86,4 +86,17 @@ Client
 
    .. note::
 
-      The bot token is required to update metadata.
+      The bot token is required to update metadata.
+   
+   .. method:: generate_uri(metadata)
+
+      Creates an authorization uri with client information prefilled.
+
+      .. versionadded:: 1.1
+
+      :param Union[str, list[str]] scope: A list, or space-seperated string for the authorization scope
+      :param Optional[str] state: State parameter. It is recommended for security.
+      :param Optional[Literal["code", "token"]] response_type: either code, or token. token means the server can't access it, but the client can use it without converting.
+      :param Optional[Union[int, str]] guild_id: the guild ID to add a bot/webhook.
+      :param Optional[bool] disable_guild_select: wether to allow the authorizing user to change the selected guild
+      :param Optional[int] permissions: the permission bitwise integer for the bot being added.

example.py

@@ -31,8 +31,7 @@
 
 @app.route('/')
 def main():
-  # Your OAuth2 url, you can make one a https://discord.dev
-  return redirect("https://discord.com/api/oauth2/authorize")
+  return redirect(client.generate_uri(scope=["identify", "connections", "guilds", "guilds.member", "guilds.join", "role_connections.write"]))
 
 @app.route('/oauth2')
 def oauth():