A simulation of a toy robot moving on a square tabletop, of dimensions 5 units x 5 units. See Specification below for details.
All code is written in Ruby, with some help from ActiveModel::Validations for model validation checks, and Thor for the command-line interface.
Install gem dependencies with Bundle:
$ bundle install
Input commands manually on command line:
$ toy_robot
Run commands from a file:
$ toy_robot -f [filename]
To enable functionality in the Extensions, pass in the -e flag:
Input commands manually on command line in extended mode:
$ toy_robot -e
Run commands from a file in extended mode:
$ toy_robot -e -f [filename]
Code quality is attempted by using RSpec for testing, SimpleCov for code test coverage, Reek to fix code smells, as well as Code Climate and Coveralls for quality metrics.
Run tests:
$ rspec spec/
Check test coverage (after running rspec):
$ open coverage/index.html
Check code smells:
$ rake reek
- The application is a simulation of a toy robot moving on a square tabletop, of dimensions 5 units x 5 units.
- There are no other obstructions on the table surface.
- The robot is free to roam around the surface of the table, but must be prevented from falling to destruction. Any movement that would result in the robot falling from the table must be prevented, however further valid movement commands must still be allowed.
Create an application that can read in commands of the following form
PLACE X,Y,F
MOVE
LEFT
RIGHT
REPORT
PLACEwill put the toy robot on the table in positionX,Yand facingNORTH,SOUTH,EASTorWEST.- The origin (
0,0) can be considered to be theSOUTH WESTmost corner. - The first valid command to the robot is a
PLACEcommand, after that, any sequence of commands may be issued, in any order, including anotherPLACEcommand. The application should discard all commands in the sequence until a validPLACEcommand has been executed MOVEwill move the toy robot one unit forward in the direction it is currently facing.LEFTandRIGHTwill rotate the robot 90 degrees in the specified direction without changing the position of the robot.REPORTwill announce theX,YandFof the robot. This can be in any form, but standard output is sufficient.
- A robot that is not on the table can choose to ignore the
MOVE,LEFT,RIGHTandREPORTcommands. - Input can be from a file, or from standard input, as the developer chooses.
- Provide test data to exercise the application.
The toy robot must not fall off the table during movement. This also includes the initial placement of the toy robot. Any move that would cause the robot to fall must be ignored.
Example Input and Output:
a)
PLACE 0,0,NORTH
MOVE
REPORT
Output: 0,1,NORTH
b)
PLACE 0,0,NORTH
LEFT
REPORT
Output: 0,0,WEST
c)
PLACE 1,2,EAST
MOVE
MOVE
LEFT
MOVE
REPORT
Output: 3,3,NORTH
The Ruby source files, the test data and any test code. It is not required to provide any graphical output showing the movement of the toy robot.
Terminals that are ANSI-color compatible will get the benefit of fun colors in the output.
The HELP command prints out the usage message to the console.
Multiple robots can be placed on the same board, and will move around without bumping into each other.
A PLACE command can be made as per the standard app (PLACE 2,2,NORTH), and the robot will automatically be given the sequential name of "R1", "R2" etc depending on the number of robots on the board. Otherwise, you can name a robot by appending it to the command eg: PLACE 2,2,NORTH Kryten.
If there is only one robot on the board, it can be controlled by commands with or without its name. However, on a board with multiple robots, a robot's name must be specified in order to determine the target of the command eg: MOVE Kryten.
The SPIN [ROBOT_NAME] command 'spins' a robot 180°, effectively performing two turns at once, to face in the opposite direction.
The BLOCK [ROBOT_NAME] command puts a block on the square in front of the robot. Robots cannot pass through any blocks, either their own, or those placed by other robots. Any attempts to move through a block, be placed on a block, or place a block on a block are ignored.
The MAP [ROBOT_NAME] [BOARD] command shows a visual map of the board from three perspectives:
-
MAPby itself shows the full map of the board, including the position and direction of all robots on the board (Λ > V <) and all the blocks they have placed (█). For example:0 1 2 3 4 4 [ ] [ ] [ ] [█] [ ] 3 [ ] [ ] [█] [V] [█] 2 [ ] [█] [ ] [█] [ ] 1 [█] [Λ] [█] [ ] [ ] 0 [ ] [█] [ ] [ ] [ ] Robots on the Board: Name: Kryten Kryten's Position: 1,1,NORTH Kryten's Blocks at Positions: [0, 1], [1, 0], [1, 2], [2, 1] ------- Name: Marvin Marvin's Position: 3,3,SOUTH Marvin's Blocks at Positions: [2, 3], [3, 2], [3, 4], [4, 3] ------- -
MAP ROBOT_NAMEshows the map from the robot's perspective. The robot knows only about the position and direction of itself, as well as the locations of all blocks it has placed, but still cannot move to spaces occupied by another robot or its blocks. For the example above:> MAP Kryten 0 1 2 3 4 4 [ ] [ ] [ ] [ ] [ ] 3 [ ] [ ] [ ] [ ] [ ] 2 [ ] [█] [ ] [ ] [ ] 1 [█] [Λ] [█] [ ] [ ] 0 [ ] [█] [ ] [ ] [ ] Kryten's Position: 1,1,NORTH Kryten's Blocks at Positions: [0, 1], [1, 0], [1, 2], [2, 1] > MAP Marvin 0 1 2 3 4 4 [ ] [ ] [ ] [█] [ ] 3 [ ] [ ] [█] [V] [█] 2 [ ] [ ] [ ] [█] [ ] 1 [ ] [ ] [ ] [ ] [ ] 0 [ ] [ ] [ ] [ ] [ ] Marvin's Position: 3,3,SOUTH Marvin's Blocks at Positions: [2, 3], [3, 2], [3, 4], [4, 3] -
MAP BOARDshows the map from the board's perspective. The board knows about the spaces on the board that are occupied by an object (×), without any specifics of the object. For the example above:0 1 2 3 4 4 [ ] [ ] [ ] [×] [ ] 3 [ ] [ ] [×] [×] [×] 2 [ ] [×] [ ] [×] [ ] 1 [×] [×] [×] [ ] [ ] 0 [ ] [×] [ ] [ ] [ ] Occupied Positions: [0, 1], [1, 0], [1, 1], [1, 2], [2, 1], [2, 3], [3, 2], [3, 3], [3, 4], [4, 3]
Copyright (c) 2013 Paul Fioravanti
See MIT LICENSE for details.
