Conlfunece: Subtree method

Author: Gonchik Tsymzhitov

atlassian/VERSION

@@ -1 +1 @@
-1.14.2
+1.14.3

atlassian/confluence.py

@@ -1321,3 +1321,18 @@ def add_user_to_group(self, username, group_name):
         data = {'name': username}
 
         return self.post(url, params=params, data=data)
+
+    def get_subtree_of_content_ids(self, page_id):
+        """
+        Get sub tree of page ids
+        :param page_id:
+        :return: Set of page ID
+        """
+        output = list()
+        output.append(page_id)
+        children_pages = self.get_page_child_by_type(page_id)
+        for page in children_pages:
+            child_subtree = self.get_subtree_of_content_ids(self, page.get('id'))
+            if child_subtree:
+                output.extend([p for p in child_subtree])
+        return set(output)

examples/confluence-subtree-cleaner.py

@@ -0,0 +1,23 @@
+# coding=utf-8
+from atlassian import Confluence
+
+"""
+This example shows how to clean page versions for subtree of pages 
+"""
+
+CONFLUENCE_URL = "confluence.example.com"
+CONFLUENCE_LOGIN = "gonchik.tsymzhitov"
+CONFLUENCE_PASSWORD = "passwordpassword"
+
+if __name__ == '__main__':
+    confluence = Confluence(
+        url=CONFLUENCE_URL,
+        username=CONFLUENCE_LOGIN,
+        password=CONFLUENCE_PASSWORD,
+        timeout=190
+    )
+    remained_count = 1
+
+    subtree = confluence.get_subtree_of_content_ids('123123')
+    for page_id in subtree:
+        confluence.remove_page_history_keep_version(page_id=page_id, keep_last_versions=remained_count)