perf: make it concise to hint lacking space_id.

Author: Itou-Ng

test/test_create_datasheet.py

@@ -1,7 +1,7 @@
 import unittest
 import warnings
 from vika import Vika
-from . import TEST_TABLE, TEST_API_BASE, TEST_API_TOKEN, TEST_SPACE_ID
+from . import TEST_API_BASE, TEST_API_TOKEN, TEST_SPACE_ID
 
 
 class TestCreateFields(unittest.TestCase):

vika/datasheet/datasheet.py

@@ -7,7 +7,7 @@
 import requests
 
 from vika.const import API_GET_DATASHEET_QS_SET, DEFAULT_PAGE_SIZE
-from vika.exceptions import ErrorSortParams, SpaceInfoLack
+from vika.exceptions import ErrorSortParams
 from vika.datasheet.field_manager import FieldManager
 from vika.datasheet.record import Record
 from vika.datasheet.record_manager import RecordManager
@@ -87,13 +87,13 @@ def create_field(self, data) -> PostMetaFieldResponse:
 
             :param dic data: api请求体，结构：{'type': str, 'name': str, 'property': obj}
             :return: 字段创建api返回结果
-            :raises SpaceInfoLack: 缺少空间站信息
+            :raises NameError: 缺少空间id信息
             :raises ServerError: 服务端错误
             :raises ResponseBodyParserError: 解析响应体失败
             :raises Exception: 其他异常，如：字段重名
         """
         if self.spc_id is None:
-            raise SpaceInfoLack("缺少空间信息")
+            raise NameError('maybe: vika.datasheet("dst_id") => vika.space("spc_id").datasheet("dst_id")')
         api_endpoint = urljoin(self.vika.api_base,
                                f"/fusion/v1/spaces/{self.spc_id}/datasheets/{self.id}/fields")
         resp = self.vika.request.post(api_endpoint, json=data)
@@ -104,13 +104,13 @@ def delete_field(self, field_id: str) -> bool:
 
             :param str field_id: 字段id
             :return: 字段是否删除成功
-            :raises SpaceInfoLack: 缺少空间站信息
+            :raises NameError: 缺少空间id信息
             :raises ServerError: 服务端错误
             :raises ResponseBodyParserError: 解析响应体失败
             :raises Exception: 其他异常，如：
         """
         if self.spc_id is None:
-            raise SpaceInfoLack("缺少空间信息")
+            raise NameError('maybe: vika.datasheet("dst_id") => vika.space("spc_id").datasheet("dst_id")')
         api_endpoint = urljoin(self.vika.api_base,
                                f"/fusion/v1/spaces/{self.spc_id}/datasheets/{self.id}/fields/{field_id}")
         resp = self.vika.request.delete(api_endpoint)

vika/datasheet/datasheet_manager.py

@@ -13,15 +13,15 @@ def create(self, data) -> PostDatasheetMetaResponseData:
 
             :param dict data:  新建表格属性
             :return: 新建表格id、创建时间戳和字段id、name信息
-            :raises SpaceInfoLack: 缺少空间站信息
+            :raises NameError: 缺少空间id信息
             :raises ServerError: 服务端错误
             :raises ResponseBodyParserError: 解析响应体失败
             :raises Exception: 其他异常
 
             :example:
             >>> vika = Vika('YOUR_API_TOKEN')
             >>> req_data = {'name': 'table_name'}
-            >>> rep = vika.space('YOUR_SPACE_ID').datasheet.create(req_data)
+            >>> rep = vika.space('YOUR_SPACE_ID').datasheets.create(req_data)
         """
         resp = self.spc.create_datasheet(data)
         return resp.data

vika/datasheet/field_manager.py

@@ -84,7 +84,7 @@ def create(self, data) -> Optional[MetaField]:
 
             :param dict data:  新建字段属性
             :return: 新建字段id和name
-            :raises SpaceInfoLack: 缺少空间站信息
+            :raises NameError: 缺少空间id信息
             :raises ServerError: 服务端错误
             :raises ResponseBodyParserError: 解析响应体失败
             :raises Exception: 其他异常，如：字段重名
@@ -105,7 +105,7 @@ def delete(self, fid_id: str) -> bool:
 
             :param str fid_id: 要删除的字段信息
             :return: 删除成功返回ture
-            :raises SpaceInfoLack: 缺少空间站信息
+            :raises NameError: 缺少空间id信息
             :raises ServerError: 服务端错误
             :raises ResponseBodyParserError: 解析响应体失败
             :raises Exception: 其他异常，如：字段id不存在

vika/exceptions.py

@@ -1,10 +1,3 @@
-class SpaceInfoLack(Exception):
-    """
-    缺少空间站信息
-    """
-    pass
-
-
 class DatasheetDoesNotExist(Exception):
     """
     数表不存在

vika/space/space.py

@@ -3,7 +3,6 @@
 from vika.datasheet import Datasheet, DatasheetManager
 from vika.types.response import PostDatasheetMetaResponse
 from urllib.parse import urljoin
-from vika.exceptions import SpaceInfoLack
 
 
 class Space:
@@ -36,13 +35,13 @@ def create_datasheet(self, data) -> PostDatasheetMetaResponse:
 
             :param dic data: api请求体，结构：{'name': 'table_name'}
             :return: 创建表格响应数据
-            :raises SpaceInfoLack: 缺少空间站信息
+            :raises NameError: 缺少空间id信息
             :raises ServerError: 服务端错误
             :raises ResponseBodyParserError: 解析响应体失败
             :raises Exception: 其他异常
         """
         if self.id is None:
-            raise SpaceInfoLack("缺少空间信息")
+            raise NameError('maybe: vika.datasheet("dst_id") => vika.space("spc_id").datasheet("dst_id")')
         api_endpoint = urljoin(self.vika.api_base,
                                f"/fusion/v1/spaces/{self.id}/datasheets")
         resp = self.vika.request.post(api_endpoint, json=data)