polyapi 5.9.13__tar.gz → 5.9.14__tar.gz

{polyapi-5.9.13 → polyapi-5.9.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: polyapi
-Version: 5.9.13
+Version: 5.9.14
 Summary: Wrapper for Polymatica API
 Home-page: https://www.polymatica.ru
 Author: Polymatica Rus LLC

{polyapi-5.9.13 → polyapi-5.9.14}/polyapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: polyapi
-Version: 5.9.13
+Version: 5.9.14
 Summary: Wrapper for Polymatica API
 Home-page: https://www.polymatica.ru
 Author: Polymatica Rus LLC

{polyapi-5.9.13 → polyapi-5.9.14}/polymatica/business_scenarios.py

@@ -41,6 +41,7 @@ from polymatica.common import (
     POSITION_MAP,
     ROOT_PARENT,
     TYPES_MAP,
+    UNITS_LOAD_DATA_CHUNK,
     UPDATE_PERIOD,
     TypeConverter,
     json_type,
@@ -90,8 +91,6 @@ from polymatica.helper import Helper
 logger = logging.getLogger(__name__)
 logger.addHandler(NullHandler())
 
-UNITS_LOAD_DATA_CHUNK = 1000
-
 
 # ----------------------------------------------------------------------------------------------------------------------
 
@@ -208,6 +207,7 @@ class BusinessLogic:
         jupiter: bool = False,
         language: str = "ru",
         suffixes_url: List = None,
+        script_mode: bool = False
     ):
         """
         Инициализация класса BusinessLogic.
@@ -225,6 +225,8 @@ class BusinessLogic:
         :param language: (необязательный) язык локализации; возможны значения: "ru"/"en"/"de"/"fr"; по-умолчанию "ru".
         :param suffixes_url: (необязательный) список возможных суффиксов URL-адреса стенда Полиматики;
             рекомендуется не задавать этот параметр без острой на то необходимости.
+        :param script_mode: (необязательный) используется ли класс BusinessLogic для специального скрипта,
+            по умолчанию False, внутренний параметр.
         """
         logger.info("BusinessLogic init")
 
@@ -357,6 +359,7 @@ class BusinessLogic:
 
         self.API_VERSION = API_VERSION
         self.ROOT_PARENT = ROOT_PARENT
+        self.script_mode = script_mode
 
     def checks(self, func_name: str, *args):
         """
@@ -841,13 +844,6 @@ class BusinessLogic:
         :param num_col: количество отображаемых столбцов
         :return: (dict) multisphere data, format: {"dimensions": "", "facts": "", "data": ""}
         """
-        # список слоев
-        layers_list = self._get_session_layers()
-        try:
-            # получить layer id
-            self.layer_id = layers_list[0]["uuid"]
-        except (KeyError, IndexError) as e:
-            return self._raise_exception(PolymaticaException, str(e))
 
         # инициализация модуля Olap
         self.set_multisphere_module_id(self.multisphere_module_id)
@@ -1610,7 +1606,7 @@ class BusinessLogic:
         # если же в мультисфере нет указанной группы фактов - выбрасываем исключение
         if not query:
             return self._raise_exception(
-                ValueError, f"Group <{group}> not found", with_traceback=False
+                ValueError, f'Group "{group}" not found', with_traceback=False
             )
 
         # снять выделение фактов
@@ -1659,7 +1655,7 @@ class BusinessLogic:
         # если же в мультисфере нет указанной группы фактов - выбрасываем исключение
         if not query:
             return self._raise_exception(
-                ValueError, f"Group <{group}> not found", with_traceback=False
+                ValueError, f'Group "{group}" not found', with_traceback=False
             )
 
         # снять выделение фактов
@@ -1675,9 +1671,6 @@ class BusinessLogic:
         return self.h.parse_result(result, "facts") or list()
 
     def _get_tree_dimension_list(self) -> List:
-        result = self.execute_olap_command(
-            command_name="fact", state="tree_get_request"
-        )
         result = self.execute_olap_command(
             command_name="dimension", state="tree_get_request"
         )
@@ -1894,7 +1887,8 @@ class BusinessLogic:
         ), f'File "{download_file_name}" not in path "{path}"!'
         return download_file_name, path
 
