updated examples and the fixed the join guild bug for this branch too

Author: treeben77

.gitignore

@@ -1,2 +1,3 @@
 main.py
-rewrite.py
+rewrite.py
+discordoauth2/__pycache__/

README.md

@@ -13,21 +13,38 @@ I've finally published the library to PyPi! So now you can use pip.
 pip install discord-oauth2.py
 ```
 ### Example With Flask
-Don't forget to replace all the client information on line 20 and 21 with your application's own information. You can leave bot token empty if your not adding members to guilds.
+Don't forget to replace all the client information with your application's own information. You can leave bot token empty if your not adding members to guilds.
 ```py
 import discordoauth2
 from flask import Flask, request
 
 client = discordoauth2.Client(849930878276993044, secret="very-secret-code",
-redirect="https://findingfakeurlsisprettyhard.tv/oauth2", bot_token="bot-token-only-required-for-guild-joining")
+redirect="https://findingfakeurlsisprettyhard.tv/oauth2", bot_token="bot-token-only-required-for-guild-joining-or-updating-linked-roles-metadata")
 app = Flask(__name__)
 
+client.update_linked_roles_metadata([
+    {
+        "type": 2,
+        "key": "level",
+        "name": "Level",
+        "description": "The level the user is on"
+    },
+    {
+        "type": 7,
+        "key": "supporter",
+        "name": "Supporter",
+        "description": "Spent money to help the game"
+    }
+])
+
 @app.route("/oauth2")
 def oauth2():
     code = request.args.get("code")
 
     access = client.exchange_code(code)
 
+    access.update_metadata("Platform Name", "Username",  level=69, supporter=True)
+
     identify = access.fetch_identify()
     connections = access.fetch_connections()
     guilds = access.fetch_guilds()

discordoauth2/__init__.py

@@ -58,8 +58,8 @@ def fetch_guild_member(self, guild_id):
         else:
             raise exceptions.HTTPException(f"Unexpected HTTP {response.status_code}")
 
-    def join_guild(self, guild_id, nick = None, role_ids = None, mute = False, deaf = False):
-        response = requests.put(f"https://discord.com/api/v10/guilds/{guild_id}/members/621878678405775379", headers={
+    def join_guild(self, guild_id, user_id, nick = None, role_ids = None, mute = False, deaf = False):
+        response = requests.put(f"https://discord.com/api/v10/guilds/{guild_id}/members/{user_id}", headers={
             "authorization": f"Bot {self.client._Client__bot_token}"
         }, json={
             "access_token": self.token,

discordoauth2/__pycache__/__init__.cpython-310.pyc

@@ -1,12 +1,33 @@
 from flask import Flask, redirect, request
-from discordoauth2 import discordOauth2
+import discordoauth2
 import os
 
 app = Flask('Discord OAuth2 Example')
-client = discordOauth2(client=your-client-id, secret="your-client-secret",
+client = discordoauth2.Client(client=your-client-id, secret="your-client-secret",
 redirect="your-redirect-url", token="your-bot-token (optional)")
 # Replace your-client-id with your application's client id, replace your-client-secret with your client secret and replace your-redirect-url with the url that discord will redirect users to once they complete OAuth2.
-# If you want to add users to a guild, insert a bot token with CREATE_INSTANT_INVITE permissions in the guilds you want to add users to.
+# If you want to updated linked roles metadata or add users to a guild, insert a bot token with CREATE_INSTANT_INVITE permissions in the guilds you want to add users to.
+
+client.update_linked_roles_metadata([
+    {
+        "type": 2,
+        "key": "level",
+        "name": "Level",
+        "description": "The level the user is on"
+    },
+    {
+        "type": 2,
+        "key": "wins",
+        "name": "Wins",
+        "description": "The number of times the user has won"
+    },
+    {
+        "type": 7,
+        "key": "supporter",
+        "name": "Supporter",
+        "description": "Spent money to help the game"
+    }
+])
 
 @app.route('/')
 def main():
@@ -15,19 +36,23 @@ def main():
 
 @app.route('/oauth2')
 def oauth():
-  tokenObject = client.exchange_code(token=request.args.get('code'))
-  print("refresh token: "+tokenObject.refresh_token)
+  access_token = client.exchange_code(token=request.args.get('code'))
+  print("refresh token: "+access_token.refresh)
 
   # returns basic data about the user, including username, avatar and badges, if the email scope was parsed, it will also return their email.
-  identify = tokenObject.access.identify()
+  identify = access_token.fetch_identify()
   # returns visible and hidden connections such as GitHub, YouTube or Twitter.
-  connections = tokenObject.access.connections()
+  connections = access_token.fetch_connections()
   # returns a list of guilds that the user is in
-  guilds = tokenObject.access.guilds()
+  guilds = access_token.fetch_guilds()
   # returns a member object for the provided guild
-  guilds_member = tokenObject.access.guilds_member(guilds[0]["id"])
+  guilds_member = access_token.fetch_guild_member(guilds[0]["id"])
   # makes a user join a guild, bot token provided must have CREATE_INSTANT_INVITE in that guild
-  tokenObject.access.guilds_join(guild-id-here)
+  access_token.join_guild(guild-id-here, identify["id"])
+  # this update's the user's metadata for linked roles.
+  access_token.update_metadata("Platform Name", "Username",  level=69, wins=420, supporter=True)
+  # when you're done with the token, you can revoke it: note this revokes both the access token and refresh token.
+  access_token.revoke()
 
   return f"{identify}<br><br>{connections}<br><br>{guilds}<br><br>guild data for the first guild: {guilds_member}"