from typing import Generic, Type, TypeVar, List, Optional, Any, Dict, Union from sqlalchemy.orm import Session from app.models.base import Base # Type variable bound to SQLAlchemy Declarative Base ModelType = TypeVar("ModelType", bound=Base) class BaseRepository(Generic[ModelType]): """ Generic Base Repository containing common CRUD database operations. Designed to reduce boilerplate code across all entities. """ def __init__(self, model: Type[ModelType]): self.model = model def get(self, db: Session, id: Any) -> Optional[ModelType]: """Fetch a single record by its primary key ID.""" return db.query(self.model).filter(self.model.id == id).first() def get_all(self, db: Session, skip: int = 0, limit: int = 100) -> List[ModelType]: """Fetch a list of records with optional pagination limits.""" return db.query(self.model).offset(skip).limit(limit).all() def create(self, db: Session, obj_in: Any) -> ModelType: """Create a new database record from a dictionary or Pydantic model.""" if hasattr(obj_in, "model_dump"): obj_data = obj_in.model_dump() elif hasattr(obj_in, "dict"): obj_data = obj_in.dict() else: obj_data = dict(obj_in) db_obj = self.model(**obj_data) db.add(db_obj) db.commit() db.refresh(db_obj) return db_obj def update(self, db: Session, db_obj: ModelType, obj_in: Union[Any, Dict[str, Any]]) -> ModelType: """Update an existing database record with new field values.""" if isinstance(obj_in, dict): update_data = obj_in elif hasattr(obj_in, "model_dump"): update_data = obj_in.model_dump(exclude_unset=True) elif hasattr(obj_in, "dict"): update_data = obj_in.dict(exclude_unset=True) else: update_data = dict(obj_in) for field in update_data: if hasattr(db_obj, field): setattr(db_obj, field, update_data[field]) db.add(db_obj) db.commit() db.refresh(db_obj) return db_obj def delete(self, db: Session, id: Any) -> Optional[ModelType]: """Delete a record by its primary key ID.""" db_obj = db.query(self.model).filter(self.model.id == id).first() if db_obj: db.delete(db_obj) db.commit() return db_obj