-    def _is_numeric(self, value: str) -> bool:
+    @staticmethod
+    def _is_numeric(value: str) -> bool:
         """
         Проверка, является ли заданная строка числом.
         :param value: (str) строка для проверки.
@@ -2013,7 +2007,7 @@ class BusinessLogic:
                 )
                 top_dims = self.h.parse_result(result=result, key="top_dims")
 
-                # сформировать словарь {"элемент верхней размерности": индекс_элемнета}
+                # сформировать словарь {"элемент верхней размерности": индекс_элемента}
                 filter_pattern_result = self.filter_pattern_change(top_dims[0], 30, [])
                 top_dim_values = self.h.parse_result(
                     result=filter_pattern_result, key="data"
@@ -2654,7 +2648,7 @@ class BusinessLogic:
                 break
         return {measure.get("fact_id") for measure in measure_data}
 
-    def _prepare_data(self) -> Union[List, int, int, int, int]:
+    def _prepare_data(self) -> Tuple[List[Any], int, int]:
         """
         Подготовка данных для дальнейшего получения датафрейма:
         1. Формирование колонок мультисферы с учётом вынесенных верхних размерностей.
@@ -3515,7 +3509,9 @@ class BusinessLogic:
         return ids
 
     @timing
-    def sort_measure(self, measure_name: str, sort_type: str, path: List[str] = None) -> dict:
+    def sort_measure(
+        self, measure_name: str, sort_type: str, path: List[str] = None
+    ) -> dict:
         """
         Сортировка значений указанного факта по возрастанию/убыванию.
         Необходимым условием сортировки является наличие хотя бы одной вынесенной влево размерности.
@@ -3540,10 +3536,9 @@ class BusinessLogic:
         module_configuration = self.execute_olap_command(
             command_name="view", state="get_module_configuration"
         )
-        top_total_transfer = module_configuration["queries"][0]["command"][
-            "top_total_transfer"
-        ]
-
+        top_total_transfer = self.h.parse_result(
+            module_configuration, "top_total_transfer"
+        )
         # получаем данные по фактам, а также количество левых размерностей
         result = self.execute_olap_command(
             command_name="view", state="get", from_row=0, from_col=0, num_row=1
@@ -3581,7 +3576,7 @@ class BusinessLogic:
 
         if path and line is None:
             return self._raise_exception(
-                ValueError, f'Path {path} is invalid! All top dims must be expanded!'
+                ValueError, f"Path {path} is invalid! All top dims must be expanded!"
             )
 
         self.func_name = "sort_measure"
@@ -3590,8 +3585,9 @@ class BusinessLogic:
         )
 
     @staticmethod
-    def _find_column_index(top: Dict, path: List[str], measure_id: str) -> Optional[int]:
-
+    def _find_column_index(
+        top: Dict, path: List[str], measure_id: str
+    ) -> Optional[int]:
         acceptable_indieces = set(range(len(top[0])))
         value_index = len(top[0]) + 1
         for depth, expected_value in enumerate(path):
@@ -3599,9 +3595,13 @@ class BusinessLogic:
             acceptable_indieces_row = set()
 
             for index_cell, cell in enumerate(row):
-                if expected_value == 'Всего' and cell.get("type") == 5 and index_cell in acceptable_indieces:
+                if (
+                    expected_value == "Всего"
+                    and cell.get("type") == 5
+                    and index_cell in acceptable_indieces
+                ):
                     acceptable_indieces_row.add(index_cell)
-                    break
+                    value_index = index_cell
                 elif cell.get("value") == expected_value:
                     if index_cell in acceptable_indieces:
                         value_index = index_cell
@@ -3609,7 +3609,11 @@ class BusinessLogic:
                 elif cell.get("type") in (1, 5) and index_cell >= value_index:
                     if index_cell in acceptable_indieces:
                         acceptable_indieces_row.add(index_cell)
-                elif cell.get("value") != expected_value and cell.get("type") in (2, 3) and acceptable_indieces_row:
+                elif (
+                    cell.get("value") != expected_value
+                    and cell.get("type") in (2, 3)
+                    and acceptable_indieces_row
+                ):
                     break
             acceptable_indieces = acceptable_indieces_row
             value_index = len(top[0]) + 1
@@ -3617,7 +3621,10 @@ class BusinessLogic:
         # находим факт в ряду фактов и возвращаем его индекс
         for index in sorted(acceptable_indieces):
             measure_cell = top[-1][index]
-            if measure_cell.get("type") == 4 and measure_cell.get("fact_id") == measure_id:
+            if (
+                measure_cell.get("type") == 4
+                and measure_cell.get("fact_id") == measure_id
+            ):
                 return index
         return None
 
@@ -3962,9 +3969,9 @@ class BusinessLogic:
         user_schedule["time_zone"] = time_zones[h_timezone]
 
         # преобразование времени в UNIX time
-        h_m = user_schedule["time"].split(":")
-        d = datetime.datetime(1970, 1, 1, int(h_m[0]) + 3, int(h_m[1]), 0)
-        user_schedule["time"] = int(time.mktime(d.timetuple()))
+        hours, minutes = user_schedule["time"].split(":")
+        t = datetime.timedelta(hours=int(hours), minutes=int(minutes))
+        user_schedule["time"] = int(t.total_seconds())
 
     def _get_interval_borders(
         self, user_interval: str, interval_borders: list
@@ -4020,10 +4027,12 @@ class BusinessLogic:
                 'schedule': <dict>
             }, где:
                 type - тип обновления, возможны значения:
-                ["ручное", "по расписанию", "интервальное", "инкрементальное", "обновление измененных записей"];
+                ["полное" (ранее было "ручное" и "по расписанию" (при наличии расписания в schedule),
+                эти значения тоже доступны для обратной совместимости),
+                "интервальное", "инкрементальное", "обновление измененных записей"];
 
-                schedule - планировщик, позволяющий задать время и день/число, необязательный параметр
-                для интервального и инкрементального обновления.
+                schedule - планировщик, позволяющий задать расписание для обновления. Если расписание
+                задавать не надо, то необходимо передать 'schedule': {}.
                 Имеет структуру:
                     {
                         'type': <value>,
@@ -4043,14 +4052,14 @@ class BusinessLogic:
                             актуально только для периода обновления "Ежемесячно".
                     Также может быть списком, содержащим словари указанной выше структуры.
             Пример:
-                [{
-                    "type": "по расписанию",
+                {
+                    "type": "полное",
                     "schedule": {
                         "type": "Ежедневно",
                         "time": "18:30",
                         "time_zone": "UTC+3:00"
                     }
-                }]
+                }
         :param sql_params: (dict) параметры для источника данных SQL.
             Поля, передаваемые в словарь:
                 "server" - хост, который может быть задан в виде IP-адреса сервера (например, "10.18.0.132"),
@@ -4067,7 +4076,7 @@ class BusinessLogic:
                     "server": "10.8.0.115:5433",
                     "login": "your_user",
                     "passwd": "your_password",
-                    "database" "database_name",
+                    "database": "database_name",
                     "sql_query": "SELECT * FROM table"
                 }
         :param user_interval: (str) интервал обновлений; возможны значения:
@@ -4118,6 +4127,16 @@ class BusinessLogic:
             if update_params is None
             else copy.deepcopy(update_params)
         )
+        if update_params is not None and update_params.get("type") in ("ручное", "по расписанию"):
+            logger.warning('Params "ручное" and "по расписанию" from update_params["type"] will be deprecated '
+                           'in future version. Use "полное" with or without schedule instead.')
+        # отправляем на сервер старые названия типов обновления
+        if current_update_params.get("type") == "полное":
+            if not current_update_params.get("schedule"):
+                current_update_params["type"] = "ручное"
+            else:
+                current_update_params["type"] = "по расписанию"
+
         time_zones = self.server_codes["manager"]["timezone"]
         if modified_records_params is None:
             modified_records_params = dict()
@@ -4190,7 +4209,7 @@ class BusinessLogic:
                 increment_dim,
                 interval_dim,
                 interval_borders,
-                encoding
+                encoding,
             )
         except Exception as e:
             return self._raise_exception(ValueError, str(e), with_traceback=False)
@@ -4461,10 +4480,12 @@ class BusinessLogic:
                 'schedule': <dict>
             }, где:
                 type - тип обновления, возможны значения:
-                    ["ручное", "по расписанию", "интервальное", "инкрементальное", "обновление измененных записей"];
+                ["полное" (ранее было "ручное" и "по расписанию" (при наличии расписания в schedule),
+                эти значения тоже доступны для обратной совместимости),
+                "интервальное", "инкрементальное", "обновление измененных записей"];
 
-                schedule - планировщик, позволяющий задать время и день/число, необязательный параметр
-                    для интервального и инкрементального обновления.
+                schedule - планировщик, позволяющий задать расписание для обновления. Если расписание
+                задавать не надо, то необходимо передать 'schedule': {}.
                 Имеет структуру:
                     {
                         'type': <value>,
@@ -4485,7 +4506,7 @@ class BusinessLogic:
                     Также может быть списком, содержащим словари указанной выше структуры.
             Пример:
                 [{
-                    "type": "по расписанию",
+                    "type": "полное",
                     "schedule": {
                         "type": "Ежедневно",
                         "time": "18:30",
@@ -4531,6 +4552,16 @@ class BusinessLogic:
             if update_params is None
             else copy.deepcopy(update_params)
         )
+        if update_params is not None and update_params.get("type") in ("ручное", "по расписанию"):
+            logger.warning('Params "ручное" and "по расписанию" from update_params["type"] will be deprecated '
+                           'in future version. Use "полное" with or without schedule instead.')
+        # отправляем на сервер старые названия типов обновления
+        if current_update_params.get("type") == "полное":
+            if not current_update_params.get("schedule"):
+                current_update_params["type"] = "ручное"
+            else:
+                current_update_params["type"] = "по расписанию"
+
         time_zones = self.server_codes["manager"]["timezone"]
         if modified_records_params is None:
             modified_records_params = dict()
@@ -5974,10 +6005,14 @@ class BusinessLogic:
         session_layers_lst = self._get_session_layers()
         self.layers_list = [layer.get("uuid") for layer in session_layers_lst]
 
-        # получить идентификатор текущего слоя, если он не задан
+        # получить идентификатор текущего слоя, если он не задан, или создать новый слой
         if not self.active_layer_id:
             try:
-                self.active_layer_id = session_layers_lst[0]["uuid"]
+                if session_layers_lst:
+                    self.active_layer_id = session_layers_lst[0].get("uuid")
+                else:
+                    self.active_layer_id = self.create_layer()
+                    self.layers_list.append(self.active_layer_id)
             except Exception as e:
                 error_msg = f"Error while parsing response: {e}"
                 return self._raise_exception(PolymaticaException, error_msg)
@@ -6385,11 +6420,12 @@ class BusinessLogic:
         Возвращает название активного слоя.
         :return: (str) название слоя.
         """
