fix: sort params parse (#8)

Author: mayneyao

README.md

@@ -207,7 +207,7 @@ _传入分页相关参数（pageNum、pageSize）时，SDK 不会再自动加载
 | viewId          | str            | 视图ID。默认为维格表中第一个视图。请求会返回视图中经过视图中筛选/排序后的结果 |                                       |
 | pageNum         | int            | 默认 1                                                                        |                                       |
 | pageSize        | int            | 默认 100 ， 最大 1000                                                         |                                       |
-| sort            | dict[]         | 指定排序的字段，会覆盖视图排序条件                                            | `[{ field: 'field1': order: 'asc' }]` |
+| sort            | dict[]         | 指定排序的字段，会覆盖视图排序条件                                            | `[{ field: 'field1', order: 'asc' }]` |
 | recordIds       | str[]          | 返回指定 recordId 的记录集                                                    | `['recordId1', 'recordId2']`          |
 | fields          | str[]          | 只有指定字段会返回                                                            |                                       |
 | filterByFormula | str            | 使用公式作为筛选条件，返回匹配的记录                                          |                                       |

setup.py

@@ -5,7 +5,7 @@
 
 setuptools.setup(
     name="vika",
-    version="0.1.1",
+    version="0.1.2",
     author="vikadata",
     author_email="[email protected]",
     description="维格表官方 Python SDK",

vika/exceptions.py

@@ -34,3 +34,10 @@ class ErrorFieldKey(Exception):
     """
 
     pass
+
+
+class ErrorSortParams(Exception):
+    """
+    错误的排序规则
+    """
+    pass

vika/vika.py

@@ -1,9 +1,11 @@
 from urllib.parse import urljoin, urlparse
 
 import requests
+import json
 
 from .const import API_BASE, API_GET_DATASHEET_QS_SET, DEFAULT_PAGE_SIZE
 from .datasheet import Datasheet
+from .exceptions import ErrorSortParams
 from .vika_type import RawGETResponse
 
 
@@ -41,11 +43,23 @@ def datasheet(self, dst_id_or_url, **kwargs):
             raise Exception("Bad URL")
         return Datasheet(self, dst_id, records=[], **kwargs)
 
+    @staticmethod
+    def check_sort_params(sort):
+        if not isinstance(sort, list):
+            return False
+        return all([('field' in i and 'order' in i) for i in sort])
+
     def fetch_datasheet(self, dst_id, **kwargs):
         params = {}
         for key in kwargs:
             if key in API_GET_DATASHEET_QS_SET:
-                params.update({key: kwargs.get(key)})
+                params_value = kwargs.get(key)
+                if key == 'sort':
+                    if self.check_sort_params(params_value):
+                        params_value = [json.dumps(i) for i in params_value]
+                    else:
+                        raise ErrorSortParams('sort 参数格式有误')
+                params.update({key: params_value})
         resp = self.request.get(
             urljoin(self.api_base, f"/fusion/v1/datasheets/{dst_id}/records"),
             params=params,