setup.sh

#!/bin/bash

# Student Attendance Tracker setup script
#global variables
myprog_name=""
prog_dir=""
setup_done=false

# Ctrl+C handler

cancel_when_interrupted() {
       echo "Interrupted, canceling..."

    if [ -d "$prog_dir" ]; then

               arch_name="attendance_tracker_${myprog_name}_archive.tar.gz"

        echo "Archiving the incomplete project..."
        tar -czf "$arch_name" "$prog_dir" 2>/dev/null


        if [ $? -eq 0 ]; then
            echo "Archive created: $arch_name"
        else
            echo "Failed to create archive"
        fi

                echo "removing incomplete directory..."
        rm -rf "$prog_dir"

        if [ ! -d "$prog_dir" ]; then
            echo "Directory $prog_dir removed successfuly"
        else
            echo "Failed to remove $prog_dir directory"
        fi
    echo "Setting the directory is cancelled"
fi
    exit 1
}

# validations

place_for_validation() {

    echo "checking environment.."

     echo -n "Verifying for Python3.."

    if command -v python3 &> /dev/null; then
                python_version3=$(python3 --version 2>&1)
        echo "Found"
        echo "$python_version3"
            else
        echo "Python not found, try another option"
        echo "Python3 required to run this script"
    fi

    }

# project name
fetch_prog_name() {
       echo "Student Attendance Tracker"

    while true; do
        echo -n "Enter project name: "
        read myprog_name
        if [ -z "$myprog_name" ]; then
            echo "Input can not be empty"
            echo ""
            continue
        fi
        myprog_name=$(echo "$myprog_name" | tr -d ' ' | tr '[:upper:]' '[:lower:]')
        prog_dir="attendance_tracker_${myprog_name}"

        if [ -d "$prog_dir" ]; then
            echo ""
            echo "directory '$prog_dir' already existing"
            echo -n "$myprog_name will you make changes? (yes/no): " 
            read changes

            if [ "$changes" = "yes" ] || [ "$changes" = "Yes" ]; then
                echo "Deleting the existing directory $myprog_name"  
                rm -rf "$prog_dir"

                if [ $? -eq 0 ]; then
                    echo "The existing directory deleted"
                    break
                else
                    echo "Failed to delete the existing directory"   
                    exit 1
                fi
               break
            else
                echo "Choose a different project name"
                echo ""
            fi
        else
            break
        fi
    done
   echo "Project name: $myprog_name"
    echo "Target directory: $prog_dir"

}

# create structure
make_dir_structure() {
       echo "Making directory structure"
        mkdir -p "$prog_dir"

    if [ -d "$prog_dir" ]; then
        echo "Main directoty Created: $prog_dir/"
    else
        echo "main directory failed"
        exit 1
    fi
    mkdir -p "$prog_dir/Helpers"

    if [ -d "$prog_dir/Helpers" ]; then
        echo "Helper directory Created: $prog_dir/Helpers/"
    else
        echo "Helpers directory failed"
        exit 1
    fi

    mkdir -p "$prog_dir/reports"

    if [ -d "$prog_dir/reports" ]; then
        echo "Report directory Created: $prog_dir/reports/"
    else
        echo "reports directory failed"
        exit 1
    fi
    echo "directory structure created"

}

