LSF Automation

Small automation script to log into the LSF portal, fetch the "Notenspiegel" table and summarize grades/points.

Features

• Logs into LSF using Selenium
• Navigates to the Notenspiegel page and extracts table rows
• Calculates average grade and total points
• Outputs on the console the course name, grade and points received
• Writes runtime logs to logs/

How to use

1. Clone the repository:

git clone https://github.com/tiagomorato/lsf-automation.git
cd lsf-automation

2. Create and activate a Python virtual environment:

python -m venv .venv
source .venv/bin/activate

3. Install project dependencies declared in pyproject.toml.

If you use pip (will build and install the project and its dependencies):

pip install .

4. Create a .env file in the project root and add your credentials:

LOGIN=your_username
PASSWORD=your_password

5. Run the automation script:

python lsf_automation.py

Chrome & ChromeDriver

Ensure Google Chrome (or Chromium) is installed and a compatible ChromeDriver is available on your PATH.

• Version compatibility: Chrome and ChromeDriver must have matching major versions (for example Chrome 116 → ChromeDriver 116). If versions differ you may see session or startup errors.

• Installing ChromeDriver:

  • Linux (Debian/Ubuntu): sudo apt install chromium-chromedriver (package name and availability vary by distro).
  • Manual: download the matching driver from https://chromedriver.chromium.org/downloads and place it on your PATH.

• Alternative (recommended): use webdriver-manager to automatically download the correct driver:

pip install webdriver-manager

Example Python usage with webdriver-manager:

from selenium import webdriver
from webdriver_manager.chrome import ChromeDriverManager

driver = webdriver.Chrome(ChromeDriverManager().install())

Using webdriver-manager avoids manual driver installs and version mismatch issues.

Logs

Logs are written into the directory specified by LOG_DIR (default: logs). Log filename includes a timestamp.