CompetencyAssessmentUtil.java

package de.hftstuttgart.dtabackend.utils;

import java.io.BufferedReader;
import java.io.FileReader;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.ArrayList;
import java.util.List;
import java.util.stream.Collectors;
import java.util.stream.IntStream;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
import de.hftstuttgart.dtabackend.models.ExerciseCompetencyProfile;
import de.hftstuttgart.dtabackend.models.ICompetencyProfile;
import de.hftstuttgart.dtabackend.models.Result;
import de.hftstuttgart.dtabackend.models.ResultSummary;
import de.hftstuttgart.dtabackend.models.TestCompetencyProfile;

public class CompetencyAssessmentUtil {
    private static final Logger LOG = LogManager.getLogger(CompetencyAssessmentUtil.class);

    public static final String TEST_COMPETENCY_MANIFEST_FILE_NAME = "competency-tests.mft";
    public static final String EXERCISE_COMPETENCY_MANIFEST_FILE_NAME = "exercise-tests.mft";

    /**
     * Retrieves the base directory where the test competency manifest is located

     * by traversing upwards until it finds the file "exercise-tests.mft".

     * 

     * @param startDir Starting directory path to begin the search

     * @return Path of the base directory if found; otherwise, null
     */
    public static Path getBaseDirectory(Path startDir) {
        Path currentDir = startDir;
        while (currentDir != null) {
            Path manifestPath = currentDir.resolve(EXERCISE_COMPETENCY_MANIFEST_FILE_NAME);
            if (Files.exists(manifestPath)) {
                return currentDir;
            }
            currentDir = currentDir.getParent(); 
        }
        LOG.warn("Base directory with " + EXERCISE_COMPETENCY_MANIFEST_FILE_NAME + " not found starting from " + startDir);
        return null;
    }

    /**
     * Reads and loads test competency profiles from the base directory.

     *

     * @param exercisePath Path to the starting exercise directory

     * @return List of TestCompetencyProfile instances loaded from the manifest
     */
    public static List<TestCompetencyProfile> readTestCompetencyProfiles(Path exercisePath) {
        Path baseDir = getBaseDirectory(exercisePath);
        if (baseDir == null) {
            LOG.error("Unable to locate the base directory for reading test competency profiles.");
            return null;
        }
        return readTestCompetencyProfiles(baseDir, TEST_COMPETENCY_MANIFEST_FILE_NAME);
    }

    /**
     * Reads and loads exercise competency profiles from the specified exercise directory.

     *

     * @param exercisePath Path to the exercise directory

     * @return List of ExerciseCompetencyProfile instances loaded from the manifest
     */
    public static List<ExerciseCompetencyProfile> readExerciseCompetencyProfiles(Path exercisePath) {
        return readExerciseCompetencyProfiles(exercisePath, EXERCISE_COMPETENCY_MANIFEST_FILE_NAME);
    }