Reith\ToyRobot\Domain\Robot\Robot

Complexity

Total Complexity

15

Size/Duplication

Total Lines	185
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	2

Test Coverage

Coverage

76.27%

Importance

Changes

0

13 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	9	1
A	create()	0	14	2
A	move()	0	11	1
A	left()	0	6	1
A	right()	0	6	1
A	moveNorthward()	0	11	1
A	moveEastward()	0	11	1
A	moveSouthward()	0	11	1
A	moveWestward()	0	11	1
A	getPosition()	0	4	1
A	getReportAsString()	0	6	1
A	getFacingDirectionAsString()	0	4	1
A	validateCanMove()	0	8	2

<?php

/**
 * (c) 2018 Douglas Reith.
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */
declare(strict_types=1);

namespace Reith\ToyRobot\Domain\Robot;

use MathPHP\LinearAlgebra\Vector;
use Assert\Assert;
use Assert\Assertion;
use Reith\ToyRobot\Domain\Space\SpaceInterface;
use Reith\ToyRobot\Domain\Robot\Exception\NotPlacedInSpaceException;

class Robot
{
    /**
     * Purchased by Rupert, then tanked :).
     *
     * @var SpaceInterface
     */
    private $mySpace;

    private $position;

    private $facingDirection;

    private function __construct(
        SpaceInterface $space,
        Vector $position,
        Direction $facingDirection
    ) {
        $this->mySpace = $space;
        $this->position = $position;
        $this->facingDirection = $facingDirection;
    }

    /**
     * @param SpaceInterface $space
     * @param Vector         $position
     * @param string|null    $facingDirection
     *
     * @return Robot
     *
     * @throws Assert\AssertionFailedException
     */
    public static function create(
        SpaceInterface $space,
        Vector $position,
        ?string $facingDirection = 'E'
    ): Robot {

        $facingDirection = $facingDirection ?: 'E';

        return new static(
            $space,
            $position,
            new Direction($facingDirection)
        );
    }

    /**
     * @return Robot
     */
    public function move(): Robot
    {
        $this->validateCanMove();

        $this->position = $this->mySpace->move(
            $this->position,
            $this->facingDirection->getDirectionAsVector()
        );

        return $this;
    }

    /**
     * @return Robot
     */
    public function left(): Robot
    {
        $this->facingDirection->rotateLeft();

        return $this;
    }

    /**
     * @return Robot
     */
    public function right(): Robot
    {
        $this->facingDirection->rotateRight();

        return $this;
    }

    /**
     * @return Robot
     */
    public function moveNorthward(): Robot
    {
        $this->validateCanMove();

        $this->position = $this->mySpace->move(
            $this->position,
            $this->facingDirection->northward()
        );

        return $this;
    }

    /**
     * @return Robot
     */
    public function moveEastward(): Robot
    {
        $this->validateCanMove();

        $this->position = $this->mySpace->move(
            $this->position,
            $this->facingDirection->eastward()
        );

        return $this;
    }

    /**
     * @return Robot
     */
    public function moveSouthward(): Robot
    {
        $this->validateCanMove();

        $this->position = $this->mySpace->move(
            $this->position,
            $this->facingDirection->southward()
        );

        return $this;
    }

    /**
     * @return Robot
     */
    public function moveWestward(): Robot
    {
        $this->validateCanMove();

        $this->position = $this->mySpace->move(
            $this->position,
            $this->facingDirection->westward()
        );

        return $this;
    }

    /**
     * @return Vector
     */
    public function getPosition(): Vector
    {
        return $this->position;
    }

    /**
     * @return string In the form 'X,Y,F'
     */
    public function getReportAsString(): string
    {
        $positionAsString = implode(',', $this->position->getVector());

        return $positionAsString . ',' . $this->getFacingDirectionAsString();
    }

    /**
     * @return string
     */
    private function getFacingDirectionAsString(): string
    {
        return $this->facingDirection->getDirectionAsString();
    }

    /**
     * validateCanMove.
     *
     * The robot requires a space during construction, however,
     * this is extra precautionary in case the space is removed
     *
     * @throws NotPlacedInSpaceException
     */
    private function validateCanMove(): void
    {
        if (!$this->mySpace) {
            throw new NotPlacedInSpaceException(
                'I cannot move until placed in space'
            );
        }
    }
}