add comment apis

Author: AlexCXC

seatable_api/main.py

@@ -201,6 +201,42 @@ def _get_account_detail(self, account_name):
         data = parse_response(response)
         return data.get('account')
 
+    def _add_comment_url(self):
+        url = '%(server_url)s/api/v1/dtables/%(dtable_uuid)s/comments/' % {
+            'server_url': self.dtable_server_url,
+            'dtable_uuid': self.dtable_uuid
+        }
+        return url
+
+    def _get_comments_url(self):
+        url = '%(server_url)s/api/v2.1/dtables/%(dtable_uuid)s/comments/' % {
+            'server_url': self.server_url,
+            'dtable_uuid': self.dtable_uuid
+        }
+        return url
+
+    def _get_comments_count_url(self):
+        url = '%(server_url)s/api/v2.1/dtables/%(dtable_uuid)s/comments-count/' % {
+            'server_url': self.server_url,
+            'dtable_uuid': self.dtable_uuid
+        }
+        return url
+    
+    def _update_or_delete_comment_url(self, comment_id):
+        url = '%(server_url)s/api/v2.1/dtables/%(dtable_uuid)s/comments/%(comment_id)s/' % {
+            'server_url': self.server_url,
+            'dtable_uuid': self.dtable_uuid,
+            'comment_id': comment_id
+        }
+        return url
+
+    def _get_comments_within_days_url(self):
+        url = '%(server_url)s/api/v2.1/dtables/%(dtable_uuid)s/comments-within-days/' % {
+            'server_url': self.dtable_server_url,
+            'dtable_uuid': self.dtable_uuid
+        }
+        return url
+
     def send_email(self, account_name, msg,  **kwargs):
         msg_sender = self._get_msg_sender_by_account(account_name)
         if not msg_sender or msg_sender.msg_type != 'email':
@@ -944,7 +980,6 @@ def add_workflow_task_with_existed_row(self, workflow_token, row_id, initiator=N
         response = requests.post(url, data={'row_id': row_id, 'initiator': initiator}, headers=headers)
         return parse_response(response)['task']
 
-
     def big_data_insert_rows(self, table_name, rows_data):
         url = self._dtable_db_insert_rows_url()
         json_data = {
@@ -954,6 +989,75 @@ def big_data_insert_rows(self, table_name, rows_data):
         response = requests.post(url, json=json_data, headers=self.headers, timeout=self.timeout)
         return parse_response(response)
 
+    def add_comment(self, table_id, row_id, comment):
+        """
+        :param table_id: str
+        :param row_id: str
+        :param comment: str
+        :return: success response dict {'success': True}
+        """
+        url = self._add_comment_url()
+        params = {'table_id': table_id, 'row_id': row_id}
+        json_data = {'comment': str(comment)}
+        response = requests.post(url, params=params, json=json_data, headers=self.headers, timeout=self.timeout)
+        return parse_response(response)
+
+    def get_comments_count(self, row_id):
+        """
+        :param row_id: str
+        :return: int
+        """
+        url = self._get_comments_count_url()
+        params = {'row_id': row_id}
+        response = requests.get(url, params=params, headers=self.headers, timeout=self.timeout)
+        return parse_response(response)['count']
+
+    def get_comments(self, row_id, page=1, per_page=25):
+        """
+        :param row_id: str
+        :param page: str
+        :param per_page: str
+        :return: a dict of {'comments': <list>, 'count': <int>}
+        """
+        url = self._get_comments_url()
+        params = {
+            'row_id': row_id,
+            'page': page,
+            'per_page': per_page
+        }
+        response = requests.get(url, params=params, headers=self.headers, timeout=self.timeout)
+        return parse_response(response)
+
+    def resolve_comment(self, comment_id, resolved=True):
+        """
+        :param comment_id: str
+        :param resolved: bool
+        :return: success response dict {'success': True}
+        """
+        url = self._update_or_delete_comment_url(comment_id)
+        options = {'resovled': 'true' if resolved else 'false'}
+        data = {'options': options}
+        response = requests.get(url, json=data, headers=self.headers, timeout=self.timeout)
+        return parse_response(response)
+
+    def delete_comment(self, comment_id):
+        """
+        :param comment_id: str
+        :return: success response dict {'success': True}
+        """
+        url = self._update_or_delete_comment_url(comment_id)
+        response = requests.delete(url, headers=self.headers, timeout=self.timeout)
+        return parse_response(response)
+
+    def get_comments_within_days(self, days=3):
+        """
+        :param days: int
+        :return: list of comments
+        """
+        url = self._get_comments_within_days_url()
+        params = {'days': days}
+        response = requests.get(url, params=params, headers=self.headers, timeout=self.timeout)
+        return parse_response(response)['comment_list']
 
 
 class Account(object):