polyapi 5.9.12__tar.gz → 5.9.13__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: polyapi
-Version: 5.9.12
+Version: 5.9.13
 Summary: Wrapper for Polymatica API
 Home-page: https://www.polymatica.ru
 Author: Polymatica Rus LLC
@@ -17,6 +17,7 @@ Requires-Dist: setuptools
 Requires-Dist: pandas
 Requires-Dist: requests
 Requires-Dist: pydantic
+Requires-Dist: packaging
 
 Библиотека предназначенна для работы с Polymatica API.
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: polyapi
-Version: 5.9.12
+Version: 5.9.13
 Summary: Wrapper for Polymatica API
 Home-page: https://www.polymatica.ru
 Author: Polymatica Rus LLC
@@ -17,6 +17,7 @@ Requires-Dist: setuptools
 Requires-Dist: pandas
 Requires-Dist: requests
 Requires-Dist: pydantic
+Requires-Dist: packaging
 
 Библиотека предназначенна для работы с Polymatica API.
 

{polyapi-5.9.12 → polyapi-5.9.13}/polyapi.egg-info/requires.txt

@@ -2,3 +2,4 @@ setuptools
 pandas
 requests
 pydantic
+packaging

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

@@ -1286,9 +1286,9 @@ class BusinessLogic:
                         также будет сгенерирована ошибка
                 5. В противном случае, если указано что-то иное - будет сгенерирована ошибка.
         :filter_field_format (Union[str, None]): формат даты-времени, в котором фильтруемая размерность
-            представлена в Полиматике. Актуально, если в параметрах start_date и end_date указаны строки-даты.
-            Если в актуальном случае этот параметр не указан, то будет получено системное значение из Полиматики.
+            представлена в Полиматике. Обязателен, если в параметрах start_date и end_date указаны строки-даты.
             Параметр необходим для корректной фильтрации даты-времени.
+            Пример: filter_field_format='%d.%m.%Y %H:%M:%S.%f' или '%Y-%m-%d'.
         :return: (dict) результат команды ("filter", "apply_data").
         """
         # заполнение списка dates_list в зависимости от содержания параметров filter_name, start_date, end_date
@@ -3515,22 +3515,25 @@ class BusinessLogic:
         return ids
 
     @timing
-    def sort_measure(self, measure_name: str, sort_type: str) -> dict:
+    def sort_measure(self, measure_name: str, sort_type: str, path: List[str] = None) -> dict:
         """
-        Сортировка значений указанного факта по возрастанию/убыванию в колонке "Всего"
-        (даже если есть верхние размерности).
+        Сортировка значений указанного факта по возрастанию/убыванию.
         Необходимым условием сортировки является наличие хотя бы одной вынесенной влево размерности.
-        Если в мультисфере есть вынесенные вверх размерности, то необходимо перед вызовом метода их все свернуть.
+        Если задан параметр path, то сортировка будет производиться по столбцу,
+        путь до которого указан в этом параметре. Верхние размерности должны быть развернуты,
+        это можно сделать командой "expand_all_up_dims".
+        Если параметр path не задан, то сортировка будет производиться по столбцу "Всего", и вынесенные
+        вверх размерности необходимо свернуть перед вызовом метода.
         Это можно сделать командой "collap_all_up_dims".
         :param measure_name: название факта.
         :param sort_type: "ascending"/"descending"/"off" (по возрастанию/по убыванию/выключить сортировку).
