robert2d-robot 0.1.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NWJhMzE5NDQ2Mjk2ZDI2MzFhOTQ5NzRjYmMwMWVkOWRjODIzOWU1Nw==
+  data.tar.gz: !binary |-
+    MDY3MzFmYTQ1YTVlYzZiYTgzYTdkMWQ4ODljOTYyNGRjYmY5N2M4ZQ==
+SHA512:
+  metadata.gz: !binary |-
+    YTMwNTgyZDlmYjJkNTMwNDdkYjhjNjYyNjEzMDllZDUxNmFiNzA0ODI0NmVh
+    OGFjMjIxNDg4YzI3Mzc2MDU1NWU3NzRhNDQxMmRmZTEzYTc1OWU5YzkxYzVi
+    ZjMxZjhlMTBjMjIzYjE5YjM0NzMxMmZjNmE2ODFmZDk5YTJhYmI=
+  data.tar.gz: !binary |-
+    YWQ4ZDcwZWUzZGU2ZjYwMjU0YThiNTk1MWUyNDgzOTVhZmQzYmRlYzZlYzE0
+    MWIwMjYzNGVhYTlkY2E5ZDY4NzlhN2FlNTkwYzM5MzY2ZmQ5ODM1NzE2NTI2
+    Mzc3MzFjNDVjMzY1YjMyNzBhNDg4NzY1MTg3OTdjYzUwNGU5MjE=

data/.gitignore

@@ -0,0 +1 @@
+coverage

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,7 @@
+AllCops:
+  Exclude:
+    - '**/Guardfile'
+    - 'vendor/**/*'
+
+Style/Documentation:
+  Enabled: false

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.1.2