-        return self.execute_manager_command(
+        result = self.execute_manager_command(
             command_name="user_layer",
             state="get_layer",
             layer_id=self.get_active_layer_id(),
-        )["queries"][0]["command"]["layer"]["name"]
+        )
+        return self.h.parse_result(result, "layer", "name")
 
     def _get_modules_in_layer(self, layer_id: str, is_int_type: bool = True) -> List:
         """
@@ -6419,7 +6455,14 @@ class BusinessLogic:
             )
             cube_id = module.get("cube_id")
 
-            result.append([module_id, module_name, module_type, cube_id])
+            if self.script_mode:
+                module_setting = self.execute_manager_command(
+                    command_name="user_iface", state="load_settings", module_id=module_id)
+                module_info = self.h.parse_result(result=module_setting, key="settings") or dict()
+                facts_format = module_info.get('config_storage')['facts-format']['__suffixes']
+                result.append([module_id, module_name, module_type, facts_format])
+            else:
+                result.append([module_id, module_name, module_type, cube_id])
         return result
 
     @timing
@@ -7081,7 +7124,7 @@ class BusinessLogic:
         self, module: str = "", width: int = 200, olap_resize: bool = False
     ) -> dict:
         """
-        Расширение колонок фактов (чтобы текст на них становился видимым) на заданную ширину.
+        Изменение ширины колонок фактов (чтобы текст на них становился видимым).
         Некая имитация интерфейсной кнопки "Показать контент". Актуально только для OLAP-модулей (мультисфер).
         Если пользователем не указан идентификатор модуля, то расширяется текущий активный OLAP-модуль.
         :param module: название/идентификатор OLAP-модуля;
