A DDD PHP Solution To The Mars Rover Problem

How To Test

Application Version PHP 7.1

composer install

./bin/phpspec run for tests

php app.php for executing application

Directory Structure

spec
└── App
    ├── ActionSpec.php
    ├── Entity
    │   └── RoverSpec.php
    ├── IO
    │   └── InputSpec.php
    └── Model
        ├── DirectionSpec.php
        ├── MoveSpec.php
        ├── PositionSpec.php
        └── SpinSpec.php
src
├── Action.php
├── Contract
│   ├── PlateauInterface.php
│   ├── PositionableInterface.php  -- If any object has Position means capable of positioning.
│   └── RoverInterface.php
├── Entity
│   ├── Plateau.php     -- represents the Plateau Entity
│   └── Rover.php       -- represents the Rover Entity
├── IO
│   └── Input.php       -- Normalizes input for application.
└── Model
    ├── Coordinate.php  -- Value object, holds coordinate value.
    ├── Direction.php   -- Value object, holds direction and able to conversion between poles and axises.
    ├── Move.php        -- Value object, represents a unit of movement.
    ├── Position.php    -- Value object, consists of two Coordinate object represents as (X, Y).
    └── Spin.php        -- Value object, represents of 90 degree turn to left or right.

9 directories, 19 files

Specification

A squad of robotic rovers is to be landed by NASA on a plateau on Mars.

This plateau, which is curiously rectangular, must be navigated by the rovers so that their on board cameras can get a complete view of the surrounding terrain to send back to Earth.

A rover's position is represented by a combination of an x and y co-ordinates and a letter representing one of the four cardinal compass points. The plateau is divided up into a grid to simplify navigation. An example position might be 0, 0, N, which means the rover is in the bottom left corner and facing North.

In order to control a rover, NASA sends a simple string of letters. The possible letters are L, R and M. L and R makes the rover spin 90 degrees left or right respectively, without moving from its current spot.

M means move forward one grid point, and maintain the same heading. Assume that the square directly North from (x, y) is (x, y+1).

Input:

The first line of input is the upper-right coordinates of the plateau, the lower-left coordinates are assumed to be 0,0.

The rest of the input is information pertaining to the rovers that have been deployed. Each rover has two lines of input. The first line gives the rover's position, and the second line is a series of instructions telling the rover how to explore the plateau.

The position is made up of two integers and a letter separated by spaces, corresponding to the x and y co-ordinates and the rover's orientation.

Each rover will be finished sequentially, which means that the second rover won't start to move until the first one has finished moving.

Output:

The output for each rover should be its final co-ordinates and heading.

Example

Test input:

5 5

1 2 N

LMLMLMLMM

3 3 E

MMRMMRMRRM

Test output:

1 3 N

5 1 E