data/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+rvm:
+- 2.0
+- 2.1
+- 2.2
+deploy:
+  provider: rubygems
+  api_key:
+    secure: GBnhPCF3UiTHXVjmVl/U4LOtRYKBg3iluB2YYWZuBt8LPRSdi41VI6TEVhJ9S7XpJQhmt9Nq3PGr2b74fqmBGAmSAaCKfnHHLrc5SqKdzc0zd9h5VORHGmUJWp/w1Qq/96fnpMfbNqlBIdAs1JaXVuwV0H8KAeTRASzLNjfahoeZR1uWzKLsvgHmJ17qAC/v3mZBfaYY6nnf1GBOs9N6WebaR/MC8SvTxmiLldl/QVuMUdiSJURlJ0dJnHMLq9P1LB0t4ECNLmC7hNKfnTJ3+CPq5Ow7go3Yt1/46liaa0edkXja05VHaBijEQColQqNkjfxL/Xb/n/QnHGIcZ4Au961Nw57/CZLmJ/U6bRXjamtkodKI8eYAS/3bAdVHr/266ZAHXj5jGqzjpIPqDueuOAR+b1iNlyCw5kKEcm2plPLIxslUmrZIPH4VHcPHvXcal46AX6BH399Mv2RZ9iyxyTZlrPQErl+urN8Gu+Zp2kmjtaA5QrUwaS50uj8eRL/tSz7mtrQn/2lw6JPcB1tzla5LpslDD39OZFa5Ejs8vNzbrYpSda5IY1bBjpqZ+O/3T1s54bqVNxWTLiGLXwWnexLldc6L5u+fgsUK0saQ8KlUQtSIVW+iVcVcWBhgkFN522S8EofF79AX2MtVJkw7679YywuLAplPbLyreunIsk=
+  gem: robert2d-robot
+  gemspec: robert2d-robot.gemspec
+  on:
+    tags: true
+    repo: robert2d/robot

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,99 @@
+PATH
+  remote: .
+  specs:
+    robert2d-robot (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.0.0)
+    astrolabe (1.3.1)
+      parser (~> 2.2)
+    codeclimate-test-reporter (0.2.0)
+      simplecov (>= 0.7.1, < 1.0.0)
+    coderay (1.1.0)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    ffi (1.9.10)
+    formatador (0.2.5)
+    guard (2.12.8)
+      formatador (>= 0.2.4)
+      listen (>= 2.7, <= 4.0)
+      lumberjack (~> 1.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.9.12)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-compat (1.2.1)
+    guard-rspec (4.6.2)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
+    json (1.8.3)
+    listen (3.0.2)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9)
+    lumberjack (1.0.9)
+    method_source (0.8.2)
+    nenv (0.2.0)
+    notiffany (0.0.6)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    parser (2.2.2.6)
+      ast (>= 1.1, < 3.0)
+    powerpack (0.1.1)
+    pry (0.10.1)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    rainbow (2.0.0)
+    rake (10.4.2)
+    rb-fsevent (0.9.5)
+    rb-inotify (0.9.5)
+      ffi (>= 0.5.0)
+    rspec (3.3.0)
+      rspec-core (~> 3.3.0)
+      rspec-expectations (~> 3.3.0)
+      rspec-mocks (~> 3.3.0)
+    rspec-core (3.3.2)
+      rspec-support (~> 3.3.0)
+    rspec-expectations (3.3.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-mocks (3.3.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-support (3.3.0)
+    rubocop (0.32.1)
+      astrolabe (~> 1.3)
+      parser (>= 2.2.2.5, < 3.0)
+      powerpack (~> 0.1)
+      rainbow (>= 1.99.1, < 3.0)
+      ruby-progressbar (~> 1.4)
+    ruby-progressbar (1.7.5)
+    shellany (0.0.1)
+    simplecov (0.10.0)
+      docile (~> 1.1.0)
+      json (~> 1.8)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+    slop (3.6.0)
+    thor (0.19.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.10.5)
+  codeclimate-test-reporter (~> 0.2.0)
+  guard (~> 2.12.8)
+  guard-rspec (~> 4.6.2)
+  rake (~> 10.4.2)
+  robert2d-robot!
+  rspec (~> 3.3.0)
+  rubocop (~> 0.32.1)
+  simplecov (~> 0.10.0)
+
+BUNDLED WITH
+   1.10.5

data/Guardfile

@@ -0,0 +1,13 @@
+# To exclude automatic running of tests, use the group filter e.g.
+# `be guard -g no-tests`
+# The above will only run global definitions and the group 'no-tests',
+# which doesn't exist. This is to support starting a guard process in one
+# window and then manually running `bundle exec rspec spec/<spec>` in
+# another.
+group :tests do
+  guard :rspec, cmd: 'rspec --color' do
+    watch(%r{^spec/.+_spec\.rb$})
+    watch('spec/spec_helper.rb')                        { 'spec/' }
+    watch(%r{^lib/(.+)\.rb$})                           { |m| "spec/#{m[1]}_spec.rb" }
+  end
+end

data/README.md

@@ -0,0 +1,33 @@
+# TOY ROBOT TEST
+[![Build Status](https://travis-ci.org/robert2d/robot.svg?branch=master)](https://travis-ci.org/robert2d/robot)
+[![Test Coverage](https://codeclimate.com/github/robert2d/robot/badges/coverage.svg)](https://codeclimate.com/github/robert2d/robot/coverage)
+[![Code Climate](https://codeclimate.com/github/robert2d/robot/badges/gpa.svg)](https://codeclimate.com/github/robert2d/robot)
+
+See instructions.txt for the specification. If run on OSX you can turn your speakers on to get more feedback from the robot. There is also a visual component to the REPORT command, which even though it wasn't required I left in anyway.
+
+## INSTALLING
+
+    git clone git://github.com/robert2d/rea-robot.git
+    cd rea-robot
+    gem install bundler
+    bundle install
+
+## USE
+
+### Interactive:
+
+    $ ./robot.rb
+    PLACE 1,2,EAST
+    MOVE
+    MOVE
+    LEFT
+    MOVE
+    REPORT
+
+### Passing a file:
+
+    $ ./robot.rb test_data.txt
+
+## TESTS
+
+    $ rspec

data/Rakefile

@@ -0,0 +1,15 @@
+require 'bundler'
+require 'rubocop/rake_task'
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+RuboCop::RakeTask.new do |t|
+  t.formatters = %w(progress json)
+  t.options = %w(--out coverage/rubocop.json)
+end
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+task default: [:spec, :rubocop]

data/bin/robot

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+require 'robot'
+
+# rubocop:disable Lint/AssignmentInCondition
+while command = gets
+  Robot::CommandCentre.instance.parse_and_execute(command)
+end
+# rubocop:enable Lint/AssignmentInCondition

data/instructions.txt

@@ -0,0 +1,61 @@
+-----------
+Toy Robot Simulator
+
+Description:
+. 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
+
+. PLACE will put the toy robot on the table in position X,Y and facing NORTH, SOUTH, EAST or WEST.
+. The origin (0,0) can be considered to be the SOUTH WEST most corner.
+. The first valid command to the robot is a PLACE command, after that, any sequence of commands may be issued, in any order, including another PLACE command. The application should discard all commands in the sequence until a valid PLACE command has been executed.
+. MOVE will move the toy robot one unit forward in the direction it is currently facing.
+. LEFT and RIGHT will rotate the robot 90 degrees in the specified direction without changing the position of the robot.
+. REPORT will announce the X,Y and F of the robot. This can be in any form, but standard output is sufficient.
+
+. A robot that is not on the table can choose the ignore the MOVE, LEFT, RIGHT and REPORT commands.
+. Input can be from a file, or from standard input, as the developer chooses.
+. Provide test data to exercise the application.
+
+
+Constraints:
+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
+
+
+Deliverables:
+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.
+-------

data/lib/robot.rb

@@ -0,0 +1,95 @@
+require 'singleton'
+require 'robot/table'
+require 'robot/matrix'
+require 'robot/command_centre'
+
+class Robot
+  include Singleton
+
+  MOVEMENT_DIRECTIONS = {
+    north: { x: 0, y: 1 },
+    east: { x: 1, y: 0 },
+    south: { x: 0, y: -1 },
+    west: { x: -1, y: 0 }
+  }
+
+  attr_reader :table, :direction
+
+  def initialize
+    @table = Table.instance
+  end
+
+  ##
+  # trys to move in current direction one place
+  def move
+    postition = new_position
+    return if table.place(postition[:x], postition[:y])
+    puts 'Cannot move off the table'
+    CommandCentre.instance.say('Does not compute, I will fall to my death')
+  end
+
+  ##
+  # rotates compass faces and uses current face as index
+  # to retrieve new direction
+  def right
+    rotate(:right)
+  end
+
+  def left
+    rotate(:left)
+  end
+
+  ##
+  # outputs the x,y,position of the robot also includes a position matrix
+  def report
+    puts to_s
+    puts Matrix.new(table.position, direction).to_s
+    say_position
+  end
+
+  def to_s
+    "#{table.position[:x]}, #{table.position[:y]} #{direction.upcase}"
+  end
+
+  def place(args)
+    return unless args
+    x, y, face = args.split(',')
+    return unless x && y && face
+    return unless table.place(x, y)
+    self.direction = face.downcase.to_sym
+  end
+
+  private
+
+  def say_position
+    CommandCentre.instance.say("My position is currently #{table.position[:x]}/
+     by #{table.position[:y]} and facing #{direction}")
+  end
+
+  ##
+  # fetches new coordinates and adds them to existing coords
+  def new_position
+    table.position.merge(move_coordinates) { |_key, memo, value| memo + value }
+  end
+
+  def move_coordinates
+    MOVEMENT_DIRECTIONS[direction]
+  end
+
+  def direction=(face)
+    @direction = face if MOVEMENT_DIRECTIONS.keys.include?(face)
+  end
+
+  def rotate(direction)
+    index = direction == :left ? -1 : 1
+    self.direction = faces.rotate(index)[face_index]
+  end
+
+  def faces
+    MOVEMENT_DIRECTIONS.keys
+  end
+
+  def face_index
+    faces.index(direction)
+  end
+end

data/lib/robot/command_centre.rb

@@ -0,0 +1,46 @@
+require 'singleton'
+
+class Robot
+  class CommandCentre
+    include Singleton
+
+    COMMANDS = %w(PLACE MOVE LEFT RIGHT REPORT)
+
+    def parse_and_execute(command_string)
+      command = Command.new(command_string.strip.upcase)
+      return unless command.validate
+      command.execute
+    end
+
+    ##
+    # feature just for fun only for mac users
+    def say(message)
+      IO.popen(
+        "say -v Ralph '#{message}'"
+      ) if RbConfig::CONFIG['host_os'].match(/darwin|mac os/)
+    end
+
+    class Command
+      attr_reader :command, :args, :robot
+
+      def initialize(command_string)
+        @command, @args = command_string.split(' ')
+        @robot = Robot.instance
+      end
+
+      def execute
+        return robot.place(args) if place?
+        return robot.send(:"#{command.downcase}") if robot.table.placed?
+        CommandCentre.instance.say('Does not compute, You must place me first')
+      end
+
+      def place?
+        command == 'PLACE'
+      end
+
+      def validate
+        COMMANDS.include?(command)
+      end
+    end
+  end
+end

data/lib/robot/matrix.rb

@@ -0,0 +1,53 @@
+class Robot
+  class Matrix
+    attr_reader :position, :direction
+    attr_accessor :matrix
+
+    DIRECTION_ARROWS = {
+      north: '^',
+      east: '>',
+      south: 'v',
+      west: '<'
+    }
+
+    def initialize(position, direction)
+      @position = position
+      @direction = direction
+      @matrix = generate_matrix
+    end
+
+    ##
+    # puts an arrow pointing in the direction of the current x,y of the robot
+    # on a matrix and returns a string of the matrix
+    def to_s
+      set_current_position!
+      matrix.reverse.map { |row| row.join(' ') }.join("\n")
+    end
+
+    private
+
+    ##
+    # sets the current position x,y coords to a directional arrow
+    def set_current_position!
+      matrix[
+        position[:y]
+      ][
+        position[:x]
+      ] = DIRECTION_ARROWS[direction]
+    end
+
+    ##
+    # constructs a matrix of positions
+    # Output:
+    #  [
+    #   ["X", "X", "X", "X", "X"],
+    #   ["X", "X", "X", "X", "X"],
+    #   ["X", "X", "X", "X", "X"],
+    #   ["X", "X", "X", "X", "X"],
+    #   ["X", "X", "X", "X", "X"]
+    # ]
+    def generate_matrix
+      [].tap { |a| 25.times { a << 'X' } }.each_slice(5).to_a
+    end
+  end
+end

data/lib/robot/table.rb

@@ -0,0 +1,29 @@
+require 'singleton'
+
+class Robot
+  class Table
+    include Singleton
+
+    attr_accessor :position
+    attr_reader :width, :height
+
+    def initialize
+      @width = 4
+      @height = 4
+    end
+
+    def place(x, y)
+      position = { x: x.to_i, y: y.to_i }
+      self.position = position if valid_position?(position)
+    end
+
+    def placed?
+      !position.nil?
+    end
+
+    def valid_position?(position)
+      position[:x] <= width && position[:x] >= 0 && \
+        position[:y] <= height && position[:y] >= 0
+    end
+  end
+end

data/lib/robot/version.rb

@@ -0,0 +1,3 @@
+class Robot
+  VERSION = '0.1.0'
+end

data/robert2d-robot.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'robot/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'robert2d-robot'
+  spec.version       = Robot::VERSION
+  spec.authors       = ['Dave Robertson']
+  spec.email         = ['dave.andrew.robertson.nz@gmail.com']
+  spec.summary       = 'Toy Robot CLI'
+  spec.homepage      = ''
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(spec)/})
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~>1.10.5'
+  spec.add_development_dependency 'rake', '~>10.4.2'
+  spec.add_development_dependency 'rspec', '~>3.3.0'
+  spec.add_development_dependency 'guard', '~>2.12.8'
+  spec.add_development_dependency 'guard-rspec', '~>4.6.2'
+  spec.add_development_dependency 'simplecov', '~>0.10.0'
+  spec.add_development_dependency 'rubocop', '~>0.32.1'
+  spec.add_development_dependency 'codeclimate-test-reporter', '~>0.2.0'
+end

data/spec/lib/robot/command_centre_spec.rb

@@ -0,0 +1,90 @@
+describe Robot::CommandCentre do
+  let(:command) { Robot::CommandCentre::Command }
+  let(:commands) { Robot::CommandCentre::COMMANDS }
+
+  subject { Singleton.__init__(described_class).instance }
+
+  before do
+    allow(subject).to receive(:puts)
+  end
+
+  describe '#parse_and_execute' do
+    context 'invalid command' do
+      let(:command) { double('Command') }
+
+      it 'returns without executing' do
+        expect(described_class::Command).to receive(:new).and_return(command)
+        expect(command).to receive(:validate)
+        expect(command).not_to receive(:execute)
+        subject.parse_and_execute('test')
+      end
+    end
+
+    context 'valid command' do
+      it 'validates and executes command' do
+        expect_any_instance_of(command).to receive(:execute)
+        subject.parse_and_execute(commands.sample)
+      end
+    end
+  end
+
+  describe Robot::CommandCentre::Command do
+    describe '#new' do
+      subject { command }
+
+      it 'constucts valid Command' do
+        expect(subject.new('test')).to respond_to(:command, :args, :robot)
+      end
+    end
+
+    describe '#validate' do
+      context 'is invalid' do
+        subject { command.new('test') }
+
+        it 'returns false' do
+          expect(subject.validate).not_to be
+        end
+      end
+
+      context 'is valid' do
+        subject { command.new(commands.sample) }
+
+        it 'returns false' do
+          expect(subject.validate).to be
+        end
+      end
+    end
+
+    describe '#execute' do
+      context 'with PLACE command' do
+        subject { command.new('PLACE 1,2,north') }
+
+        it 'delegates to robot passing args' do
+          expect(subject.robot).to receive(:place).with('1,2,north')
+          subject.execute
+        end
+      end
+
+      context 'with all other commands' do
+        subject { command.new('move') }
+
+        context 'when not placed' do
+          it 'delegates to robot' do
+            expect(Robot::CommandCentre.instance).to receive(:say)
+            expect(subject.robot.table).to receive(:placed?)
+            expect(subject.robot).not_to receive(:move)
+            subject.execute
+          end
+        end
+
+        context 'when placed' do
+          it 'delegates to robot' do
+            expect(subject.robot.table).to receive(:placed?).and_return(true)
+            expect(subject.robot).to receive(:move)
+            subject.execute
+          end
+        end
+      end
+    end
+  end
+end

data/spec/lib/robot/matrix_spec.rb

@@ -0,0 +1,18 @@
+describe Robot::Matrix do
+  subject { described_class.new({ x: 1, y: 1 }, :north) }
+
+  describe '#to_s' do
+    let(:expected) do
+      <<-TEXT.gsub(/^\s+/, '')
+        X X X X X
+        X X X X X
+        X X X X X
+        X ^ X X X
+        X X X X X
+      TEXT
+    end
+    it 'provides correct matrix for given inputs' do
+      expect(subject.to_s).to eq(expected.strip)
+    end
+  end
+end

data/spec/lib/robot/table_spec.rb

@@ -0,0 +1,54 @@
+describe Robot::Table do
+  # ensure fresh singleton for each spec
+  subject(:table) { Singleton.__init__(Robot::Table).instance }
+
+  describe '#place' do
+    context 'with valid position' do
+      it 'sets position on table' do
+        table.place('1', '2')
+        expect(table.placed?).to be
+        expect(table.position).to eq(x: 1, y: 2)
+      end
+    end
+    context 'with invalid position' do
+      it 'does not set position' do
+        table.place('-1', '7')
+        expect(table.placed?).not_to be
+        expect(table.position).to be_nil
+      end
+    end
+  end
+
+  describe '#placed?' do
+    it 'is false when not placed yet' do
+      expect(table.placed?).not_to be
+    end
+    it 'is true when has position' do
+      table.place('1', '2')
+      expect(table.placed?).to be
+    end
+  end
+
+  describe '#valid_position?' do
+    context 'with invalid position coordinates' do
+      let(:position) do
+        {
+          x: -1,
+          y: 10
+        }
+      end
+      it 'returns false' do
+        expect(table.valid_position?(position)).not_to be
+      end
+    end
+    context 'with all valid position coordinates' do
+      it 'returns true' do
+        5.times do |x|
+          5.times do |y|
+            expect(table.valid_position?(x: x, y: y)).to be
+          end
+        end
+      end
+    end
+  end
+end

data/spec/lib/robot_spec.rb

@@ -0,0 +1,151 @@
+describe Robot do
+  let(:position) do
+    {
+      x: 1,
+      y: 2
+    }
+  end
+
+  # ensure fresh singleton for each spec
+  subject(:robot) { Singleton.__init__(Robot).instance }
+
+  before do
+    allow(robot).to receive(:puts)
+  end
+
+  it 'has a version' do
+    expect(Robot::VERSION).to be
+  end
+
+  describe 'relationship to table' do
+    it 'should create relationship to table' do
+      expect(robot).to respond_to(:table)
+      expect(robot.table).to be_an_instance_of(Robot::Table)
+    end
+  end
+
+  describe '#move' do
+    context 'with valid placement on table' do
+      it 'returns valid placement' do
+        expect(robot).to receive(:new_position).and_return(position)
+        expect(robot.table).to receive(:place).and_call_original
+        expect(Robot::CommandCentre.instance).not_to receive(:say)
+        robot.move
+      end
+    end
+
+    context 'invalid placement on table' do
+      it 'alerts user of failed move' do
+        expect(robot).to receive(:new_position).and_return(position)
+        expect(robot.table).to receive(:place)
+        expect(Robot::CommandCentre.instance).to receive(:say)
+        robot.move
+      end
+    end
+  end
+
+  describe '#new_position' do
+    it 'fetches coordinates for move' do
+      expect(robot.table).to receive(:position).and_return(position)
+      expect(robot).to receive(:move_coordinates).and_return(position)
+      expect(robot.send(:new_position)).to eq(x: 2, y: 4)
+    end
+  end
+
+  describe '#to_s' do
+    it 'provides position and direction in string' do
+      robot.send(:direction=, :north)
+      allow(robot.table).to receive(:position).and_return(position)
+      expect(robot.to_s).to eq('1, 2 NORTH')
+    end
+  end
+
+  describe '#move_coordinates' do
+    it 'returns coords from current face' do
+      robot.send(:direction=, :north)
+      expect(robot.send(:move_coordinates)).to eq(x: 0, y: 1)
+    end
+  end
+
+  describe '#right' do
+    it 'returns correct face clockwise' do
+      robot.send(:direction=, :north)
+      expect(robot).to receive(:direction=).with(:east)
+      expect(robot.right).to eq(:east)
+    end
+  end
+
+  describe '#left' do
+    it 'returns correct face anti-clockwise' do
+      robot.send(:direction=, :west)
+      expect(robot).to receive(:direction=).with(:south)
+      expect(robot.left).to eq(:south)
+    end
+  end
+
+  describe '#report' do
+    let(:table) { double(Robot::Table, position: { x: 1, y: 2 }) }
+
+    it 'outputs text and calls say' do
+      expect(robot).to receive(:direction).exactly(3).times.and_return(:north)
+      allow(robot).to receive(:table).and_return(table)
+      expect(Robot::CommandCentre.instance).to receive(:say)
+      robot.report
+    end
+  end
+
+  describe '#place' do
+    context 'with invalid args' do
+      it 'does nothing with nil args' do
+        expect(robot.table).not_to receive(:place)
+        robot.place(nil)
+      end
+
+      it 'does nothing with blank string' do
+        expect(robot.table).not_to receive(:place)
+        robot.place('        ')
+      end
+
+      it 'does nothing with malformed args' do
+        expect(robot.table).not_to receive(:place)
+        robot.place('1,2north')
+        robot.place('north')
+      end
+    end
+
+    context 'with valid args' do
+      context 'and valid placement' do
+        it 'sets direction' do
+          expect(robot.table).to receive(:place).with(
+            '1', '2'
+          ).and_call_original
+          expect(robot).to receive(:direction=).with(:north)
+          robot.place('1,2,north')
+        end
+      end
+
+      context 'and invalid placement' do
+        it 'does not set direction when place fails' do
+          expect(robot.table).to receive(:place).with('1', '2')
+          expect(robot).not_to receive(:direction=)
+          robot.place('1,2,north')
+        end
+      end
+    end
+  end
+
+  describe '#direction=' do
+    context 'direction is invalid' do
+      it 'does not save position' do
+        robot.send(:direction=, :up)
+        expect(robot.direction).not_to be
+      end
+    end
+    context 'direction is valid' do
+      it 'does save to singleton' do
+        robot.send(:direction=, :west)
+        expect(robot.direction).to eq(:west)
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+require 'rubygems'
+require 'json'
+require 'simplecov'
+require 'codeclimate-test-reporter'
+CodeClimate::TestReporter.start
+
+SimpleCov.start
+
+require 'robot'
+
+RSpec.configure do |config|
+  config.disable_monkey_patching!
+  config.expose_dsl_globally = true
+  config.order = :random
+end

data/test_data.txt

@@ -0,0 +1,20 @@
+PLACE 1,2,EAST
+MOVE
+MOVE
+LEFT
+MOVE
+RIGHT
+MOVE
+LEFT
+LEFT
+MOVE
+MOVE
+MOVE
+MOVE
+LEFT
+MOVE
+MOVE
+MOVE
+RIGHT
+RIGHT
+REPORT

metadata

@@ -0,0 +1,186 @@
+--- !ruby/object:Gem::Specification
+name: robert2d-robot
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Dave Robertson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-07-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.10.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.10.5
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.3.0
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.12.8
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.12.8
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 4.6.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 4.6.2
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.32.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.32.1
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+description: 
+email:
+- dave.andrew.robertson.nz@gmail.com
+executables:
+- robot
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .rubocop.yml
+- .ruby-version
+- .travis.yml
+- Gemfile
+- Gemfile.lock
+- Guardfile
+- README.md
+- Rakefile
+- bin/robot
+- instructions.txt
+- lib/robot.rb
+- lib/robot/command_centre.rb
+- lib/robot/matrix.rb
+- lib/robot/table.rb
+- lib/robot/version.rb
+- robert2d-robot.gemspec
+- spec/lib/robot/command_centre_spec.rb
+- spec/lib/robot/matrix_spec.rb
+- spec/lib/robot/table_spec.rb
+- spec/lib/robot_spec.rb
+- spec/spec_helper.rb
+- test_data.txt
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Toy Robot CLI
+test_files:
+- spec/lib/robot/command_centre_spec.rb
+- spec/lib/robot/matrix_spec.rb
+- spec/lib/robot/table_spec.rb
+- spec/lib/robot_spec.rb
+- spec/spec_helper.rb