@@ -7089,7 +7132,8 @@ class BusinessLogic:
             если модуль не указан, то берётся текущий (активный) модуль (если его нет - сгенерируется исключение).
         :param width: ширина, на которую будет меняться каждая колонка фактов; можно указать отрицательное значение,
             тогда ширина колонок будет уменьшаться; при указании положительного значения - ширина колонок увеличится.
-        :param olap_resize: нужно ли расширять окно мультисферы (True - нужно, False - не нужно). По-умолчанию False.
+        :param olap_resize: нужно ли изменять ширину окна мультисферы
+            (True - нужно, False - не нужно). По-умолчанию False.
         :return: результат команды ("user_iface", "save_settings").
         :call_example:
             1. Инициализируем класс: bl_test = sc.BusinessLogic(login="login", password="password", url="url")
@@ -7624,7 +7668,7 @@ class BusinessLogic:
         Получить тип обновления мультисферы с заданным идентификатором.
         :param cube_id: (str) идентификатор куба.
         :return: (str) тип обновления; возможен один из вариантов:
-            ["ручное", "по расписанию", "интервальное", "инкрементальное", "undefined"];
+            ["полное", "интервальное", "инкрементальное", "обновление измененных записей", "undefined"];
             первые четыре типа актуальны для БД-источников, последний тип - для файловых источников.
         """
         empty_id = "00000000"
@@ -7656,12 +7700,14 @@ class BusinessLogic:
         )
         if interval and interval.get("dimension_id", empty_id) != empty_id:
             return "интервальное"
-        schedule = self.h.parse_result(
-            metadata_result, "schedule", default_value=dict()
-        )
-        if schedule and len(schedule.get("items", [])) > 0:
-            return "по расписанию"
-        return "ручное"
+        if (
+            self.h.parse_result(
+                metadata_result, "delta", default_value=dict()
+            ).get("primary_key_dim", empty_id)
+            != empty_id
+        ):
+            return "обновление измененных записей"
+        return "полное"
 
     @timing
     def get_cube_info(self, cube: str = "") -> dict:
@@ -7706,6 +7752,17 @@ class BusinessLogic:
         cube_info = dict()
         for cube in cubes:
             cube_name, cube_id = cube.get("name"), cube.get("uuid")
+            if self.script_mode:
+                result = self.execute_olap_command(command_name="view",
+                                                   state="get",
+                                                   from_row=0,
+                                                   from_col=0,
+                                                   num_row=1,
+                                                   num_col=1)
+                relevance_date = self.h.parse_result(result, "relevance_date", default_value="")
+            else:
+                relevance_date = ""
+
             if current_cube not in (cube_name, cube_id):
                 continue
             cube_info.update(
@@ -7727,6 +7784,7 @@ class BusinessLogic:
                     "dimension_count": cube.get("dimension_count"),
                     "measure_count": cube.get("fact_count"),
                     "update_type": self._get_cube_update_type(cube_id),
+                    "relevance_date": relevance_date
                 }
             )
             break
@@ -8415,13 +8473,17 @@ class GetDataChunk:
         # получаем левые/верхние размерности, считаем их количество
         self.left_dims, self.top_dims = self._get_active_dims()
 
+        # внутренний флаг работы со скриптом
+        self.script_mode = sc.script_mode
+
         # обязательное условие: чтобы получить данные, должна быть вынесена хотя бы одна левая размерность
-        if not self.left_dims:
+        # (кроме специальных скриптов)
+        if not self.left_dims and not self.script_mode:
             error_msg = (
                 "For page-by-page loading of the multisphere, "
                 "at least one dimension must be moved to the left!"
             )
-            return self._raise_exception(
+            self._raise_exception(
                 PolymaticaException, error_msg, with_traceback=False
             )
 
@@ -8666,7 +8728,7 @@ class GetDataChunk:
             show_horz_total=show_full,
             show_vert_total=show_full,
         )
-        return response["queries"][0]["command"]["total_row"]
+        return self.h.parse_result(response, "total_row")
 
     def load_sphere_chunk(
         self,
@@ -8821,7 +8883,7 @@ class GetDataChunk:
             state="list_rq",
         )
         dimensions: Dict[dict] = {
-            dim["id"]: dim for dim in response["queries"][0]["command"]["dimensions"]
+            dim["id"]: dim for dim in self.h.parse_result(response, "dimensions")
         }
 
         # get facts
@@ -8830,7 +8892,7 @@ class GetDataChunk:
             state="list_rq",
         )
         facts: Dict[dict] = {
-            dim["id"]: dim for dim in response["queries"][0]["command"]["facts"]
+            dim["id"]: dim for dim in self.h.parse_result(response, "facts")
         }
 
         # load 1 row with 1 col to get valid total_col and total_row
@@ -8842,13 +8904,14 @@ class GetDataChunk:
             num_row=1,
             num_col=1,
         )
-        command_data: dict = response["queries"][0]["command"]
 
-        data_cols_count = command_data["total_col"]
-        data_rows_count = command_data["total_row"]
-        inter_total_hidden_dimensions = command_data["inter_total_hidden_dimensions"]
-        show_global_horz_total = command_data["show_global_horz_total"]
-        show_global_vert_total = command_data["show_global_horz_total"]
+        data_cols_count = self.h.parse_result(response, "total_col")
+        data_rows_count = self.h.parse_result(response, "total_row")
+        inter_total_hidden_dimensions = self.h.parse_result(
+            response, "inter_total_hidden_dimensions"
+        )
+        show_global_horz_total = self.h.parse_result(response, "show_global_horz_total")
+        show_global_vert_total = self.h.parse_result(response, "show_global_horz_total")
 
         extra_info = {
             "data_cols_count": data_cols_count,
@@ -8867,13 +8930,18 @@ class GetDataChunk:
             num_row=1,
             num_col=data_cols_count,
         )
-        command_data: dict = response["queries"][0]["command"]
 
-        top_dims = [dimensions[dim_id]["name"] for dim_id in command_data["top_dims"]]
-        left_dims = [dimensions[dim_id]["name"] for dim_id in command_data["left_dims"]]
+        top_dims = [
+            dimensions[dim_id]["name"]
+            for dim_id in self.h.parse_result(response, "top_dims")
+        ]
+        left_dims = [
+            dimensions[dim_id]["name"]
+            for dim_id in self.h.parse_result(response, "left_dims")
+        ]
 
         data_header = []
-        for row in command_data["top"]:
+        for row in self.h.parse_result(response, "top"):
             tmp_data_header_row = []
             for cell in row:
                 if cell["type"] == 4:  # fact
@@ -8902,15 +8970,14 @@ class GetDataChunk:
                     num_row=units,
                     num_col=data_cols_count,
                 )
-                command_data: dict = response["queries"][0]["command"]
                 left_data = [
                     [
                         {"value": cell.get("value", None), "type": cell.get("type")}
                         for cell in row
                     ]
-                    for row in command_data["left"]
+                    for row in self.h.parse_result(response, "left")
                 ]
-                data = command_data["data"]
+                data = self.h.parse_result(response, "data")
 
                 yield left_data, data
 

{polyapi-5.9.13 → polyapi-5.9.14}/polymatica/common/consts.py

@@ -189,4 +189,5 @@ FORMAT_SETTINGS_KEYS = [
 ]
 API_VERSION = "v2"
 ROOT_PARENT = "00000000"
+UNITS_LOAD_DATA_CHUNK = 1000
 BASE_LAYER_NAME = "Слой"

{polyapi-5.9.13 → polyapi-5.9.14}/polymatica/error_handler.py

@@ -2,8 +2,8 @@
 """ Модуль обработки ошибок из ответа """
 
 import datetime
-from datetime import datetime as dt
 import re
+from datetime import datetime as dt
 
 import requests
 from packaging.version import Version
@@ -431,9 +431,7 @@ class Validator:
         :return: список дат
         """
         if not filter_field_format:
