fixed lint errors

Author: Tobias Geilen

backend/app/repositories/project_repository.py

@@ -13,7 +13,12 @@ class ProjectRepository:
     @staticmethod
     def list_for_user(db: Session, user_id: int) -> List[Project]:
         """Return all projects owned by the given user."""
-        return db.query(Project).filter(Project.created_by == user_id).order_by(Project.created_at.desc()).all()
+        return (
+            db.query(Project)
+            .filter(Project.created_by == user_id)
+            .order_by(Project.created_at.desc())
+            .all()
+        )
 
     @staticmethod
     def get_for_user(db: Session, project_id: int, user_id: int) -> Optional[Project]:
@@ -32,7 +37,6 @@ def create_for_user(db: Session, user_id: int, project_name: str) -> Project:
         db.commit()
         db.refresh(project)
         return project
-
     @staticmethod
     def update_name(db: Session, project: Project, new_name: str) -> Project:
         """Update the project's name."""

backend/app/routes/project_routes.py

@@ -130,4 +130,3 @@ def remove_paper_from_project(
         db, current_username, project_id, paper_id
     )
 
-

backend/app/schemas/project_dto.py

@@ -46,4 +46,3 @@ class ProjectWithPapersResponse(BaseModel):
     project: ProjectResponse
     papers: List[PaperSummary]
 
-

backend/app/services/project_service.py

@@ -20,6 +20,7 @@ class ProjectService:
 
     @staticmethod
     def _get_user(db: Session, username: str) -> User:
+        """Return the user for the given username or raise 404."""
         user = UserRepository.get_by_username(db, username)
         if user is None:
             raise HTTPException(
@@ -30,6 +31,7 @@ def _get_user(db: Session, username: str) -> User:
 
     @staticmethod
     def list_projects(db: Session, username: str) -> List[ProjectResponse]:
+        """List all projects owned by the given user."""
         user = ProjectService._get_user(db, username)
         projects = ProjectRepository.list_for_user(db, user.user_id)
         return [ProjectResponse.model_validate(p) for p in projects]
@@ -38,6 +40,7 @@ def list_projects(db: Session, username: str) -> List[ProjectResponse]:
     def get_project_with_papers(
         db: Session, username: str, project_id: int
     ) -> ProjectWithPapersResponse:
+        """Return a single project and all of its stored papers."""
         user = ProjectService._get_user(db, username)
         project = ProjectRepository.get_for_user(db, project_id, user.user_id)
         if project is None:
@@ -56,6 +59,7 @@ def get_project_with_papers(
     def create_project(
         db: Session, username: str, payload: ProjectCreate
     ) -> ProjectResponse:
+        """Create a new project for the given user."""
         user = ProjectService._get_user(db, username)
         project = ProjectRepository.create_for_user(
             db, user.user_id, payload.project_name
@@ -66,6 +70,7 @@ def create_project(
     def update_project(
         db: Session, username: str, project_id: int, payload: ProjectUpdate
     ) -> ProjectResponse:
+        """Update metadata of an existing project."""
         user = ProjectService._get_user(db, username)
         project = ProjectRepository.get_for_user(db, project_id, user.user_id)
         if project is None:
@@ -80,6 +85,7 @@ def update_project(
 
     @staticmethod
     def delete_project(db: Session, username: str, project_id: int) -> None:
+        """Delete a project that belongs to the given user."""
         user = ProjectService._get_user(db, username)
         project = ProjectRepository.get_for_user(db, project_id, user.user_id)
         if project is None:
@@ -93,6 +99,7 @@ def delete_project(db: Session, username: str, project_id: int) -> None:
     def add_paper_to_project(
         db: Session, username: str, project_id: int, paper_id: int
     ) -> ProjectWithPapersResponse:
+        """Add a paper reference to the given project."""
         user = ProjectService._get_user(db, username)
         try:
             project = ProjectRepository.add_paper(
@@ -114,6 +121,7 @@ def add_paper_to_project(
     def remove_paper_from_project(
         db: Session, username: str, project_id: int, paper_id: int
     ) -> ProjectWithPapersResponse:
+        """Remove a paper reference from the given project."""
         user = ProjectService._get_user(db, username)
         try:
             project = ProjectRepository.remove_paper(