From edd3d47220a4a0b444b0a3ed2d192b7c98a2de6f Mon Sep 17 00:00:00 2001
From: Rapptz <rapptz@gmail.com>
Date: Wed, 21 Oct 2015 19:46:33 -0400
Subject: [PATCH] Add Client.replace_roles

---
 discord/client.py | 35 +++++++++++++++++++++++++++++++++--
 1 file changed, 33 insertions(+), 2 deletions(-)

diff --git a/discord/client.py b/discord/client.py
index 3730943fe..6053d7e3a 100644
--- a/discord/client.py
+++ b/discord/client.py
@@ -1086,8 +1086,10 @@ class Client(object):
 
         You must have the proper permissions to use this function.
 
+        This method **appends** a role to a member.
+
         :param member: The :class:`Member` to give roles to.
-        :param roles: The :class:`Role`s to give the member.
+        :param roles: An iterable of :class:`Role`s to give the member.
         :return: ``True`` if the operation was successful, ``False`` otherwise.
         """
 
@@ -1111,7 +1113,7 @@ class Client(object):
         You must have the proper permissions to use this function.
 
         :param member: The :class:`Member` to remove roles from.
-        :param roles: The :class:`Role`s to remove from the member.
+        :param roles: An iterable of :class:`Role`s to remove from the member.
         :return: ``True`` if the operation was successful, ``False`` otherwise.
         """
 
@@ -1138,6 +1140,35 @@ class Client(object):
 
         return False
 
+    def replace_roles(self, member, *roles):
+        """Replaces the :class:`Member`'s roles.
+
+        You must have the proper permissions to use this function.
+
+        This function **replaces** all roles that the member has.
+        For example if the member has roles ``[a, b, c]`` and the
+        call is ``client.replace_roles(member, d, e, c)` then
+        the member has the roles ``[d, e, c]``.
+
+        :param member: The :class:`Member` to replace roles for.
+        :param roles: An iterable of :class:`Role`s to replace with.
+        :return: ``True`` if the operation was successful, ``False`` otherwise.
+        """
+
+        url = '{0}/{1.server.id}/members/{1.id}'.format(endpoints.SERVERS, member)
+
+        payload = {
+            'roles': [role.id for role in roles]
+        }
+
+        response = requests.patch(url, headers=self.headers, json=payload)
+        log.debug(request_logging_format.format(response=response, name='replace_roles'))
+        if is_response_successful(response):
+            member.roles = list(roles)
+            return True
+
+        return False
+
     def create_role(self, server, **fields):
         """Creates a :class:`Role`.