Pretty Entrar Assignments Dashboard

User-friendly assignments dashboard for all Entrar users! Check it out at assignments.ronakbuilds.tech Note: This is an independent student-made interface enhancement project and is not affiliated with Entrar. Credentials are transmitted securely over HTTPS and are not stored anywhere, ever.

The Problem

It's difficult to find entrar assignments with ease, especially if you're in a hurry. They are hidden behind multiple pages and dropdowns. Pretty Entrar Dashboard comes in and saves you from all the trouble. Simply login with your Entrar credentials and find all your assignments instantly! No hunting needed anymore.

Project Structure

pretty-entrar-dashboard/
├── templates/
│   └── index.html
├── utils/
│   └── assignment_extractor.py
├── .gitignore
├── app.py
├── assignment_extractor_pipeline.py
├── README.md
└── requirements.txt

Architecture

┌─────────────────────────────────────────────────────────────────────┐
│                             PYTHON BACKEND                          │
│                                                                     │
│   ┌──────────────────────┐                                          │
│   │   requests.Session() │                                          │
│   │                      │                                          │
│   │  POST /login/auth/   │──────────────────────►  entrar.in        │
│   │  { username, pass }  │                                          │
│   │                      │◄──────────────────────  Set-Cookie:      │
│   │  session cookie      │                          session_id      │
│   └──────────┬───────────┘                                          │
│              │                                                      │
│              │ session.post(/pp_assignment/classassignment)         │
│              │ { search_assignment: true }                          │
│              │                                                      │
│              ▼                                                      │
│   ┌──────────────────────┐                                          │
│   │   BeautifulSoup      │◄──── raw HTML (AJAX response)            │
│   │                      │                                          │
│   │  find_all("a",       │                                          │
│   │   class_=            │                                          │
│   │  "attachment_display"│                                          │
│   │   style="color:red") │                                          │
│   └──────────┬───────────┘                                          │
│              │                                                      │
│              │  [ { title, url }, { title, url }, ... ]             │
│              │                                                      │
│              ▼                                                      │
│   ┌──────────────────────┐                                          │
│   │   FastAPI            │                                          │
│   │                      │                                          │
│   │  POST                │                                          │
│   │  /fetch-assignments  │                                          │
│   │                      │                                          │
│   │  return assignment   │                                          │
│   │  _list  →  JSON      │                                          │
│   └──────────┬───────────┘                                          │
│              │                                                      │
└──────────────┼──────────────────────────────────────────────────────┘
               │
               │  HTTP  application/json
               │
               ▼
   ┌───────────────────────────────────────────────┐
   │   https://assignments.ronakbuilds.tech/       │
   │                                               │
   │   index.html                                  │
   │   fetch("/fetch-assignments")                 │
   │                                               │ 
   │   renderCards(data)                           │
   │   [ PDF ]  title                              │
   │   [DOCX]  title                               │
   └───────────────────────────────────────────────┘

Running locally

To run the project on your local machine, open your terminal and run the following commands:

git clone https://github.com/fourtysevencode/pretty-entrar-dashboard.git

pip install -r requirements.txt

cd pretty-entrar-dashboard

uvicorn app:app --reload

Update base in templates/index.html to http://localhost:8000 (line 343)

Then head to http://localhost:8000 on your preferred web browser.

Endpoints

License

MIT

with 💗 from fourtysevencode