fastapi-sqlalchemy-toolkit 0.6.3__tar.gz → 0.6.5__tar.gz

{fastapi_sqlalchemy_toolkit-0.6.3 → fastapi_sqlalchemy_toolkit-0.6.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fastapi_sqlalchemy_toolkit
-Version: 0.6.3
+Version: 0.6.5
 Summary: FastAPI SQLAlchemy Toolkit
 Project-URL: Homepage, https://github.com/e-kondr01/fastapi-sqlalchemy-toolkit
 Author-email: Egor Kondrashov <e.kondr01@gmail.com>
@@ -92,8 +92,6 @@ my_model_manager = ModelManager[MyModel, MyModelCreateSchema, MyModelUpdateSchem
 - `count` - получение количества объектов
 - `update` - обновление объекта; выполняет валидацию значений полей на уровне БД
 - `delete` - удаление объекта
-- `bulk_create` - создание объектов пачкой; выполняет валидацию значений полей на уровне БД
-- `bulk_update` - обновление объектов пачкой; выполняет валидацию значений полей на уровне БД
 
 ## Фильтрация
 

{fastapi_sqlalchemy_toolkit-0.6.3 → fastapi_sqlalchemy_toolkit-0.6.5}/README.md

@@ -75,8 +75,6 @@ my_model_manager = ModelManager[MyModel, MyModelCreateSchema, MyModelUpdateSchem
 - `count` - получение количества объектов
 - `update` - обновление объекта; выполняет валидацию значений полей на уровне БД
 - `delete` - удаление объекта
-- `bulk_create` - создание объектов пачкой; выполняет валидацию значений полей на уровне БД
-- `bulk_update` - обновление объектов пачкой; выполняет валидацию значений полей на уровне БД
 
 ## Фильтрация
 

{fastapi_sqlalchemy_toolkit-0.6.3 → fastapi_sqlalchemy_toolkit-0.6.5}/fastapi_sqlalchemy_toolkit/model_manager.py

@@ -180,7 +180,7 @@ class ModelManager(Generic[ModelType, CreateSchemaType, UpdateSchemaType]):
         **simple_filters: Any,
     ) -> ModelType | Row:
         """
-        Получение одного экземпляра модели или возвращение HTTP ответа 404.
+        Получение одного экземпляра модели или вызов HTTP исключения 404.
 
         :param session: сессия SQLAlchemy
 
@@ -209,10 +209,12 @@ class ModelManager(Generic[ModelType, CreateSchemaType, UpdateSchemaType]):
             select_=select_,
             **simple_filters,
         )
-        attrs_str = ", ".join(
-            [f"{key}={value}" for key, value in simple_filters.items()]
-        )
         if not db_obj:
+            attrs_str = ", ".join(
+                [f"{key}={value}" for key, value in simple_filters.items()]
+            )
+            if where:
+                attrs_str += f", {where}"
             raise HTTPException(
                 status_code=status.HTTP_404_NOT_FOUND,
                 detail=f"{self.model.__tablename__} with {attrs_str} not found",
@@ -223,7 +225,6 @@ class ModelManager(Generic[ModelType, CreateSchemaType, UpdateSchemaType]):
         self,
         session: AsyncSession,
         options: List[Any] | Any | None = None,
-        order_by: OrderingField | None = None,
         where: Any | None = None,
         **simple_filters: Any,
     ) -> bool:
@@ -234,8 +235,6 @@ class ModelManager(Generic[ModelType, CreateSchemaType, UpdateSchemaType]):
 
         :param options: параметры для метода .options() загрузчика SQLAlchemy
 
-        :param order_by: поле для сортировки (экземпляр OrderingField)
-
         :param where: выражение, которое будет передано в метод .where() SQLAlchemy
 
         :param simple_filters: параметры для фильтрации по точному соответствию,
@@ -244,12 +243,54 @@ class ModelManager(Generic[ModelType, CreateSchemaType, UpdateSchemaType]):
         :returns: True если объект существует, иначе False
         """
         stmt = self.assemble_stmt(
-            select(self.model.id), order_by, options, where, **simple_filters
+            select(self.model.id), None, options, where, **simple_filters
         )
-
         result = await session.execute(stmt)
         return result.first() is not None
 
+    async def exists_or_404(
+        self,
+        session: AsyncSession,
+        options: List[Any] | Any | None = None,
+        where: Any | None = None,
+        **simple_filters: Any,
+    ) -> bool:
+        """
+        Проверка существования экземпляра модели.
+        Если объект не существует, вызывает HTTP исключение 404.
+
+        :param session: сессия SQLAlchemy
+
+        :param options: параметры для метода .options() загрузчика SQLAlchemy
+
+        :param where: выражение, которое будет передано в метод .where() SQLAlchemy
+
+        :param simple_filters: параметры для фильтрации по точному соответствию,
+        аналогично методу .filter_by() SQLAlchemy
+
+        :returns: True, если объект существует
+
+        :raises: fastapi.HTTPException 404
+        """
+
+        exists = await self.exists(
+            session,
+            options=options,
+            where=where,
+            **simple_filters,
+        )
+        if not exists:
+            attrs_str = ", ".join(
+                [f"{key}={value}" for key, value in simple_filters.items()]
+            )
+            if where:
+                attrs_str += f", {where}"
+            raise HTTPException(
+                status_code=status.HTTP_404_NOT_FOUND,
+                detail=f"{self.model.__tablename__} with {attrs_str} does not exist",
+            )
+        return True
+
     async def paginated_filter(
         self,
         session: AsyncSession,
@@ -579,94 +620,6 @@ class ModelManager(Generic[ModelType, CreateSchemaType, UpdateSchemaType]):
             await session.commit()
         return db_obj
 
-    async def bulk_create(
-        self,
-        session: AsyncSession,
-        in_objs: List[CreateSchemaType | dict],
-        commit: bool = True,
-        **attrs: Any,
-    ) -> List[ModelType]:
-        """
-        Создание экземпляров модели и сохранение в БД пачкой.
-        Также выполняет валидацию на уровне БД.
-
-        :param session: сессия SQLAlchemy
-
-        :param in_objs: список значений полей создаваемых экземпляров модели
-
-        :param commit: нужно ли вызывать `session.commit()`
-
-        :param attrs: дополнительные значения полей создаваемого экземпляра
-        (чтобы какие-то поля можно было установить напрямую из кода,
-        например, пользователя запроса)
-
-        :returns: список созданных экземпляров модели
-        """
-        objs = []
-        for in_obj in in_objs:
-            if not isinstance(in_obj, dict):
-                in_obj = in_obj.model_dump()
-            in_obj.update(**attrs)
-            await self.run_db_validation(session, in_obj=in_obj)
-            db_obj = self.model(**in_obj)
-            objs.append(db_obj)
-        session.add_all(objs)
-        if commit:
-            await session.commit()
-            for db_obj in objs:
-                await session.refresh(db_obj)
-        return objs
-
-    async def bulk_update(
-        self,
-        session: AsyncSession,
-        in_objs: dict[ModelType, UpdateSchemaType],
-        commit: bool = True,
-        exclude_unset: bool = True,
-        **attrs: Any,
-    ) -> List[ModelType]:
-        """
-        Обновление экземпляров модели в БД пачкой.
-        Также выполняет валидацию на уровне БД.
-
-        :param session: сессия SQLAlchemy
-
-        :param db_obj: обновляемый объект
-
-        :param in_objs: словарь обновляемых объектов, где ключ -- существующий объект,
-        значение -- схема Pydantic для обновления значений его полей.
-
-        :param commit: нужно ли вызывать `session.commit()`
-
-        :param exclude_unset: передаётся в метод `.model_dump()` Pydantic модели.
-        При использовании метода в PATCH-запросах имеет смысл оставлять его True
-        для изменения только переданных полей; при PUT-запросах имеет смысл
-        передавать False, чтобы установить дефолтные значения полей, заданные
-        в модели Pydantic.
-
-        :param attrs: дополнительные значения обновляемых полей
-        (чтобы какие-то поля можно было установить напрямую из кода,
-        например, пользователя запроса)
-
-        :returns: список обновлённых экземпляров модели
-        """
-        for obj, in_obj in in_objs.items():
-            if isinstance(in_obj, dict):
-                update_data = in_obj
-            else:
-                update_data = in_obj.model_dump(exclude_unset=exclude_unset)
-            update_data.update(attrs)
-            await self.run_db_validation(session, db_obj=obj, in_obj=update_data)
-            for field in update_data:
-                setattr(obj, field, update_data[field])
-            session.add(obj)
-        if commit:
-            await session.commit()
-            updated_objs = list(in_objs.keys())
-            for updated_obj in updated_objs:
-                await session.refresh(updated_obj)
-        return updated_objs
-
     ##################################################################################
     # Internal methods
     ##################################################################################

{fastapi_sqlalchemy_toolkit-0.6.3 → fastapi_sqlalchemy_toolkit-0.6.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fastapi_sqlalchemy_toolkit"
-version = "0.6.3"
+version = "0.6.5"
 authors = [
   { name="Egor Kondrashov", email="e.kondr01@gmail.com" },
 ]