Add utility function for generating OAuth2 urls.

2 files changed, 21 insertions, 0 deletions

diff --git a/discord/utils.py b/discord/utils.py
index 20a91b6f..11dcb3f0 100644
--- a/discord/utils.py
+++ b/discord/utils.py
@@ -74,6 +74,25 @@ def parse_time(timestamp):
         return datetime.datetime(*map(int, re_split(r'[^\d]', timestamp.replace('+00:00', ''))))
     return None
 
+
+def oauth_url(client_id, permissions=None):
+    """A helper function that returns the OAuth2 URL for inviting the bot
+    into servers.
+
+    Parameters
+    -----------
+    client_id : str
+        The client ID for your bot.
+    permissions : :class:`Permissions`
+        The permissions you're requesting. If not given then you won't be requesting any
+        permissions.
+    """
+    url = 'https://discordapp.com/oauth2/authorize?&client_id={}&scope=bot'.format(client_id)
+    if permissions is not None:
+        url = url + '&permissions=' + str(permissions.value)
+    return url
+
+
 def snowflake_time(id):
     """Returns the creation date in UTC of a discord id."""
     return datetime.datetime.utcfromtimestamp(((int(id) >> 22) + DISCORD_EPOCH) / 1000)
diff --git a/docs/api.rst b/docs/api.rst
index f38fc70d..af746be3 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -335,6 +335,8 @@ Utility Functions
 
 .. autofunction:: discord.utils.snowflake_time
 
+.. autofunction:: discord.utils.oauth_url
+
 .. _discord-api-enums:
 
 Enumerations