-            raise ValueError(
-                f"filter_field_format must be specified!"
-            )
+            raise ValueError("filter_field_format must be specified!")
         try:
             start_dt = dt.strptime(start_date, filter_field_format)
             end_dt = dt.strptime(end_date, filter_field_format)
@@ -447,7 +445,6 @@ class Validator:
         if start > end:
             raise ValueError("Start date can not be more than the end date!")
 
-
         # Заполняем dates_list
         dates_list = []
         step = datetime.timedelta(days=1)
@@ -457,8 +454,13 @@ class Validator:
         current_polymatica_version = Version(current_polymatica_version)
         edge_version = Version("5.9.12")
         while start <= end:
-            if current_polymatica_version >= edge_version and "%S" in filter_field_format:
-                dates_list.append(self._format_datetime_with_millis(start, filter_field_format))
+            if (
+                current_polymatica_version >= edge_version
+                and "%S" in filter_field_format
+            ):
+                dates_list.append(
+                    self._format_datetime_with_millis(start, filter_field_format)
+                )
             else:
                 dates_list.append(start.strftime(filter_field_format))
             start += step
@@ -632,19 +634,19 @@ class Validator:
         increment_dim,
         interval_dim,
         interval_borders,
-        encoding
+        encoding,
     ):
         """
         Проверка множества аргументов функции create_sphere.
         :param update_params: параметры обновления
         :param file_type: тип файла
         :param sql_params: параметры SQL
-        :param user_interval: интервал пользователя
+        :param user_interval: интервал обновлений
         :param source_name: имя источника
         :param cube_name: имя куба
         :param time_zones: временные зоны
-        :param increment_dim: инкрементальное измерение
-        :param interval_dim: интервальное измерение
+        :param increment_dim: размерность для инкрементального обновления
+        :param interval_dim: размерность для интервального обновления
         :param interval_borders: границы интервала
         :return: имя куба
         """