# generate files
construct_application_files() {
       echo "Constructing project files..."

       # attendance_checker.py
       cat > "$prog_dir/attendance_checker.py" << 'pyattendance_checker'
#!/usr/bin/env python3
import csv
import json
import os
from datetime import datetime

def run_attendance_check():
    # 1. Load Config
    with open('Helpers/config.json', 'r') as f:
        config = json.load(f)

    # 2. Archive old reports.log if it exists
    if os.path.exists('reports/reports.log'):
        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
        os.rename('reports/reports.log', f'reports/reports_{timestamp}.log.archive')

    # 3. Process Data
    with open('Helpers/assets.csv', mode='r') as f, open('reports/reports.log', 'w') as log:
        reader = csv.DictReader(f)
        total_sessions = config['total_sessions']

        log.write(f"--- Attendance Report Run: {datetime.now()} ---\n")

        for row in reader:
            name = row['Names']
            email = row['Email']
            attended = int(row['Attendance Count'])

            # Simple Math: (Attended / Total) * 100
            attendance_pct = (attended / total_sessions) * 100       

            message = ""
            if attendance_pct < config['thresholds']['failure']:     
                message = f"URGENT: {name}, your attendance is {attendance_pct:.1f}%. You will fail this class."
            elif attendance_pct < config['thresholds']['warning']:   
                message = f"WARNING: {name}, your attendance is {attendance_pct:.1f}%. Please be careful."

            if message:
                if config['run_mode'] == "live":
                    log.write(f"[{datetime.now()}] ALERT SENT TO {email}: {message}\n")
                    print(f"Logged alert for {name}")
                else:
                    print(f"[DRY RUN] Email to {email}: {message}")  

if __name__ == "__main__":
    run_attendance_check()
pyattendance_checker

    # execution
    chmod +x "$prog_dir/attendance_checker.py"

    if [ -f "$prog_dir/attendance_checker.py" ]; then
        echo "Execution created: attendance_checker.py"
    else
        echo "Execution failed: attendance_checker.py"
        exit 1
    fi

        # assets.csv
       cat > "$prog_dir/Helpers/assets.csv" << 'csv_file'
Email,Names,Attendance Count,Absence Count
alice@example.com,Alice Johnson,14,1
bob@example.com,Bob Smith,7,8
charlie@example.com,Charlie Davis,4,11
diana@example.com,Diana Prince,15,0
moses@example.com,Mugisha Moses,2,1
csv_file

    if [ -f "$prog_dir/Helpers/assets.csv" ]; then
        echo "Assets file created: Helpers/assets.csv"
    else
        echo "Assets file Failed"
        exit 1
    fi

    # config.json
       cat > "$prog_dir/Helpers/config.json" << 'json_file'
{
    "thresholds": {
        "warning": 75,
        "failure": 50
    },
    "run_mode": "live",
    "total_sessions": 15
}


json_file

    if [ -f "$prog_dir/Helpers/config.json" ]; then
        echo "config file Created: Helpers/config.json (defaults: 75%, 50%)"
    else
        echo "Config file Failed"
        exit 1
    fi


    # reports.log
        cat > "$prog_dir/reports/reports.log" << log_file


Student Attendance Tracker, Log report
Initiated by: $(date)
log_file

    if [ -f "$prog_dir/reports/reports.log" ]; then
        echo "Report file Created"
    else
        echo "Report file Failed"
        exit 1
    fi

    echo ""
    echo "files generated successfully"
    echo ""
}

