dplex 0.3.4__tar.gz → 0.3.6__tar.gz

{dplex-0.3.4 → dplex-0.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dplex
-Version: 0.3.4
+Version: 0.3.6
 Summary: 
 License-Expression: MIT
 License-File: LICENSE

{dplex-0.3.4 → dplex-0.3.6}/dplex/dp_service.py

@@ -412,6 +412,49 @@ class DPService[
         """
         return [self._model_to_schema(model) for model in models]
 
+    # ==================== ВАЛИДАЦИОННЫЕ ХУКИ ====================
+    async def validate_create(self, create_data: CreateSchemaType) -> None:
+        """
+        Валидация перед созданием сущности.
+        Вызывается до преобразования схемы в модель и сохранения.
+        Переопределите в наследниках для доменной валидации.
+        При ошибке валидации выбросьте исключение.
+        """
+        ...
+
+    async def validate_update(self, update_data: UpdateSchemaType) -> None:
+        """
+        Валидация перед обновлением сущности.
+        Вызывается до применения изменений в БД.
+        Переопределите в наследниках для доменной валидации.
+        При ошибке валидации выбросьте исключение.
+        """
+        ...
+
+    async def transform_create_schema(
+        self, create_data: CreateSchemaType
+    ) -> CreateSchemaType:
+        """
+        Преобразование схемы создания перед сохранением.
+        Вызывается до валидации и преобразования в модель.
+        Переопределите в наследниках для нормализации данных
+        (trim полей, приведение регистра, подстановка значений и т.п.).
+        Возвращает схему (новый экземпляр или изменённую копию).
+        """
+        return create_data
+
+    async def transform_update_schema(
+        self, update_data: UpdateSchemaType
+    ) -> UpdateSchemaType:
+        """
+        Преобразование схемы обновления перед применением.
+        Вызывается до валидации и записи в БД.
+        Переопределите в наследниках для нормализации данных
+        (trim полей, приведение регистра и т.п.).
+        Возвращает схему (новый экземпляр или изменённую копию).
+        """
+        return update_data
+
     # ==================== CRUD ОПЕРАЦИИ ====================
     async def get_by_id(self, entity_id: KeyType | None) -> ResponseSchemaType | None:
         """
@@ -527,6 +570,8 @@ class DPService[
         Returns:
             Схема ответа с созданной сущностью
         """
+        create_data = await self.transform_create_schema(create_data)
+        await self.validate_create(create_data)
         model = self._create_schema_to_model(create_data)
         created_model = await self.repository.create(model)
         await self.session.flush()
@@ -545,7 +590,12 @@ class DPService[
         if not create_data_list:
             return []
 
-        models = [self._create_schema_to_model(data) for data in create_data_list]
+        transformed_list: list[CreateSchemaType] = []
+        for data in create_data_list:
+            data = await self.transform_create_schema(data)
+            await self.validate_create(data)
+            transformed_list.append(data)
+        models = [self._create_schema_to_model(data) for data in transformed_list]
         created_models = await self.repository.create_bulk(models)
         await self.session.flush()
         return self._models_to_schemas(created_models)
@@ -565,12 +615,14 @@ class DPService[
         Returns:
             None
         """
+        update_data = await self.transform_update_schema(update_data)
         update_dict = self._make_update_dict(update_data)
         if not update_dict:
             raise ValueError(
                 "DPService.update: Данные для обновления не могут быть пустыми"
             )
 
+        await self.validate_update(update_data)
         qb = self.repository.query()
         qb = self._apply_filter_to_query(qb, filter_data)
         await self.repository.update_by_query_builder(qb, update_dict)
@@ -589,12 +641,14 @@ class DPService[
         Returns:
             None
         """
+        update_data = await self.transform_update_schema(update_data)
         update_dict = self._make_update_dict(update_data)
         if not update_dict:
             raise ValueError(
                 "DPService.update_by_id: Данные для обновления не могут быть пустыми"
             )
 
+        await self.validate_update(update_data)
         await self.repository.update_by_id(entity_id, update_dict)
         await self.session.flush()
 
@@ -614,12 +668,14 @@ class DPService[
         if not entity_ids:
             raise ValueError("DPService.update_by_ids: Список ID не может быть пустым")
 
+        update_data = await self.transform_update_schema(update_data)
         update_dict = self._make_update_dict(update_data)
         if not update_dict:
             raise ValueError(
                 "DPService.update_by_ids: Данные для обновления не могут быть пустыми"
             )
 
+        await self.validate_update(update_data)
         await self.repository.update_by_ids(entity_ids, update_dict)
         await self.session.flush()
 

{dplex-0.3.4 → dplex-0.3.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dplex"
-version = "0.3.4"
+version = "0.3.6"
 description = ""
 authors = [
     {name = "Igor Chesnokov",email = "front-gold@mail.ru"}