StatusOfAttempt.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\Test\Results\Data;
 
use ILIAS\Language\Language;
 
enum StatusOfAttempt: string
{
    case NOT_YET_STARTED = 'not_started';
    case RUNNING = 'running';
    case FINISHED_BY_UNKNOWN = 'finished_by_unknown';
    case FINISHED_BY_ADMINISTRATOR = 'finished_by_administrator';
    case FINISHED_BY_DURATION = 'finished_by_duration';
    case FINISHED_BY_PARTICIPANT = 'finished_by_participant';
    case FINISHED_BY_CRONJOB = 'finished_by_cronjob';
 
    public function isFinished(): bool
    {
        return in_array($this, [
            self::FINISHED_BY_UNKNOWN,
            self::FINISHED_BY_ADMINISTRATOR,
            self::FINISHED_BY_CRONJOB,
            self::FINISHED_BY_DURATION,
            self::FINISHED_BY_PARTICIPANT,
        ]);
    }
 
    public static function build(int $current_attempt, ?int $last_finished_attempt, ?string $finalized_by): StatusOfAttempt
    {
        if ($last_finished_attempt === null || $current_attempt > $last_finished_attempt) {
            return StatusOfAttempt::RUNNING;
        }
 
        if ($finalized_by === null || $finalized_by === '') {
            return StatusOfAttempt::FINISHED_BY_UNKNOWN;
        }
 
        return StatusOfAttempt::tryFrom($finalized_by);
    }
 
    public function getTranslation(Language $lng): string
    {
        return $lng->txt($this->value);
    }
}