aiteamutils 0.2.163__py3-none-any.whl → 0.2.165__py3-none-any.whl

aiteamutils/database.py

@@ -12,7 +12,7 @@ from typing import (
     Tuple
 )
 from sqlalchemy.ext.asyncio import AsyncSession
-from sqlalchemy import select, and_, or_
+from sqlalchemy import select, and_, or_, join
 from sqlalchemy.orm import DeclarativeBase, joinedload, selectinload, contains_eager
 from sqlalchemy.exc import SQLAlchemyError
 from datetime import datetime
@@ -30,8 +30,7 @@ ModelType = TypeVar("ModelType", bound=DeclarativeBase)
 
 JoinTarget = Union[
     DeclarativeBase,  # 모델
-    Tuple[DeclarativeBase, BinaryExpression],  # (모델, 조인 조건)
-    Tuple[DeclarativeBase, BinaryExpression, str]  # (모델, 조인 조건, 조인 타입)
+    Tuple[DeclarativeBase, BinaryExpression]  # (모델, 조인 조건)
 ]
 
 ##################
@@ -263,61 +262,6 @@ def build_conditions(
 ##################
 # 쿼리 실행 #
 ##################
-async def execute_query(
-    session: AsyncSession,
-    model: Type[ModelType],
-    explicit_joins: Optional[List[JoinTarget]] = None,
-    loading_joins: Optional[List[Any]] = None,
-    conditions: Optional[List[BinaryExpression]] = None,
-) -> Select:
-    """
-    쿼리 실행을 위한 공통 함수
-    
-    Args:
-        session: 데이터베이스 세션
-        model: 기본 모델
-        explicit_joins: 명시적 조인 설정
-            - 모델만 전달: 기본 outer join
-            - (모델, 조건): 조건부 outer join
-            - (모델, 조건, 'inner'/'left'/'right'): 조인 타입 지정
-        loading_joins: Relationship 로딩 설정 (joinedload, selectinload 등)
-        conditions: WHERE 조건들
-    """
-    # 1. 기본 쿼리 생성
-    query = select(model)
-    
-    # 2. 명시적 조인 처리
-    if explicit_joins:
-        for join_target in explicit_joins:
-            if isinstance(join_target, DeclarativeBase):
-                # 모델만 전달된 경우
-                query = query.outerjoin(join_target)
-            elif isinstance(join_target, tuple):
-                if len(join_target) == 2:
-                    # (모델, 조건)이 전달된 경우
-                    target_model, join_condition = join_target
-                    query = query.outerjoin(target_model, join_condition)
-                elif len(join_target) == 3:
-                    # (모델, 조건, 조인타입)이 전달된 경우
-                    target_model, join_condition, join_type = join_target
-                    if join_type == 'inner':
-                        query = query.join(target_model, join_condition)
-                    elif join_type == 'left':
-                        query = query.outerjoin(target_model, join_condition)
-                    elif join_type == 'right':
-                        query = query.outerjoin(target_model, join_condition, full=True)
-    
-    # 3. Relationship 로딩 설정
-    if loading_joins:
-        for join_option in loading_joins:
-            query = query.options(join_option)
-    
-    # 4. 조건 적용
-    if conditions:
-        query = query.where(and_(*conditions))
-    
-    return query
-
 async def create_entity(
     session: AsyncSession,
     model: Type[ModelType],
@@ -495,18 +439,48 @@ async def list_entities(
     loading_joins: Optional[List[Any]] = None,
     order: Optional[List[Dict[str, str]]] = None
 ) -> List[Dict[str, Any]]:
+    """
+    엔터티 리스트를 필터 및 조건에 따라 가져오는 함수.
+
+    Args:
+        session: SQLAlchemy AsyncSession.
+        model: SQLAlchemy 모델.
+        skip: 페이지네이션 시작 위치.
+        limit: 페이지네이션 크기.
+        filters: 필터 조건 딕셔너리.
+        explicit_joins: 명시적 조인 대상 리스트
+            - 모델만 전달: 기본 outer join
+            - (모델, 조인조건): 조건부 outer join
+        loading_joins: 로딩 조인 옵션 리스트 (joinedload, selectinload 등)
+        order: 정렬 조건 리스트
+
+    Returns:
+        List[Dict[str, Any]]: 쿼리 결과 리스트.
+    """
     try:
-        # 필터 조건 생성
-        conditions = build_conditions(filters, model) if filters else None
-        
         # 기본 쿼리 생성
-        query = await execute_query(
-            session=session,
-            model=model,
-            explicit_joins=explicit_joins,
-            loading_joins=loading_joins,
-            conditions=conditions
-        )
+        query = select(model)
+
+        # 명시적 조인 적용
+        if explicit_joins:
+            for join_target in explicit_joins:
+                if isinstance(join_target, tuple):
+                    # (모델, 조인조건)이 전달된 경우
+                    target_model, join_condition = join_target
+                    query = query.outerjoin(target_model, join_condition)
+                else:
+                    # 모델만 전달된 경우
+                    query = query.outerjoin(join_target)
+
+        # 로딩 조인 적용
+        if loading_joins:
+            for join_option in loading_joins:
+                query = query.options(join_option)
+
+        # 필터 조건 적용
+        if filters:
+            conditions = build_conditions(filters, model)
+            query = query.where(and_(*conditions))
 
         # 정렬 조건 적용
         if order:
@@ -544,21 +518,48 @@ async def get_entity(
     explicit_joins: Optional[List[JoinTarget]] = None,
     loading_joins: Optional[List[Any]] = None
 ) -> ModelType:
+    """
+    조건에 맞는 단일 엔티티를 조회합니다.
+
+    Args:
+        session: SQLAlchemy AsyncSession
+        model: SQLAlchemy 모델
+        conditions: 조회 조건
+        explicit_joins: 명시적 조인 대상 리스트
+            - 모델만 전달: 기본 outer join
+            - (모델, 조인조건): 조건부 outer join
+        loading_joins: 로딩 조인 옵션 리스트 (joinedload, selectinload 등)
+
+    Returns:
+        ModelType: 조회된 엔티티 또는 None
+    """
     try:
-        # 조건을 리스트로 변환
-        condition_list = [getattr(model, key) == value for key, value in conditions.items()]
-        
-        # 쿼리 실행
-        query = await execute_query(
-            session=session,
-            model=model,
-            explicit_joins=explicit_joins,
-            loading_joins=loading_joins,
-            conditions=condition_list
-        )
+        # 기본 쿼리 생성
+        query = select(model)
+
+        # 명시적 조인 적용
+        if explicit_joins:
+            for join_target in explicit_joins:
+                if isinstance(join_target, tuple):
+                    # (모델, 조인조건)이 전달된 경우
+                    target_model, join_condition = join_target
+                    query = query.outerjoin(target_model, join_condition)
+                else:
+                    # 모델만 전달된 경우
+                    query = query.outerjoin(join_target)
+
+        # 로딩 조인 적용
+        if loading_joins:
+            for join_option in loading_joins:
+                query = query.options(join_option)
+
+        # 조건 적용
+        if conditions:
+            for key, value in conditions.items():
+                query = query.where(getattr(model, key) == value)
 
         result = await session.execute(query)
-        return result.scalars().unique().one_or_none()
+        return result.unique().scalars().one_or_none()
 
     except SQLAlchemyError as e:
         raise CustomException(

aiteamutils/version.py

@@ -1,2 +1,2 @@
 """버전 정보"""
-__version__ = "0.2.163"
+__version__ = "0.2.165"

{aiteamutils-0.2.163.dist-info → aiteamutils-0.2.165.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiteamutils
-Version: 0.2.163
+Version: 0.2.165
 Summary: AI Team Utilities
 Project-URL: Homepage, https://github.com/yourusername/aiteamutils
 Project-URL: Issues, https://github.com/yourusername/aiteamutils/issues

{aiteamutils-0.2.163.dist-info → aiteamutils-0.2.165.dist-info}/RECORD

@@ -4,13 +4,13 @@ aiteamutils/base_repository.py,sha256=Oy2zE1i5qx60Xf1tnsaKLyFWapiPqt5JH8NejwNrPW
 aiteamutils/base_service.py,sha256=JIeRtFn1Ll4Qcq3v88pgS9lmEQLQoVyyOKqYR8n02S4,21192
 aiteamutils/cache.py,sha256=07xBGlgAwOTAdY5mnMOQJ5EBxVwe8glVD7DkGEkxCtw,1373
 aiteamutils/config.py,sha256=YdalpJb70-txhGJAS4aaKglEZAFVWgfzw5BXSWpkUz4,3232
-aiteamutils/database.py,sha256=zXYhdUVgAisz4BuXZPPbvVLZ9lwRe7aVQP8J1AVE88Y,21771
+aiteamutils/database.py,sha256=090b9M3o3nYsckVlfybC5LV7wUXS6n0Pve2yDOF_Y48,21669
 aiteamutils/enums.py,sha256=7WLqlcJqQWtETAga2WAxNp3dJTQIAd2TW-4WzkoHHa8,2498
 aiteamutils/exceptions.py,sha256=sgIVulllKMM9InTltaB7VD6i7DiQvCoycexsV-BiIBY,16570
 aiteamutils/files.py,sha256=fxnCu9rErd4vCovMi0jy4adLUiA7rx_q4RdOL4wSgsU,14258
 aiteamutils/security.py,sha256=McUl3t5Z5SyUDVUHymHdDkYyF4YSeg4g9fFMML4W6Kw,11630
 aiteamutils/validators.py,sha256=_WHN6jqJQzKM5uPTg-Da8U2qqevS84XeKMkCCF4C_lY,9591
-aiteamutils/version.py,sha256=MbP3Sxzx6eYugMlpPFw2qfjDxYmMdJwa_4K4MStAl1s,43
-aiteamutils-0.2.163.dist-info/METADATA,sha256=pgSEMmDcvxJrKq3Y-CmLEuXgd2K5vKvm8SQfa3jIuvA,1743
-aiteamutils-0.2.163.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-aiteamutils-0.2.163.dist-info/RECORD,,
+aiteamutils/version.py,sha256=TC_spO53XsoBjGPdVSQjcP1vTh3Fno23EerP6g6nB58,43
+aiteamutils-0.2.165.dist-info/METADATA,sha256=lRRin2H5r_RB8ha8ciB7hZo4fl-2M1C-L-c9V7SwOXA,1743
+aiteamutils-0.2.165.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+aiteamutils-0.2.165.dist-info/RECORD,,