toy 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4f0ff45fd29860f8d248a37b475b2a56176b5b22
+  data.tar.gz: f5b66908dc97de61cf30e4fa1812916e66eb6105
+SHA512:
+  metadata.gz: ba9d7063eba65eca749ca6f6e2a077dd9e79eb91ae9bd3f00f8d5b2e6dba0ce807dacc64389b5df5947934bab40583cdc0a961a60f84bc59261cdb261557fc7d
+  data.tar.gz: 38c0cfe33473630901493bbb600fd58326f0ba0e091c4b0f80a4b2bf91f4b4b703d0bead1f7823e3e00c8dbc1270380e54162ecf04443709f968951a0891b1b9

data/.document

@@ -0,0 +1,4 @@
+lib/**/*.rb
+README.md
+ChangeLog.md
+LICENSE.txt

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/
+vendor/

data/.rspec

@@ -0,0 +1 @@
+--colour

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.4
+addons:
+  code_climate:
+    repo_token: 315a51b0a3c5c30885d590e04f4c92df0800f74973d33e762cb6da7b2c4ef51e

data/ChangeLog.md

@@ -0,0 +1,3 @@
+### 0.1.0 / 2015-01-25 ###
+
+* Initial release

data/Gemfile

@@ -0,0 +1,4 @@
+source 'http://rubygems.org'
+
+gem 'rake'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,46 @@
+PATH
+  remote: .
+  specs:
+    toy (0.1.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    codeclimate-test-reporter (0.4.6)
+      simplecov (>= 0.7.1, < 1.0.0)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    json (1.8.2)
+    multi_json (1.10.1)
+    rake (10.4.2)
+    rdoc (4.2.0)
+      json (~> 1.4)
+    rspec (3.1.0)
+      rspec-core (~> 3.1.0)
+      rspec-expectations (~> 3.1.0)
+      rspec-mocks (~> 3.1.0)
+    rspec-core (3.1.7)
+      rspec-support (~> 3.1.0)
+    rspec-expectations (3.1.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.1.0)
+    rspec-mocks (3.1.3)
+      rspec-support (~> 3.1.0)
+    rspec-support (3.1.2)
+    rubygems-tasks (0.2.4)
+    simplecov (0.9.1)
+      docile (~> 1.1.0)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  codeclimate-test-reporter
+  rake
+  rdoc (~> 4.1)
+  rspec (~> 3.1)
+  rubygems-tasks (~> 0.2)
+  toy!

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2015 Ninoslav Milenovic
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,49 @@
+# toy #
+
+[![Gem Version](https://badge.fury.io/rb/toy.svg)](http://badge.fury.io/rb/toy)
+[![Build Status](https://travis-ci.org/rubyengineer/toy.svg?branch=master)](https://travis-ci.org/rubyengineer/toy)
+[![Code Climate](https://codeclimate.com/github/rubyengineer/toy/badges/gpa.svg)](https://codeclimate.com/github/rubyengineer/toy)
+[![Test Coverage](https://codeclimate.com/github/rubyengineer/toy/badges/coverage.svg)](https://codeclimate.com/github/rubyengineer/toy)
+[![Dependency Status](https://gemnasium.com/rubyengineer/toy.svg)](https://gemnasium.com/rubyengineer/toy)
+
+Simulation of a toy robot moving on a square tabletop. 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. Multiple robots should be able to roam around the surface of the same table.
+
+## Install ##
+```bash
+$ gem install toy
+```
+
+## Usage ##
+```bash
+$ toy
+```
+
+## Examples ##
+
+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`
+
+### Copyright ###
+Copyright (c) 2015 Ninoslav Milenovic
+
+See LICENSE.txt for details.

data/Rakefile

@@ -0,0 +1,41 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'rake'
+
+begin
+  gem 'rubygems-tasks', '~> 0.2'
+  require 'rubygems/tasks'
+
+  Gem::Tasks.new
+rescue LoadError => e
+  warn e.message
+  warn 'Run `gem install rubygems-tasks` to install Gem::Tasks.'
+end
+
+begin
+  gem 'rdoc', '~> 4.1'
+  require 'rdoc/task'
+
+  RDoc::Task.new do |rdoc|
+    rdoc.title = 'trange_frange'
+  end
+rescue LoadError => e
+  warn e.message
+  warn "Run `gem install rdoc` to install 'rdoc/task'."
+end
+task :doc => :rdoc
+
+begin
+  gem 'rspec', '~> 3.1'
+  require 'rspec/core/rake_task'
+
+  RSpec::Core::RakeTask.new
+rescue LoadError => e
+  task :spec do
+    abort 'Please run `gem install rspec` to install RSpec.'
+  end
+end
+
+task :test    => :spec
+task :default => :spec

data/bin/toy

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+
+require 'toy'
+
+Toy::Controller.new.start

data/lib/toy.rb

@@ -0,0 +1,9 @@
+# encoding: utf-8
+
+require_relative 'toy/unit'
+require_relative 'toy/unit_collection'
+require_relative 'toy/table'
+require_relative 'toy/direction'
+require_relative 'toy/robot'
+require_relative 'toy/version'
+require_relative 'toy/controller'

data/lib/toy/controller.rb

@@ -0,0 +1,99 @@
+# encoding: utf-8
+
+module Toy
+  class Controller
+    COMMANDS = %w[STOP HELP PLACE MOVE LEFT RIGHT REPORT]
+
+    attr_reader :robot
+
+    def initialize
+      @robot = Robot.new
+    end
+
+    def start
+      while command = gets
+        unless COMMANDS.include?(command.gsub(/^[A-Z]+/).first)
+          puts 'Invalid command! Type HELP for list of available commands.' and next
+        end
+
+        case command
+          when /STOP/
+            break
+          else
+            output = execute(command.strip)
+            puts output if output
+        end          
+      end
+    end
+
+    private
+
+      def execute(command)
+        case command
+          when /HELP/
+            help
+          when /PLACE/
+            place(command)
+          when /MOVE/
+            move
+          when /LEFT/
+            left
+          when /RIGHT/
+            right
+          when /REPORT/
+            report
+        end
+      end
+
+      def help
+        "Available commands: #{COMMANDS.join(' ')}"
+      end
+
+      def place(command)
+        begin
+          x, y, facing = command.split(' ', 2).last.split(',')
+
+          x = x.to_i if x.strip.match(/^(\d)+$/)
+          y = y.to_i if y.strip.match(/^(\d)+$/)
+          facing = facing.strip.downcase.to_sym
+        rescue
+          return 'Invalid placement arguments!'
+        end
+
+        begin
+          @robot.place(x, y, facing) and return nil
+        rescue Toy::Direction::Error::DirectionError => e
+          e.message
+        rescue Toy::Unit::Error::CoordinateError => e
+          e.message
+        rescue Toy::Table::Error::TableError
+          "Not available!"
+        end
+      end
+
+      def move
+        action { @robot.move! }
+      end
+
+      def left
+        action { @robot.turn_left! }
+      end
+
+      def right
+        action { @robot.turn_right! }
+      end
+
+      def report
+        action do 
+          x, y, facing = @robot.position
+          return "#{x},#{y},#{facing.upcase}"
+        end
+      end
+
+      def action(&execute)
+        yield execute and return nil
+      rescue Toy::Robot::Error::PlacementError => e
+        e.message
+      end
+  end
+end

data/lib/toy/direction.rb

@@ -0,0 +1,38 @@
+# encoding: utf-8
+
+module Toy
+  class Direction
+    NORTH = :north
+    EAST  = :east
+    SOUTH = :south
+    WEST  = :west
+
+    DIRECTION = [NORTH, EAST, SOUTH, WEST]
+
+    class << self
+      def rotate_left(direction)
+        element(direction, -1)
+      end
+
+      def rotate_right(direction)
+        element(direction, 1)
+      end
+
+      private
+
+        def element(direction, index)
+          raise Error::DirectionError unless DIRECTION.include?(direction)
+
+          DIRECTION[(DIRECTION.index(direction) + index) % DIRECTION.size]
+        end
+    end
+    
+    module Error
+      class DirectionError < ArgumentError
+        def message
+          'Invalid direction!'
+        end
+      end
+    end
+  end
+end

data/lib/toy/robot.rb

@@ -0,0 +1,66 @@
+# encoding: utf-8
+
+module Toy
+  class Robot
+    attr_reader :table, :facing
+
+    def initialize(table=Table.new, direction=Direction)
+      @table = table
+      @direction = direction
+      @facing = nil
+    end
+
+    def place(x, y, facing)
+      raise @direction::Error::DirectionError unless @direction::DIRECTION.include?(facing)
+
+      @table.hold!(x, y, self)
+      @facing = facing
+    end
+
+    def placed?
+      !!current_unit
+    end
+
+    def position
+      raise Error::PlacementError unless placed?
+
+      [current_unit.x, current_unit.y, @facing]
+    end
+
+    def move!
+      raise Error::PlacementError unless placed?
+
+      place(target.x, target.y, @facing) if target && target.available?
+    end
+
+    def turn_left!
+      raise Error::PlacementError unless placed?
+
+      @facing = @direction.rotate_left(@facing)
+    end
+
+    def turn_right!
+      raise Error::PlacementError unless placed?
+      
+      @facing = @direction.rotate_right(@facing)
+    end
+
+    private
+
+      def current_unit
+        @table.unit_collection.find_by_object(self)
+      end
+
+      def target
+        @table.unit_collection.find_by_direction_of(current_unit.x, current_unit.y, @facing)
+      end
+
+    module Error
+      class PlacementError < StandardError
+        def message
+          'Robot is not placed!'
+        end
+      end
+    end
+  end
+end

data/lib/toy/table.rb

@@ -0,0 +1,52 @@
+# encoding: utf-8
+
+module Toy
+  class Table
+    X_SIZE = 5
+    Y_SIZE = 5
+
+    # X_STARTS_FROM = WEST
+    # Y_STARTS_FROM = SOUTH
+
+    attr_reader :unit_collection
+
+    def initialize(unit=Unit)
+      @unit = unit
+      @unit_collection = generate_collection!
+    end
+
+    def hold!(x, y, object)
+      raise @unit::Error::CoordinateError unless x.is_a?(Fixnum)
+      raise @unit::Error::CoordinateError unless y.is_a?(Fixnum)
+
+      target_unit = @unit_collection.find_by_coordinates(x, y)
+
+      if target_unit && target_unit.available?
+        @unit_collection.find_by_object(object) && @unit_collection.find_by_object(object).release!
+        target_unit.hold!(object)
+      else 
+        raise Error::TableError
+      end
+    end
+
+    private
+
+      def generate_collection!
+        UnitCollection.new.tap do |uc|
+          X_SIZE.times do |x|
+            Y_SIZE.times do |y|
+              uc.add(@unit.new(table=self, x, y))
+            end
+          end
+        end
+      end
+
+    module Error
+      class TableError < StandardError
+        def message
+          'Unit is not available.'
+        end
+      end
+    end
+  end
+end