Get student info prototyped

Author: ConlynPattison

src/api.py

@@ -10,6 +10,7 @@
 from src.students.missing_students.router import router as student_recover_attendance_router
 from src.students.attendance_entry.router import router as student_attendance_entry_router
 from src.students.withdrawal_processing.router import router as student_withdrawal_router
+from src.slack.student_info.router import router as student_info_router
 
 from src.gsheet.refresh.router import router as gsheet_refresh_router
 from src.utils.authorization import verify_api_key
@@ -91,4 +92,10 @@
     gsheet_refresh_router,
     prefix="/gsheet/refresh",
     tags=["GSheet"],
-)
+)
+
+api_router.include_router(
+    student_info_router,
+    prefix="/slack/students/info",
+    tags=["Stack"],
+)

src/slack/__init__.py

@@ -0,0 +1,23 @@
+from typing import Any, Dict
+
+from fastapi import APIRouter, Depends, status
+from sqlalchemy.orm import Session
+
+from src.database.postgres.core import make_session
+from src.slack.student_info.service import fetch_student_info
+from src.utils.exceptions import handle_db_exceptions 
+
+router = APIRouter()
+
+@router.get("", status_code=status.HTTP_200_OK)
+def fetch_student_information(
+    user_email: str,
+    db: Session = Depends(make_session),
+) -> Dict[str, Any]:
+    """
+    Fetch student information from the database.
+    """
+    try:
+        return fetch_student_info(db, user_email)
+    except Exception as exc:
+        handle_db_exceptions(db, exc)

src/slack/student_info/__init__.py

@@ -0,0 +1,43 @@
+from sqlalchemy import select
+from sqlalchemy.orm import Session
+
+from src.database.postgres.models import Student, StudentEmail
+
+def fetch_student_info(db: Session, user_email: str):
+    """
+    first_name Student.fname
+    last_name Student.lname
+    preferred_name Student.pname
+    primary_email StudentEmail          !!
+    institution Student.institution
+    target_year Student.target_year
+    join_date Student.join_date
+    gender Student.gender
+    ethnicity Student.ethnicities_agg   ??
+    birthday Student.birthday
+    first_generation Student.first_gen
+    """
+
+    select_stmt = select(
+        Student.cti_id,
+        Student.fname,
+        Student.lname,
+        Student.pname,
+        Student.institution,
+        Student.target_year,
+        Student.join_date,
+        Student.gender,
+        Student.ethnicities_agg,
+        Student.birthday,
+        Student.first_gen,
+        StudentEmail.email).join(StudentEmail).where(StudentEmail.email == user_email)   
+    
+    results = db.execute(select_stmt).all()
+
+    if len(results) == 0:
+        raise ValueError("No student records found")
+    
+    if len(results) > 1:
+        raise ValueError("Multiple student records found")
+    
+    return results[0]._asdict()