Confluence: Add space related methods

Author: gonchik

atlassian/confluence.py

@@ -1322,6 +1322,42 @@ def get_all_spaces(
             params["status"] = space_status
         return self.get(url, params=params)
 
+    def archive_space(self, space_key):
+        """
+        Archive space
+        :param space_key:
+        :return:
+        """
+        url = f"rest/api/space/{space_key}/archive"
+        return self.put(url)
+
+    def get_trashed_contents_by_space(self, space_key, cursor=None, expand=None, limit=100):
+        """
+        Get trashed contents by space
+        :param space_key:
+        :param cursor:
+        :param expand:
+        :param limit:
+        :return:
+        """
+        url = f"rest/api/space/{space_key}/content/trash"
+        params = {"limit": limit}
+        if cursor:
+            params["cursor"] = cursor
+        if expand:
+            params["expand"] = expand
+        return self.get(url, params=params)
+
+    def remove_trashed_contents_by_space(self, space_key):
+        """
+        Remove all content from the trash in the given space,
+        deleting them permanently.Example request URI:
+        :param space_key:
+        :return:
+        """
+        url = f"rest/api/space/{space_key}/content/trash"
+        return self.delete(url)
+
     def add_comment(self, page_id, text):
         """
         Add comment into page

docs/confluence.rst

@@ -246,6 +246,26 @@ Get spaces info
     # Get Space export download url
     confluence.get_space_export(space_key, export_type)
 
+Space
+-----
+
+.. code-block:: python
+
+    # Archive the given Space identified by spaceKey.
+    # This method is idempotent i.e.,
+    # if the Space is already archived then no action will be taken.
+    confluence.archive_space(space_key)
+
+    # Get trash contents of space
+    confluence.get_trashed_contents_by_space(space_key, cursor=None, expand=None, limit=100)
+
+    # Remove all trash contents of space
+    confluence.remove_trashed_contents_by_space(space_key)
+
+
+
+
+
 Get space permissions
 ---------------------