deepfos 1.1.24__tar.gz → 1.1.26__tar.gz

{deepfos-1.1.24 → deepfos-1.1.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: deepfos
-Version: 1.1.24
+Version: 1.1.26
 Summary: Collecions of useful and handy tools for deepfos platform
 Home-page: http://py.deepfos.com
 Author: deepfos-python-team

{deepfos-1.1.24 → deepfos-1.1.26}/deepfos/_version.py

@@ -8,11 +8,11 @@ import json
 
 version_json = '''
 {
- "date": "2023-12-12T03:45:14+0000",
+ "date": "2023-12-28T02:24:37+0000",
  "dirty": false,
  "error": null,
- "full-revisionid": "c206dc5e4a3d9eb870bc032b55c17276ea7d9322",
- "version": "1.1.24"
+ "full-revisionid": "7b2975015e7105274b4054e1136a0dfc22361966",
+ "version": "1.1.26"
 }
 '''  # END VERSION_JSON
 

{deepfos-1.1.24 → deepfos-1.1.26}/deepfos/api/journal_model.py

@@ -30,7 +30,16 @@ class JournalModelData(ChildAPI):
         基于凭证模型的数据批量保存
         """
         return {'body': batch}
-    
+
+    @post('/data/update')
+    def update(self, batch: ModelDataBatchDTO) -> Union[CommonResultDTO, Awaitable[CommonResultDTO]]:
+        """
+        【★】凭证模型-数据-单条更新-只支持头行更新及行插入和删除
+
+        基于凭证模型的数据更新
+        """
+        return {'body': batch}
+
     @post('data/calc/net/amount')
     def calc_net_amount(self, param: JmPostParamVO) -> Union[JmPostResultVO, Awaitable[JmPostResultVO]]:
         """

{deepfos-1.1.24 → deepfos-1.1.26}/deepfos/api/models/financial_model.py

@@ -1159,6 +1159,8 @@ class ReactSpreadsheetSaveForm(BaseModel):
     wbName: Optional[str]
     #: 电子表格path
     wbPath: Optional[str]
+    #: 是否回调
+    callback: Optional[bool]
 
 
 class SheetColumnDto(BaseModel):

{deepfos-1.1.24 → deepfos-1.1.26}/deepfos/element/finmodel.py

@@ -44,8 +44,7 @@ from deepfos.api.models.financial_model import (
 from deepfos.api.models.base import BaseModel
 from deepfos.options import OPTION
 from deepfos.lib.decorator import cached_property
-from deepfos.exceptions import MDXExecuteTimeout
-
+from deepfos.exceptions import MDXExecuteTimeout, MDXExecuteFail
 
 __all__ = [
     'AsyncFinancialCube',
@@ -487,6 +486,7 @@ class AsyncFinancialCube(ElementBase[FinancialModelAPI]):
         need_check: bool = True,
         data_audit: bool = True,
         chunksize: Optional[int] = None,
+        callback: bool = True
     ):
         """
         将DataFrame的数据保存至cube。
@@ -499,6 +499,7 @@ class AsyncFinancialCube(ElementBase[FinancialModelAPI]):
             data_audit: 是否需要记录到数据审计
             chunksize: 单次调用保存接口时最大的dataframe行数。
               当data的行数超过此值时，将会分多次进行保存。
+            callback: 是否回调
 
         Note:
             此方法会对落库数据做以下处理：
@@ -539,7 +540,10 @@ class AsyncFinancialCube(ElementBase[FinancialModelAPI]):
         if missing_dims := required_cols - set(data.columns):
             raise ValueError(
                 f"Cannot save data because following columns are missing: {missing_dims}")
-        return await self._save_impl(data[list(required_cols)], pov, need_check, data_audit, chunksize)
+        return await self._save_impl(
+            data[list(required_cols)],
+            pov, need_check, data_audit, chunksize, callback
+        )
 
     async def save_unpivot(
         self,
@@ -550,6 +554,7 @@ class AsyncFinancialCube(ElementBase[FinancialModelAPI]):
         data_audit: bool = True,
         chunksize: Optional[int] = None,
         save_nan: bool = False,
+        callback: bool = True
     ):
         """保存有某个维度所有成员在列上的 ``DataFrame``
 
@@ -567,6 +572,7 @@ class AsyncFinancialCube(ElementBase[FinancialModelAPI]):
             chunksize: 单次调用保存接口时最大的dataframe行数。
               当data的行数超过此值时，将会分多次进行保存。
             save_nan: 当把数据列成员转换到行上时，data为空的数据是否保存
+            callback: 是否回调
 
         Warnings:
             由于数据完整性等原因，此方法接收的dataframe数据列经常会有一些额外的空值。
@@ -610,7 +616,9 @@ class AsyncFinancialCube(ElementBase[FinancialModelAPI]):
                 logger.info("Will not save to cube because dataframe is empty.")
                 return
 
-        return await self._save_impl(data, pov, need_check, data_audit, chunksize)
+        return await self._save_impl(
+            data, pov, need_check, data_audit, chunksize, callback
+        )
 
     async def _save_impl(
         self,
@@ -619,6 +627,7 @@ class AsyncFinancialCube(ElementBase[FinancialModelAPI]):
         need_check: bool = True,
         data_audit: bool = True,
         chunksize: Optional[int] = None,
+        callback: bool = True
     ):
         # replace NaN to standard None
         data = data.mask(data.isna(), None)
@@ -643,18 +652,20 @@ class AsyncFinancialCube(ElementBase[FinancialModelAPI]):
                 needCheck=need_check,
                 dataAuditSwitch=data_audit,
                 entryMode=1,
-                validateDimensionMember=need_check
+                validateDimensionMember=need_check,
+                callback=callback
+            )
+            r = await self.async_api.reactspreadsheet.save(
+                payload.dict(exclude_unset=True)
             )
-            r = await self.async_api.reactspreadsheet.save(payload.dict(exclude_unset=True))
             resp.append(r)
         return resp
 
-    async def delete(
+    async def delete_with_mdx(
         self,
-        expression: Union[str, Dict[str, Union[List[str], str]]],
-        chunksize: Optional[int] = None
+        expression: Union[str, Dict[str, Union[List[str], str]]]
     ):
-        """删除数据
+        """通过MDX脚本删除数据
 
         根据维度表达式删除Cube数据
 
@@ -665,7 +676,6 @@ class AsyncFinancialCube(ElementBase[FinancialModelAPI]):
 
         Args:
             expression: 维度表达式
-            chunksize: 目前使用MDX实现，已弃用(弃用版本: 1.1.24)，仅兼容旧版本保留
 
         .. admonition:: 示例
 
@@ -676,25 +686,20 @@ class AsyncFinancialCube(ElementBase[FinancialModelAPI]):
 
                 cube = FinancialCube('example')
                 expr = 'Year{2021;2022}->Entiy{Base(TotalEntity,0)}'
-                r = cube.delete(expr)
+                r = cube.delete_with_mdx(expr)
                 expr_dict = {
                     "Year": ['2021', '2022'],
                     "Entity": "Base(TotalEntity,0)"
                 }
-                r = cube.delete(expr_dict)
+                r = cube.delete_with_mdx(expr_dict)
 
         Returns:
-            删除结果
+            MDX执行结果
 
         See Also:
-            :meth:`insert_null`
+            :meth:`insert_null` :meth:`delete`
 
         """
-        if chunksize:
-            logger.warning(
-                'Parameter \'chunksize\' is deprecated since 1.1.24'
-            )
-
         if isinstance(expression, dict):
             expression = dict_to_expr(expression)
 
@@ -779,6 +784,69 @@ class AsyncFinancialCube(ElementBase[FinancialModelAPI]):
 
         return await self.mdx_execution(script)
 
+    async def delete(
+        self,
+        expression: Union[str, Dict[str, Union[List[str], str]]],
+        chunksize: Optional[int] = None,
+        use_mdx: bool = False,
+        callback: bool = True
+    ):
+        """删除数据
+
+        根据维度表达式删除Cube数据。
+
+        Warnings:
+            此方法首先查询数据，并且替换为null再调用保存接口。
+            因此如果要删除的数据量大，可能导致内存不足等问题。
+            如果不需要数据审计功能，请使用 :meth:`insert_null`
+
+        Args:
+            expression: 维度表达式
+            chunksize: 单次调用保存接口时最大的dataframe行数。
+              当data的行数超过此值时，将会分多次进行保存。
+            use_mdx: 是否使用MDX脚本实现，默认为否，等效于调用 :meth:`delete_with_mdx`
+            callback: 是否回调
+
+        .. admonition:: 示例
+
+            两种调用方式等价：
+
+            .. code-block:: python
+                :emphasize-lines: 3,8
+
+                cube = FinancialCube('example')
+                expr = 'Year{2021;2022}->Entiy{Base(TotalEntity,0)}'
+                r = cube.delete(expr)
+                expr_dict = {
+                    "Year": ['2021', '2022'],
+                    "Entity": "Base(TotalEntity,0)"
+                }
+                r = cube.delete(expr_dict)
+
+        Returns:
+            删除结果
+
+        See Also:
+            :meth:`insert_null` :meth:`delete_with_mdx`
+
+        """
+        if use_mdx:
+            return await self.delete_with_mdx(expression)
+
+        if self._meta.autoCalculation:
+            if isinstance(expression, str):
+                expression = expr_to_dict(expression)
+            expression = {**expression}
+
+        if isinstance(expression, dict):
+            expression = dict_to_expr(expression)
+
+        data, pov = await self.query(expression)
+        data[DFLT_DATA_COLUMN] = None
+        return await self.save(
+            data, pov, data_audit=True, chunksize=chunksize, callback=callback
+        )
+
     async def queries(
         self,
         expressions: Iterable[str],
@@ -1204,6 +1272,11 @@ class AsyncFinancialCube(ElementBase[FinancialModelAPI]):
         if res.status == 1:
             raise MDXExecuteTimeout(f'MDX执行超时，具体响应:\n{res}')
 
+        if res.result is False:
+            raise MDXExecuteFail(
+                f'MDX执行失败，失败原因:\n{res.failReason}'
+            )
+
         return res
 
 
@@ -1214,6 +1287,7 @@ class FinancialCube(AsyncFinancialCube, metaclass=SyncMeta):
         'save',
         'save_unpivot',
         'delete',
+        'delete_with_mdx',
         'pc_init',
         'pc_update',
         'pc_upsert',
@@ -1252,6 +1326,7 @@ class FinancialCube(AsyncFinancialCube, metaclass=SyncMeta):
             need_check: bool = True,
             data_audit: bool = True,
             chunksize: Optional[int] = None,
+            callback: bool = True
         ):
             ...
 
@@ -1264,13 +1339,22 @@ class FinancialCube(AsyncFinancialCube, metaclass=SyncMeta):
             data_audit: bool = True,
             chunksize: Optional[int] = None,
             save_nan: bool = False,
+            callback: bool = True
         ):
             ...
 
         def delete(
             self,
             expression: Union[str, Dict[str, Union[List[str], str]]],
-            chunksize: Optional[int] = None
+            chunksize: Optional[int] = None,
+            use_mdx: bool = False,
+            callback: bool = True
+        ):
+            ...
+
+        def delete_with_mdx(
+            self,
+            expression: Union[str, Dict[str, Union[List[str], str]]]
         ):
             ...