PhpSchool\Terminal\InputCharacter

Complexity

Total Complexity

11

Size/Duplication

Total Lines	115
Duplicated Lines	0 %

Importance

Changes

0

9 Methods

Rating	Name	Duplication	Size	Complexity
A	getControl()	0	7	2
A	__construct()	0	3	1
A	get()	0	3	1
A	isNotControl()	0	3	1
A	isControl()	0	3	1
A	__toString()	0	3	1
A	getControls()	0	3	1
A	fromControlName()	0	7	2
A	controlExists()	0	3	1

<?php

namespace PhpSchool\Terminal;

use function in_array;

/**
 * @author Aydin Hassan <aydin@hotmail.co.uk>
 */
class InputCharacter
{
    /**
     * @var string
     */
    private $data;

    public const UP = 'UP';
    public const DOWN = 'DOWN';
    public const RIGHT = 'RIGHT';
    public const LEFT = 'LEFT';
    public const CTRLA = 'CTRLA';
    public const CTRLB = 'CTRLB';
    public const CTRLE = 'CTRLE';
    public const CTRLF = 'CTRLF';
    public const BACKSPACE = 'BACKSPACE';
    public const CTRLW = 'CTRLW';
    public const ENTER = 'ENTER';
    public const TAB = 'TAB';

    private static $controls = [
        "\033[A" => self::UP,
        "\033[B" => self::DOWN,
        "\033[C" => self::RIGHT,
        "\033[D" => self::LEFT,
        "\001"   => self::CTRLA,
        "\002"   => self::CTRLB,
        "\005"   => self::CTRLE,
        "\006"   => self::CTRLF,
        "\010"   => self::BACKSPACE,
        "\177"   => self::BACKSPACE,
        "\027"   => self::CTRLW,
        "\n"     => self::ENTER,
        "\t"     => self::TAB,
    ];

    public function __construct(string $data)
    {
        $this->data = $data;
    }

    /**
     * Is this character a control sequence?
     */
    public function isControl() : bool
    {
        return isset(static::$controls[$this->data]);

Since $controls is declared private, accessing it with static will lead to errors in possible sub-classes; you can either use self, or increase the visibility of $controls to at least protected.

    }

    /**
     * Is this character a normal character?
     */
    public function isNotControl() : bool
    {
        return ! $this->isControl();
    }

    /**
     * Get the raw character or control sequence
     */
    public function get() : string
    {
        return $this->data;
    }

    /**
     * Get the actual control name that this sequence represents.
     * One of the class constants. Eg. self::UP.
     *
     * Throws an exception if the character is not actually a control sequence
     */
    public function getControl() : string
    {
        if (!isset(static::$controls[$this->data])) {

Since $controls is declared private, accessing it with static will lead to errors in possible sub-classes; you can either use self, or increase the visibility of $controls to at least protected.

            throw new \RuntimeException(sprintf('Character "%s" is not a control', $this->data));
        }

        return static::$controls[$this->data];
    }

    /**
     * Get the raw character or control sequence
     */
    public function __toString() : string
    {
        return $this->get();
    }

    /**
     * Does the given control name exist? eg self::UP.
     */
    public static function controlExists(string $controlName) : bool
    {
        return in_array($controlName, static::$controls, true);

Since $controls is declared private, accessing it with static will lead to errors in possible sub-classes; you can either use self, or increase the visibility of $controls to at least protected.

    }

    /**
     * Get all of the available control names
     */
    public static function getControls() : array
    {
        return array_values(array_unique(static::$controls));

Since $controls is declared private, accessing it with static will lead to errors in possible sub-classes; you can either use self, or increase the visibility of $controls to at least protected.

    }

    /**
     * Create a instance from a given control name. Throws an exception if the
     * control name does not exist.
     */
    public static function fromControlName(string $controlName) : self
    {
        if (!static::controlExists($controlName)) {
            throw new \InvalidArgumentException(sprintf('Control "%s" does not exist', $controlName));
        }

        return new static(array_search($controlName, static::$controls, true));

It seems like array_search($controlName, static::controls, true) can also be of type false; however, parameter $data of PhpSchool\Terminal\InputCharacter::__construct() does only seem to accept string, maybe add an additional type check?

Since $controls is declared private, accessing it with static will lead to errors in possible sub-classes; you can either use self, or increase the visibility of $controls to at least protected.

    }
}