Add append option to the begining of the page (#424)

* Add append option to the begining of the page

* Refactor to have prepend and append method using the same with different value for top_of_page flag

Author: Ryukamusa

atlassian/confluence.py

@@ -785,31 +785,32 @@ def update_page(self, page_id, title, body, parent_id=None, type='page', represe
 
             return self.put('rest/api/content/{0}'.format(page_id), data=data)
 
-    def append_page(self, page_id, title, append_body, parent_id=None, type='page', representation='storage',
-                    minor_edit=False):
+    def _insert_to_existing_page(self, page_id, title, insert_body, parent_id=None, type='page', representation='storage',
+                    minor_edit=False, top_of_page=False):
         """
-        Append body to page if already exist
+        Insert body to a page if already exist
         :param parent_id:
         :param page_id:
         :param title:
-        :param append_body:
+        :param insert_body:
         :param type:
         :param representation: OPTIONAL: either Confluence 'storage' or 'wiki' markup format
         :param minor_edit: Indicates whether to notify watchers about changes.
             If False then notifications will be sent.
+        :param top_of_page: Option to add the content to the end of page body
         :return:
         """
         log.info('Updating {type} "{title}"'.format(title=title, type=type))
 
-        if self.is_page_content_is_already_updated(page_id, append_body, title):
+        if self.is_page_content_is_already_updated(page_id, insert_body, title):
             return self.get_page_by_id(page_id)
         else:
             version = self.history(page_id)['lastUpdated']['number'] + 1
             previous_body = (self.get_page_by_id(page_id, expand='body.storage').get('body') or {}).get(
                 'storage').get(
                 'value')
             previous_body = previous_body.replace('ó', u'ó')
-            body = previous_body + append_body
+            body = insert_body + previous_body if top_of_page else previous_body + insert_body
             data = {
                 'id': page_id,
                 'type': type,
@@ -824,6 +825,44 @@ def append_page(self, page_id, title, append_body, parent_id=None, type='page',
 
             return self.put('rest/api/content/{0}'.format(page_id), data=data)
 
+    def append_page(self, page_id, title, append_body, parent_id=None, type='page', representation='storage',
+                    minor_edit=False):
+        """
+        Append body to page if already exist
+        :param parent_id:
+        :param page_id:
+        :param title:
+        :param append_body:
+        :param type:
+        :param representation: OPTIONAL: either Confluence 'storage' or 'wiki' markup format
+        :param minor_edit: Indicates whether to notify watchers about changes.
+            If False then notifications will be sent.
+        :return:
+        """
+        log.info('Updating {type} "{title}"'.format(title=title, type=type))
+
+        return self._insert_to_existing_page(page_id, title, append_body, parent_id=parent_id, type=type, representation=representation,
+                    minor_edit=minor_edit, top_of_page=False)
+
+    def prepend_page(self, page_id, title, prepend_body, parent_id=None, type='page', representation='storage',
+                    minor_edit=False):
+        """
+        Append body to page if already exist
+        :param parent_id:
+        :param page_id:
+        :param title:
+        :param prepend_body:
+        :param type:
+        :param representation: OPTIONAL: either Confluence 'storage' or 'wiki' markup format
+        :param minor_edit: Indicates whether to notify watchers about changes.
+            If False then notifications will be sent.
+        :return:
+        """
+        log.info('Updating {type} "{title}"'.format(title=title, type=type))
+
+        return self._insert_to_existing_page(page_id, title, prepend_body, parent_id=parent_id, type=type, representation=representation,
+                    minor_edit=minor_edit, top_of_page=True)
+
     def update_or_create(self, parent_id, title, body, representation='storage', minor_edit=False):
         """
         Update page or create a page if it is not exists