Add Crowd a new attr

atlassian/crowd.py

@@ -2,6 +2,7 @@
 import logging
 
 from jmespath import search
+from lxml import etree
 
 from .rest_client import AtlassianRestAPI
 
@@ -264,3 +265,21 @@ def update_plugin_license(self, plugin_key, raw_license):
         url = "/plugins/1.0/{plugin_key}/license".format(plugin_key=plugin_key)
         data = {"rawLicense": raw_license}
         return self.put(url, data=data, headers=app_headers)
+
+    @property
+    def memberships(self):
+        """
+        Retrieves full details of all group memberships, with users and nested groups.
+        See: https://docs.atlassian.com/atlassian-crowd/5.3.1/REST/#usermanagement/1/group-getAllMemberships
+        :return: All membership mapping dict
+        """
+        path = self._crowd_api_url("usermanagement", "group/membership")
+        headers = {'Accept': 'application/xml'}
+        response = self.get(path, headers=headers, advanced_mode=True)
+        root = etree.fromstring(response.content)
+        memberships = {}
+        for member in root.xpath('//membership'):
+            group = member.get('group')
+            users = [user.get('name') for user in member.xpath('./users/user')]
+            memberships[group] = users
+        return memberships

docs/crowd.rst

@@ -38,3 +38,16 @@ Manage groups
     # Get group's members
     crowd.group_members(group, kind='direct', max_results=99999)
 
+Get memberships
+----------------
+
+.. code-block:: python
+
+    # Retrieves full details of all group memberships.
+    # Return data structure:
+    # {
+    #     GroupName1<str>: [ Member1<str>, Member2<str>, ... ],
+    #     GroupName2<str>: [ MemberA<str>, MemberB<str>, ... ],
+    #     ...
+    # }
+    crowd.memberships