feat(backend): Initial import till 19e4ed88059b208772589dabee2badf0a46f674b

Author: whyredfire

backend/.gitignore

@@ -0,0 +1,2 @@
+__pycache__
+caddy_data

backend/Dockerfile

@@ -0,0 +1,11 @@
+FROM python:3.13-alpine3.21
+
+WORKDIR /app
+
+COPY ./requirements.txt /app/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /app/requirements.txt
+
+COPY . /app
+
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

backend/README.md

@@ -0,0 +1,263 @@
+# **betterslcm**
+
+### **Info**
+
+- **Version**: 0.1.0
+
+---
+
+### **Paths**
+
+### /
+
+**GET**
+
+**Summary**: Redirect
+
+**[ Responses ]**
+
+code: 200
+
+description: Successful Response
+
+- application/json:
+
+### /status
+
+**GET**
+
+**Summary**: Status
+
+**[ Responses ]**
+
+code: 200
+
+description: Successful Response
+
+- application/json:
+
+### /login
+
+**POST**
+
+**Summary**: Login
+
+**[ Request Body ]** \*
+
+- application/json:
+
+  - $schema: Credentials
+
+**Example Value**:
+
+```json
+{
+    "username" : string,
+    "password" : string
+}
+```
+
+**[ Responses ]**
+
+code: 200
+
+description: Successful Response
+
+- application/json:
+
+code: 422
+
+description: Validation Error
+
+- application/json:
+
+  - $schema: HTTPValidationError
+
+**Example Value**:
+
+```json
+{
+    "detail" : [
+        {
+            "loc" : [
+            ],
+            "msg" : string,
+            "type" : string
+        }
+    ]
+}
+```
+
+### /attendance
+
+**GET**
+
+**Summary**: Attendance
+
+**[ Responses ]**
+
+code: 200
+
+description: Successful Response
+
+- application/json:
+
+### /cgpa
+
+**GET**
+
+**Summary**: Cgpa
+
+**[ Responses ]**
+
+code: 200
+
+description: Successful Response
+
+- application/json:
+
+### /grades
+
+**GET**
+
+**Summary**: Grades
+
+**[ Parameters ]**
+
+| name     |  in   | description |  type   | required |
+| :------- | :---: | :---------- | :-----: | :------: |
+| semester | query |             | integer |    \*    |
+
+**[ Responses ]**
+
+code: 200
+
+description: Successful Response
+
+- application/json:
+
+code: 422
+
+description: Validation Error
+
+- application/json:
+
+  - $schema: HTTPValidationError
+
+**Example Value**:
+
+```json
+{
+    "detail" : [
+        {
+            "loc" : [
+            ],
+            "msg" : string,
+            "type" : string
+        }
+    ]
+}
+```
+
+### /internal_marks
+
+**GET**
+
+**Summary**: Internal Marks
+
+**[ Parameters ]**
+
+| name     |  in   | description |  type   | required |
+| :------- | :---: | :---------- | :-----: | :------: |
+| semester | query |             | integer |    \*    |
+
+**[ Responses ]**
+
+code: 200
+
+description: Successful Response
+
+- application/json:
+
+code: 422
+
+description: Validation Error
+
+- application/json:
+
+  - $schema: HTTPValidationError
+
+**Example Value**:
+
+```json
+{
+    "detail" : [
+        {
+            "loc" : [
+            ],
+            "msg" : string,
+            "type" : string
+        }
+    ]
+}
+```
+
+---
+
+### **Components**
+
+### Schemas
+
+**Credentials**
+
+**username**:
+
+- **string**
+
+  - _required: true_
+
+  - _nullable: false_
+
+**password**:
+
+- **string**
+
+  - _required: true_
+
+  - _nullable: false_
+
+**HTTPValidationError**
+
+**detail**:
+
+- **array [ ValidationError ]**
+
+  - _required: false_
+
+  - _nullable: false_
+
+**ValidationError**
+
+**loc**:
+
+    - _required: true_
+
+    - _nullable: false_
+
+**msg**:
+
+- **string**
+
+  - _required: true_
+
+  - _nullable: false_
+
+**type**:
+
+- **string**
+
+  - _required: true_
+
+  - _nullable: false_
+
+---

backend/main.py

@@ -0,0 +1,38 @@
+from fastapi import FastAPI, HTTPException, Request
+from fastapi.encoders import jsonable_encoder
+from fastapi.responses import JSONResponse
+from fastapi.responses import RedirectResponse
+from fastapi.middleware.cors import CORSMiddleware
+
+from routers import betterslcm
+
+app = FastAPI()
+
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origin_regex=".*",
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+@app.exception_handler(HTTPException)
+async def validation_exception_handler(request: Request, exc: HTTPException):
+    return JSONResponse(
+        status_code=exc.status_code, content=jsonable_encoder(exc.detail)
+    )
+
+
+@app.get("/")
+async def redirect():
+    return RedirectResponse("https://github.com/whyredfire/betterslcm")
+
+
+@app.get("/status")
+async def status():
+    return {"message": "OK"}
+
+
+app.include_router(betterslcm.app, prefix="/api")

backend/requirements.txt

@@ -0,0 +1,48 @@
+annotated-types==0.7.0
+anyio==4.9.0
+astroid==3.3.9
+beautifulsoup4==4.13.3
+bs4==0.0.2
+certifi==2025.1.31
+charset-normalizer==3.4.1
+click==8.1.8
+dill==0.3.9
+dnspython==2.7.0
+email_validator==2.2.0
+fastapi==0.115.11
+fastapi-cli==0.0.7
+h11==0.14.0
+httpcore==1.0.7
+httptools==0.6.4
+httpx==0.28.1
+idna==3.10
+isort==6.0.1
+Jinja2==3.1.6
+markdown-it-py==3.0.0
+MarkupSafe==3.0.2
+mccabe==0.7.0
+mdurl==0.1.2
+platformdirs==4.3.6
+pydantic==2.10.6
+pydantic_core==2.27.2
+Pygments==2.19.1
+pylint==3.3.5
+python-dotenv==1.0.1
+python-multipart==0.0.20
+PyYAML==6.0.2
+requests==2.32.3
+rich==13.9.4
+rich-toolkit==0.13.2
+roman==5.0
+shellingham==1.5.4
+sniffio==1.3.1
+soupsieve==2.6
+starlette==0.46.1
+tomlkit==0.13.2
+typer==0.15.2
+typing_extensions==4.12.2
+urllib3==2.3.0
+uvicorn==0.34.0
+uvloop==0.21.0
+watchfiles==1.0.4
+websockets==15.0.1