@@ -656,7 +658,7 @@ class Validator:
         check_cube_name(cube_name=cube_name, forbidden_chars=CUBE_NAME_FORBIDDEN_CHARS)
 
         # проверка заданного типа обновления и его параметров
-        self._validate_update_params(update_params, file_type, time_zones)
+        self._validate_update_params(update_params=update_params, time_zones=time_zones, file_type=file_type)
 
         # проверки инкрементального и интервального обновления
         update_type = update_params.get("type")
@@ -680,38 +682,41 @@ class Validator:
         """
         Проверка кодировки. Для источника формата csv она должна быть обязательно задана.
         """
-        if file_type == 'csv' and encoding == "":
-            raise ValueError(f"For csv source encoding must be specified!")
+        if file_type == "csv" and encoding == "":
+            raise ValueError("For csv source encoding must be specified!")
 
-    def _validate_update_params(self, update_params, file_type, time_zones):
+    def _validate_update_params(self, update_params, time_zones, file_type=None):
         """
         Проверка параметров обновления.
         :param update_params: параметры обновления
-        :param file_type: тип файла
+        :param file_type: тип файла, только для метода create_sphere.
         :param time_zones: временные зоны
         """
         update_type = update_params.get("type")
         if update_type not in UPDATE_TYPES:
             raise ValueError(f"Unknown update type: {update_type}")
