Retrieve school list.

Author: kiarn

usr/lib/python3/dist-packages/linuxmusterApi/main.py

@@ -69,6 +69,7 @@
     roles,
     samba,
     schoolclasses,
+    schools,
     sessions,
     teachers,
     users,
@@ -105,6 +106,7 @@ def home():
     """
 
 app.include_router(auth.router, prefix="/v1")
+app.include_router(schools.router, prefix="/v1")
 app.include_router(roles.router, prefix="/v1")
 app.include_router(users.router, prefix="/v1")
 app.include_router(teachers.router, prefix="/v1")

usr/lib/python3/dist-packages/linuxmusterApi/routers_v1/schools.py

@@ -0,0 +1,48 @@
+from fastapi import APIRouter, Depends, HTTPException, Request
+
+from security import RoleChecker, AuthenticatedUser
+from linuxmusterTools.ldapconnector import LMNLdapReader as lr
+
+
+router = APIRouter(
+    prefix="/schools",
+    tags=["Schools"],
+    responses={404: {"description": "Not found"}},
+)
+
+@router.get("/", name="List all schools")
+def get_all_schools(who: AuthenticatedUser = Depends(RoleChecker("G"))):
+    """
+    ## List all schools.
+
+    ### Access
+    - global-administrators
+
+    \f
+    :param who: User requesting the data, read from API Token
+    :type who: AuthenticatedUser
+    :return: List of all schools (dict)
+    :rtype: list
+    """
+
+
+    return lr.get('/schools')
+
+@router.get("/{school}", name="Retrieve informations from a specific school")
+def get_all_schools(school: str, who: AuthenticatedUser = Depends(RoleChecker("G"))):
+    """
+    ## Retrieve informations (projects, teachers, students, groups, etc ...)
+    from a specific school. TODO ! NOT WORKING YET.
+
+    ### Access
+    - global-administrators
+
+    \f
+    :param who: User requesting the data, read from API Token
+    :type who: AuthenticatedUser
+    :return: List of all schools (dict)
+    :rtype: list
+    """
+
+
+    return lr.get(f'/schools/{school}')