Add documentation to post service class and methods (#52)

backend/api/post.py

@@ -1,3 +1,7 @@
+"""Post API
+
+This API is used to create, retrieve, and delete posts for CSXL forum page"""
+
 from fastapi import APIRouter, Depends, HTTPException
 from ..services import PostService, UserService
 from ..models import Post
@@ -8,6 +12,10 @@
 
 @api.post("", response_model=Post, tags=['Post'])
 def create(post: Post, post_svc: PostService = Depends(), usr_svc: UserService = Depends()):
+    """Create a new post     
+    If post author is not registered in CSXL User database, throw 422 Error
+    Verify author is registered by calling findUser method form UserService"""
+
     try:
         user_entity = usr_svc.findUser(post.user)
     except:
@@ -16,10 +24,13 @@ def create(post: Post, post_svc: PostService = Depends(), usr_svc: UserService =
 
 @api.get("", response_model=list[Post], tags=['Post'])
 def getAll(post_svc: PostService = Depends()):
+    """Retrieve all forum posts to be displayed in viewForum""" 
     return post_svc.getAll()
 
 @api.delete("/{id}", tags=['Post'])
 def delete(id: int, post_svc: PostService = Depends()) -> bool:
+    """Delete a specific forum post from database by id
+    If post with associated id does not exist, throw 422 error""" 
     try:
         return post_svc.delete(id=id)
     except:

backend/api/user.py

@@ -1,3 +1,7 @@
+"""User API
+
+This API is used to create, retrieve, and delete posts for CSXL forum page"""
+
 from fastapi import APIRouter, Depends
 from ..services import UserService
 from ..models import User

backend/entities/post_entity.py

@@ -1,4 +1,4 @@
-'''User accounts for all registered users in the application.'''
+'''Entity for all Posts in application'''
 
 
 from sqlalchemy import Integer, String, ForeignKey, Text