# Update thresholds
adjust_thresholds() {
       echo "Settings for configurations"

    echo -n "Do you want to update these thresholds? (yes/no): "     
    read adjust_thresholds

    if [ "$adjust_thresholds" = "yes" ] || [ "$adjust_thresholds" = "y" ]; then
        echo "Adjusting thresholds..."

        while true; do
            echo -n " Please enter your new warning threshold (75-100): "
            read warning_thresholds

            if ! [[ "$warning_thresholds" =~ ^[0-9]+$ ]]; then       
                echo "Please enter a number"
                continue
            fi

             if [ "$warning_thresholds" -lt 75 ] || [ "$warning_thresholds" -gt 100 ]; then
                echo "The number must be between 75 and 100"
                continue
            fi

            # Passed validations
            echo "You have Completed Warning threshold: $warning_thresholds%"
            break
        done

                # Fetch failure threshold and validation
                while true; do
            echo -n "Please enter new failure threshold (50-100): "  
            read failure_thresholds

            # Checking input and and validations
            if ! [[ "$failure_thresholds" =~ ^[0-9]+$ ]]; then       
                echo "Input must be a numeric characher"
                continue
            fi

            if [ "$failure_thresholds" -lt 50 ] || [ "$failure_thresholds" -gt 100 ]; then
                echo "The number must be in between 50 and 100"      
                continue
            fi

            # Failure% and warning%
            if [ "$failure_thresholds" -ge "$warning_thresholds" ]; then
                echo "Failure (%) threshold must be less than warning (%) threshold"
                echo "Currently warning percentage: $warning_thresholds%"
                continue
            fi
            echo "The Failure threshold is: $failure_thresholds%"    
            break
        done

        echo "Applying configuration"

               # sed and config
                conf_file="$prog_dir/Helpers/config.json"

        # Update warning_threshold using sed
        # Layout: "warning_threshold": <any_number>
        # Convert to: "warning_threshold": <new_value>
       sed -i "s/\"warning\":[[:space:]]*[0-9]*/\"warning\": $warning_thresholds/" "$conf_file"
       sed -i "s/\"failure\":[[:space:]]*[0-9]*/\"failure\": $failure_thresholds/" "$conf_file"

        if [ $? -eq 0 ]; then
            echo "The warning_threshold is being updated to $warning_thresholds"
        else
            echo "Updating failed in warning_threshold"
        fi

        # sed update failure_threshold
        sed -i "s/\"failure_threshold\": [0-9]*/\"failure_threshold\": $failure_thresholds/" "$conf_file"

        if [ $? -eq 0 ]; then
            echo "The failure_threshold has been updated to $failure_thresholds"
        else
            echo "The updating proccess failed in failure_threshold" 
        fi
        echo "Updated the configuration successfully"
        echo "Warning Threshold: ${warning_thresholds}%"
        echo "Failure Threshold: ${failure_thresholds}%"
    else
        echo "Using default thresholds (Warning: 75%, Failure: 50%)" 
    fi

}

# verify structure
check_structure() {
       echo "Verifying structure of project"

    verif_passed=true

    # Checking directories
    if [ -d "$prog_dir" ]; then
        echo "Our project's main directory exists: $prog_dir/"       
    else
        echo "Our project's main directory does not exist: $prog_dir/"
        verif_passed=false
    fi

    if [ -d "$prog_dir/Helpers" ]; then
        echo "The helpers Subdirectory already exists: Helpers/"     
    else
        echo "The helpers Subdirectory does not exist: Helpers/"     
        verif_passed=false
    fi

    # Checking for the reports subdirectory
    if [ -d "$prog_dir/reports" ]; then
        echo "The reports Subdirectory arleady exists: reports/"     
    else
        echo "Subdirectory not existing: reports/"
        verif_passed=false
    fi

    # Checking for all required files
    check_files=(
        "attendance_checker.py"
        "Helpers/assets.csv"
        "Helpers/config.json"
        "reports/reports.log"
    )

    for file in "${check_files[@]}"; do
        if [ -f "$prog_dir/$file" ]; then
            echo "Found: $file"
        else
            echo "Files missing: $file"
            verif_passed=false
        fi
    done

    echo ""

    # Final verifications
    if [ "$verif_passed" = true ]; then
               echo "structure's verification passed"
               return 0
    else
               echo "Structure's verification failed to pass"        
               echo "Check the error and try again later."
        return 1
    fi
}

# view summary
view_summary() {
    echo ""
        echo "Setup completed"
       echo "Project specifications:"
    echo "Directory: $prog_dir"
    echo "number of Files: 4 files created (Python file, CSV file, JSON file, LOG log)"
    }

# Main execution
trap cancel_when_interrupted SIGINT

fetch_prog_name
make_dir_structure
construct_application_files
adjust_thresholds
place_for_validation

echo "Student Attendance Tracker setup"
if check_structure; then
    setup_done=true
    view_summary

       exit 0
else
      echo "setup failed during verification"
       exit 1
fi