-        if file_type in ("excel", "csv") and update_type != "ручное":
+        if file_type is not None and file_type in ("excel", "csv") and update_type != "ручное":
             raise ValueError(
-                "For multispheres created from file sources, only manual update is available!"
+                "For multispheres created from file sources, only full update is available!"
             )
         if update_type != "ручное":
             self._validate_schedule(
                 update_params.get("schedule", list()), update_type, time_zones
             )
+        if update_type == "по расписанию" and not update_params.get("schedule"):
+            raise ValueError(
+                "Update_params must include a schedule!"
+            )
+
 
     @staticmethod
     def _validate_schedule(user_schedule, update_type, time_zones):
         """
         Проверка расписания.
-        :param user_schedule: расписание пользователя
+        :param user_schedule: пользовательское расписание
         :param update_type: тип обновления
         :param time_zones: временные зоны
         """
-        if user_schedule == list() and update_type == "по расписанию":
-            raise ValueError("Please enter schedule param in update_params!")
 
         schedules = (
             user_schedule if isinstance(user_schedule, list) else [user_schedule]
@@ -757,7 +762,7 @@ class Validator:
         Проверка интервального обновления.
         :param update_type: тип обновления
         :param interval_dim: интервальное измерение
-        :param user_interval: интервал пользователя
+        :param user_interval: интервал обновлений
         :param interval_borders: границы интервала
         """
         if update_type == "интервальное":
@@ -834,9 +839,9 @@ class Validator:
         :param new_cube_name: новое имя куба
         :param cubes_list: список кубов
         :param update_params: параметры обновления
-        :param user_interval: интервал пользователя
-        :param increment_dim: инкрементальное измерение
-        :param interval_dim: интервальное измерение
+        :param user_interval: интервал обновлений
+        :param increment_dim: размерность для инкрементального обновления
+        :param interval_dim: размерность для интервального обновления
         :param interval_borders: границы интервала
         :param time_zones: временные зоны
         :return: кортеж (ID куба, новое имя куба)
@@ -858,16 +863,10 @@ class Validator:
             )
 
         # проверка заданного типа обновления и его параметров
-        update_type = update_params.get("type")
-        if update_type not in UPDATE_TYPES:
-            raise ValueError(f"Unknown update type: {update_type}")
-
-        if update_type != "ручное":
-            self._validate_schedule(
-                update_params.get("schedule", list()), update_type, time_zones
-            )
+        self._validate_update_params(update_params=update_params, time_zones=time_zones)
 
         # проверки инкрементального и интервального обновления
+        update_type = update_params.get("type")
         self._validate_increment_update(update_type, increment_dim)
         self._validate_interval_update(
             update_type, interval_dim, user_interval, interval_borders

{polyapi-5.9.13 → polyapi-5.9.14}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "polyapi"
-version = "5.9.13"
+version = "5.9.14"
 description = "Wrapper for Polymatica API"
 license = "MIT"
 keywords = ["polymatica"]

{polyapi-5.9.13 → polyapi-5.9.14}/setup.py

@@ -10,7 +10,7 @@ classifiers = [
 
 setup(
     name='polyapi',
-    version='5.9.13',
+    version='5.9.14',
     description='Wrapper for Polymatica API',
     long_description=open('README.txt', encoding='utf-8').read(),
     url='https://www.polymatica.ru',