StatusOfAttempt.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

namespace ILIAS\Test\Results\Data;

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);
    }
}