+        :param path: путь до столбца, содержит имена элементов верхних размерностей,
+            пример ['Простуда и грипп', 'Гастрацид'] - для двух верхних размерностей, также возможно указать
+            колонку "Всего" в пути, то есть ["Простуда и грипп", "Всего"]
         :return: (dict) результат команды ("view", "set_sort").
         """
         # проверки
-        try:
-            int_sort_type = self.checks(self.func_name, sort_type)
-        except Exception as e:
-            return self._raise_exception(ValueError, str(e), with_traceback=False)
+        int_sort_type = self.checks(self.func_name, sort_type)
 
         # получаем данные о расположении колонки "Всего". Если top_total_transfer = False - то в конце таблицы,
         # если True, то первым столбцом
@@ -3553,31 +3556,71 @@ class BusinessLogic:
 
         # извлекаем все колонки с фактами
         top = self.h.parse_result(result, "top")
-        measures = []
-        for i in top:
-            for elem in i:
-                if "fact_id" in elem:
-                    measures.append(elem["fact_id"])
 
         measure_id = self.get_measure_id(measure_name)
 
         # находим номер колонки
         try:
-            line = (
-                measures.index(measure_id)
-                if top_total_transfer
-                else len(measures) - 1 - measures[::-1].index(measure_id)
-            )
+            if not path:
+                measures = []
+                for i in top:
+                    for elem in i:
+                        if "fact_id" in elem:
+                            measures.append(elem["fact_id"])
+                line = (
+                    measures.index(measure_id)
+                    if top_total_transfer
+                    else len(measures) - 1 - measures[::-1].index(measure_id)
+                )
+            else:
+                line = self._find_column_index(top, path, measure_id)
         except ValueError:
             return self._raise_exception(
                 ValueError, f'Measure "{measure_name}" must be visible!'
             )
 
+        if path and line is None:
+            return self._raise_exception(
+                ValueError, f'Path {path} is invalid! All top dims must be expanded!'
+            )
+
         self.func_name = "sort_measure"
         return self.execute_olap_command(
             command_name="view", state="set_sort", line=line, sort_type=int_sort_type
         )
 
+    @staticmethod
+    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):
+            row = top[depth]
+            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:
+                    acceptable_indieces_row.add(index_cell)
+                    break
+                elif cell.get("value") == expected_value:
+                    if index_cell in acceptable_indieces:
+                        value_index = index_cell
+                        acceptable_indieces_row.add(index_cell)
+                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:
+                    break
+            acceptable_indieces = acceptable_indieces_row
+            value_index = len(top[0]) + 1
+
+        # находим факт в ряду фактов и возвращаем его индекс
+        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:
+                return index
+        return None
+
     def _get_left_and_top_dims_count(
         self, level: int = None, position: int = None
     ) -> Tuple[int, int]:
@@ -4147,6 +4190,7 @@ class BusinessLogic:
                 increment_dim,
                 interval_dim,
                 interval_borders,
+                encoding
             )
         except Exception as e:
             return self._raise_exception(ValueError, str(e), with_traceback=False)
@@ -8695,7 +8739,7 @@ class GetDataChunk:
             )
 
         # проверка на количество подгружаемых строк
-        self.checks("load_sphere_chunk", units, convert_type, convert_empty_values)
+        self.sc.checks("load_sphere_chunk", units, convert_type, convert_empty_values)
 
         # если был передан параметр convert_type, то нужно инициализировать класс преобразования типов
         if convert_type:

{polyapi-5.9.12 → polyapi-5.9.13}/polymatica/common/helper_funcs.py

@@ -322,11 +322,17 @@ def request_with_undefined_suffix_url(
 def validate_params(model, raise_exception_func, **kwargs):
     type_name_map = {
         "string_type": "str",
+        "type_error.str": "str",
         "bool_type": "bool",
+        "value_error.strictbool": "bool",
         "int_type": "int",
+        "type_error.integer": "int",
         "float_type": "float",
+        "type_error.float": "float",
         "list_type": "list",
+        "type_error.list": "list",
         "dict_type": "dict",
+        "type_error.dict": "dict",
     }
 
     try:

polyapi-5.9.13/polymatica/common/params_models.py

@@ -0,0 +1,76 @@
+from typing import List, Optional, Union
+
+from pydantic import BaseModel, StrictBool, StrictInt, StrictStr
+
+
+class SetMeasuresParams(BaseModel):
+    measure_names: List[StrictStr]
+    measure_formats: List[dict]
+    set_to_default: StrictBool = False
+
+
+class GetMeasuresParams(BaseModel):
+    measure_names: Optional[List[StrictStr]] = None
+    return_id: Optional[StrictBool] = False
+
+
+class CreateSphereParams(BaseModel):
+    cube_name: StrictStr
+    source_name: StrictStr
+    file_type: StrictStr
+    update_params: Optional[dict] = None
+    sql_params: Optional[dict] = None
+    user_interval: StrictStr = "с текущего дня"
+    filepath: StrictStr = ""
+    separator: StrictStr = ""
+    increment_dim: StrictStr = ""
+    interval_dim: StrictStr = ""
+    interval_borders: Optional[list] = None
+    encoding: StrictStr = ""
+    delayed: StrictBool = False
+    modified_records_params: Optional[dict] = None
+
+
+class UpdateCubeParams(BaseModel):
+    cube_name: StrictStr
+    new_cube_name: Optional[StrictStr] = None
+    update_params: Optional[dict] = None
+    user_interval: StrictStr = "с текущего дня"
+    delayed: StrictBool = False
+    increment_dim: StrictStr = ""
+    interval_dim: StrictStr = ""
+    interval_borders: Optional[list] = None
+    modified_records_params: Optional[dict] = None
+
+
+class CleanUpParams(BaseModel):
+    cube_name: StrictStr
+    dimension_name: StrictStr
+    sql_params: dict
+    is_update: StrictBool = True
+
+
+class RenameDimsParams(BaseModel):
+    dim_name: StrictStr
+    new_name: StrictStr
+
+
+class SetMeasureVisibilityParams(BaseModel):
+    measure_names: Union[StrictStr, List[StrictStr]]
+    is_visible: StrictBool = False
+
+
+class DeleteDimFilterParams(BaseModel):
+    dim_name: StrictStr
+    filter_name: Union[StrictStr, list, set, tuple]
+    num_row: StrictInt = 100
+
+
+class CreateLayerParams(BaseModel):
+    set_active: StrictBool = True
+
+
+class CreateConsistentDimParams(BaseModel):
+    formula: StrictStr
+    separator: StrictStr
+    dimension_list: List[StrictStr]

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

@@ -2,10 +2,11 @@
 """ Модуль обработки ошибок из ответа """
 
 import datetime
+from datetime import datetime as dt
 import re
 
 import requests
-from dateutil.parser import parse
+from packaging.version import Version
 
 from polymatica.common.consts import (
     CUBE_NAME_FORBIDDEN_CHARS,
@@ -429,9 +430,15 @@ class Validator:
         :param filter_field_format: формат поля фильтра
         :return: список дат
         """
