AlecRabbit\Tools\HRTimer

Complexity

Total Complexity

10

Size/Duplication

Total Lines	62
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes

0

5 Methods

Rating	Name	Duplication	Size	Complexity
A	current()	0	4	1
A	assertStop()	0	4	2
A	checkEnvironment()	0	15	4
A	assertStartAndStop()	0	4	1
A	assertStart()	0	4	2

<?php declare(strict_types=1);

namespace AlecRabbit\Tools;

use function AlecRabbit\typeOf;
use const AlecRabbit\Helpers\Constants\INT_SIZE_64BIT;

class HRTimer extends AbstractTimer
{
    public const VALUE_COEFFICIENT = HRTIMER_VALUE_COEFFICIENT;

    /** @var bool */
    public static $ignoreVersionRestrictions = false;

    /**
     * @return int
     */
    public function current(): int
    {
        return
            (int)hrtime(true);
    }

    protected function checkEnvironment(): void
    {
        // @codeCoverageIgnoreStart
        if (PHP_VERSION_ID < 70300 && false === static::$ignoreVersionRestrictions) {
            // `HRTimer::class` uses `hrtime()` function of PHP ^7.3.
            // There is almost no sense in using polyfill function.
            // If you're REALLY need to use HRTimer set `$ignoreVersionRestrictions` to true.
            // Otherwise use `Timer::class` instance instead.
            throw new \RuntimeException('[' . static::class . '] Your php version is below 7.3.0.');
        }
        if (PHP_INT_SIZE < INT_SIZE_64BIT) {
            // `HRTimer::class` is designed and tested in 64bit environment
            // So it can be used in 64bit environments only
            // Maybe with some minor modification it can run on 32bit installations too
            throw new \RuntimeException(' You\'re using 32bit php installation.');
        }
        // @codeCoverageIgnoreEnd
    }

    /**
     * @param int $start
     * @param int $stop
     */
    protected function assertStartAndStop($start, $stop): void
    {
        $this->assertStart($start);
        $this->assertStop($stop);
    }

    /**
     * @param $start
     */
    protected function assertStart($start): void
    {
        if (!\is_int($start)) {
            throw new \RuntimeException('Start value is NOT ok. [' . typeOf($start) . ']');
        }
    }

    /**
     * @param $stop
     */
    protected function assertStop($stop): void
    {
        if (!is_int($stop)) {
            throw new \RuntimeException('Stop value is NOT ok. [' . typeOf($stop) . ']');
        }
    }

}