debug

include/condorcet/src/Timer/Chrono.php

@@ -0,0 +1,66 @@
+<?php
+/*
+    Condorcet PHP - Election manager and results calculator.
+    Designed for the Condorcet method. Integrating a large number of algorithms extending Condorcet. Expandable for all types of voting systems.
+
+    By Julien Boudry and contributors - MIT LICENSE (Please read LICENSE.txt)
+    https://github.com/julien-boudry/Condorcet
+*/
+
+declare(strict_types=1);
+
+namespace CondorcetPHP\Condorcet\Timer;
+
+use CondorcetPHP\Condorcet\CondorcetVersion;
+
+class Chrono
+{
+    use CondorcetVersion;
+
+    protected Manager $manager;
+    protected float $start;
+    protected ?string $role = null;
+
+    public function __construct(Manager $timer, ?string $role = null)
+    {
+        $this->manager = $timer;
+        $this->setRole($role);
+        $this->resetStart();
+        $this->managerStartDeclare();
+    }
+
+    public function __destruct()
+    {
+        $this->manager->addTime($this);
+    }
+
+    public function getStart(): float
+    {
+        return $this->start;
+    }
+
+    public function getTimerManager(): Manager
+    {
+        return $this->manager;
+    }
+
+    protected function resetStart(): void
+    {
+        $this->start = microtime(true);
+    }
+
+    public function getRole(): ?string
+    {
+        return $this->role;
+    }
+
+    public function setRole(?string $role): void
+    {
+        $this->role = $role;
+    }
+
+    protected function managerStartDeclare(): void
+    {
+        $this->manager->startDeclare($this);
+    }
+}

include/condorcet/src/Timer/Manager.php

@@ -0,0 +1,85 @@
+<?php
+/*
+    Condorcet PHP - Election manager and results calculator.
+    Designed for the Condorcet method. Integrating a large number of algorithms extending Condorcet. Expandable for all types of voting systems.
+
+    By Julien Boudry and contributors - MIT LICENSE (Please read LICENSE.txt)
+    https://github.com/julien-boudry/Condorcet
+*/
+
+declare(strict_types=1);
+
+namespace CondorcetPHP\Condorcet\Timer;
+
+use CondorcetPHP\Condorcet\Dev\CondorcetDocumentationGenerator\CondorcetDocAttributes\{Description, FunctionReturn, PublicAPI, Related, Throws};
+use CondorcetPHP\Condorcet\CondorcetVersion;
+use CondorcetPHP\Condorcet\Throwable\TimerException;
+
+class Manager
+{
+    use CondorcetVersion;
+
+    protected float $globalTimer = 0.0;
+    protected ?float $lastTimer = null;
+    protected ?float $lastChronoTimestamp = null;
+    protected ?float $startDeclare = null;
+    protected array $history = [];
+
+    #[Throws(TimerException::class)]
+    public function addTime(Chrono $chrono): void
+    {
+        if ($chrono->getTimerManager() === $this) {
+            if ($this->lastChronoTimestamp === null && $chrono->getStart() !== $this->startDeclare) {
+                return;
+            }
+
+            $m = microtime(true);
+
+            if ($this->lastChronoTimestamp > $chrono->getStart()) {
+                $c = $this->lastChronoTimestamp;
+            } else {
+                $c = $chrono->getStart();
+                $this->history[] = ['role' => $chrono->getRole(),
+                    'process_in' => ($m - $c),
+                    'timer_start' => $c,
+                    'timer_end' => $m,
+                ];
+            }
+
+            $this->globalTimer += ($m - $c);
+
+            $this->lastTimer = ($m - $chrono->getStart());
+            $this->lastChronoTimestamp = $m;
+        } else {
+            throw new TimerException;
+        }
+    }
+
+    public function getGlobalTimer(): float
+    {
+        return $this->globalTimer;
+    }
+
+    public function getLastTimer(): float
+    {
+        return $this->lastTimer;
+    }
+
+    #[PublicAPI]
+    #[Description('Return benchmarked actions history.')]
+    #[FunctionReturn('An explicit array with history.')]
+    #[Related('Election::getTimerManager')]
+    public function getHistory(): array
+    {
+        return $this->history;
+    }
+
+    public function startDeclare(Chrono $chrono): static
+    {
+        if ($this->startDeclare === null) {
+            $this->startDeclare = $chrono->getStart();
+        }
+
+        return $this;
+    }
+}