+        if not filter_field_format:
+            raise ValueError(
+                f"filter_field_format must be specified!"
+            )
         try:
-            start = parse(start_date)
-            end = parse(end_date)
+            start_dt = dt.strptime(start_date, filter_field_format)
+            end_dt = dt.strptime(end_date, filter_field_format)
+            start = start_dt if "%S" in filter_field_format else start_dt.date()
+            end = end_dt if "%S" in filter_field_format else end_dt.date()
         except ValueError:
             raise ValueError(
                 f"Unknown date format! start_date: {start_date}, end_date: {end_date}"
@@ -440,20 +447,36 @@ class Validator:
         if start > end:
             raise ValueError("Start date can not be more than the end date!")
 
-        # Получаем формат хранения дат в Полиматике, если он не задан пользователем
-        date_format_pattern = (
-            filter_field_format or self.bl.get_current_datetime_format()
-        )
 
         # Заполняем dates_list
         dates_list = []
         step = datetime.timedelta(days=1)
+
+        # если версия аналитикс 5.9.12 или выше, то добавляем миллисекунды к датам
+        current_polymatica_version = self.bl.full_polymatica_version.split("-")[0]
+        current_polymatica_version = Version(current_polymatica_version)
+        edge_version = Version("5.9.12")
         while start <= end:
-            dates_list.append(start.strftime(date_format_pattern))
+            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
 
         return dates_list
 
+    @staticmethod
+    def _format_datetime_with_millis(dt: datetime.datetime, pattern: str) -> str:
+        base = dt.strftime(pattern)
+        millis = f"{dt.microsecond // 1000:03d}"
+        if "%f" in pattern:
+            # Если %f есть, то заменим его на миллисекунды
+            base = base.replace(dt.strftime("%f"), millis)
+        else:
+            # Иначе просто добавим миллисекунды в конце через точку
+            base = f"{base}.{millis}"
+        return base
+
     @staticmethod
     def check_export(file_format, file_path):
         """
@@ -609,6 +632,7 @@ class Validator:
         increment_dim,
         interval_dim,
         interval_borders,
+        encoding
     ):
         """
         Проверка множества аргументов функции create_sphere.
@@ -647,9 +671,18 @@ class Validator:
         # проверка длины и отсутствия пробелов в имени источника
         self._validate_source_name(source_name)
 
+        self._validate_encoding(file_type, encoding)
+
         self.bl.func_name = "create_sphere"
         return cube_name
 
+    def _validate_encoding(self, file_type, encoding):
+        """
+        Проверка кодировки. Для источника формата csv она должна быть обязательно задана.
+        """
+        if file_type == 'csv' and encoding == "":
+            raise ValueError(f"For csv source encoding must be specified!")
+
     def _validate_update_params(self, update_params, file_type, time_zones):
         """
         Проверка параметров обновления.

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

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "polyapi"
-version = "5.9.12"
+version = "5.9.13"
 description = "Wrapper for Polymatica API"
 license = "MIT"
 keywords = ["polymatica"]
@@ -15,6 +15,7 @@ requests = ">=2.31.0"
 setuptools = ">=68.0.0"
 pandas = "^1.5.3"
 pydantic = ">=2.0"
+packaging = "^25.0"
 
 [tool.poetry.group.dev.dependencies]
 ruff = "^0.11.2"

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

@@ -10,7 +10,7 @@ classifiers = [
 
 setup(
     name='polyapi',
-    version='5.9.12',
+    version='5.9.13',
     description='Wrapper for Polymatica API',
     long_description=open('README.txt', encoding='utf-8').read(),
     url='https://www.polymatica.ru',
@@ -20,5 +20,5 @@ setup(
     classifiers=classifiers,
     keywords="polymatica",
     packages=find_packages(),
-    install_requires=["setuptools", "pandas", "requests", "pydantic"],
+    install_requires=["setuptools", "pandas", "requests", "pydantic", "packaging"],
 )

polyapi-5.9.12/polymatica/common/params_models.py

@@ -1,86 +0,0 @@
-from typing import List, Optional, Union
-
-from pydantic import BaseModel, ConfigDict
-
-
-class SetMeasuresParams(BaseModel):
-    model_config = ConfigDict(strict=True)
-    measure_names: List[str]
-    measure_formats: List[dict]
-    set_to_default: bool = False
-
-
-class GetMeasuresParams(BaseModel):
-    model_config = ConfigDict(strict=True)
-    measure_names: Optional[List[str]] = None
-    return_id: Optional[bool] = False
-
-
-class CreateSphereParams(BaseModel):
-    model_config = ConfigDict(strict=True)
-    cube_name: str
-    source_name: str
-    file_type: str
-    update_params: Optional[dict] = None
-    sql_params: Optional[dict] = None
-    user_interval: str = "с текущего дня"
-    filepath: str = ""
-    separator: str = ""
-    increment_dim: str = ""
-    interval_dim: str = ""
-    interval_borders: Optional[list] = None
-    encoding: str = ""
-    delayed: bool = False
-    modified_records_params: Optional[dict] = None
-
-
-class UpdateCubeParams(BaseModel):
-    model_config = ConfigDict(strict=True)
-    cube_name: str
-    new_cube_name: Optional[str] = None
-    update_params: Optional[dict] = None
-    user_interval: str = "с текущего дня"
-    delayed: bool = False
-    increment_dim: str = ""
-    interval_dim: str = ""
-    interval_borders: Optional[list] = None
-    modified_records_params: Optional[dict] = None
-
-
-class CleanUpParams(BaseModel):
-    model_config = ConfigDict(strict=True)
-    cube_name: str
-    dimension_name: str
-    sql_params: dict
-    is_update: bool = True
-
-
-class RenameDimsParams(BaseModel):
-    model_config = ConfigDict(strict=True)
-    dim_name: str
-    new_name: str
-
-
-class SetMeasureVisibilityParams(BaseModel):
-    model_config = ConfigDict(strict=True)
-    measure_names: Union[str, List[str]]
-    is_visible: bool = False
-
-
-class DeleteDimFilterParams(BaseModel):
-    model_config = ConfigDict(strict=True)
-    dim_name: str
-    filter_name: Union[str, list, set, tuple]
-    num_row: int = 100
-
-
-class CreateLayerParams(BaseModel):
-    model_config = ConfigDict(strict=True)
-    set_active: bool = True
-
-
-class CreateConsistentDimParams(BaseModel):
-    model_config = ConfigDict(strict=True)
-    formula: str
-    separator: str
-    dimension_list: List[str]