ruby_robot 0.1.9

data/lib/ruby_robot.rb

@@ -0,0 +1,16 @@
+require "ruby_robot/version"
+require "ruby_robot/tabletop"
+require "ruby_robot/netflix_tabletop"
+require "ruby_robot/robot"
+require "ruby_robot/construction_error"
+require "ruby_robot/schema_loader"
+require "ruby_robot/placement_error"
+require "ruby_robot/shell"
+require "ruby_robot/webapp"
+require "ruby_robot/grpc_helper"
+require "ruby_robot/grpc_shell"
+require "ruby_robot/grpc_ruby/ruby_robot_pb"
+require 'ruby_robot/grpc_helper'
+
+module RubyRobot
+end

data/lib/ruby_robot/cacerts.crt

@@ -0,0 +1,92 @@
+-----BEGIN CERTIFICATE-----
+MIIENjCCAx6gAwIBAgIBATANBgkqhkiG9w0BAQUFADBvMQswCQYDVQQGEwJTRTEU
+MBIGA1UEChMLQWRkVHJ1c3QgQUIxJjAkBgNVBAsTHUFkZFRydXN0IEV4dGVybmFs
+IFRUUCBOZXR3b3JrMSIwIAYDVQQDExlBZGRUcnVzdCBFeHRlcm5hbCBDQSBSb290
+MB4XDTAwMDUzMDEwNDgzOFoXDTIwMDUzMDEwNDgzOFowbzELMAkGA1UEBhMCU0Ux
+FDASBgNVBAoTC0FkZFRydXN0IEFCMSYwJAYDVQQLEx1BZGRUcnVzdCBFeHRlcm5h
+bCBUVFAgTmV0d29yazEiMCAGA1UEAxMZQWRkVHJ1c3QgRXh0ZXJuYWwgQ0EgUm9v
+dDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALf3GjPm8gAELTngTlvt
+H7xsD821+iO2zt6bETOXpClMfZOfvUq8k+0DGuOPz+VtUFrWlymUWoCwSXrbLpX9
+uMq/NzgtHj6RQa1wVsfwTz/oMp50ysiQVOnGXw94nZpAPA6sYapeFI+eh6FqUNzX
+mk6vBbOmcZSccbNQYArHE504B4YCqOmoaSYYkKtMsE8jqzpPhNjfzp/haW+710LX
+a0Tkx63ubUFfclpxCDezeWWkWaCUN/cALw3CknLa0Dhy2xSoRcRdKn23tNbE7qzN
+E0S3ySvdQwAl+mG5aWpYIxG3pzOPVnVZ9c0p10a3CitlttNCbxWyuHv77+ldU9U0
+WicCAwEAAaOB3DCB2TAdBgNVHQ4EFgQUrb2YejS0Jvf6xCZU7wO94CTLVBowCwYD
+VR0PBAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wgZkGA1UdIwSBkTCBjoAUrb2YejS0
+Jvf6xCZU7wO94CTLVBqhc6RxMG8xCzAJBgNVBAYTAlNFMRQwEgYDVQQKEwtBZGRU
+cnVzdCBBQjEmMCQGA1UECxMdQWRkVHJ1c3QgRXh0ZXJuYWwgVFRQIE5ldHdvcmsx
+IjAgBgNVBAMTGUFkZFRydXN0IEV4dGVybmFsIENBIFJvb3SCAQEwDQYJKoZIhvcN
+AQEFBQADggEBALCb4IUlwtYj4g+WBpKdQZic2YR5gdkeWxQHIzZlj7DYd7usQWxH
+YINRsPkyPef89iYTx4AWpb9a/IfPeHmJIZriTAcKhjW88t5RxNKWt9x+Tu5w/Rw5
+6wwCURQtjr0W4MHfRnXnJK3s9EK0hZNwEGe6nQY1ShjTK3rMUUKhemPR5ruhxSvC
+Nr4TDea9Y355e6cJDUCrat2PisP29owaQgVR1EX1n6diIWgVIEM8med8vSTYqZEX
+c4g/VhsxOBi0cQ+azcgOno4uG+GMmIPLHzHxREzGBHNJdmAPx/i9F4BrLunMTA5a
+mnkPIAou1Z5jJh5VkpTYghdae9C8x49OhgQ=
+-----END CERTIFICATE-----
+-----BEGIN CERTIFICATE-----
+MIIFdDCCBFygAwIBAgIQJ2buVutJ846r13Ci/ITeIjANBgkqhkiG9w0BAQwFADBv
+MQswCQYDVQQGEwJTRTEUMBIGA1UEChMLQWRkVHJ1c3QgQUIxJjAkBgNVBAsTHUFk
+ZFRydXN0IEV4dGVybmFsIFRUUCBOZXR3b3JrMSIwIAYDVQQDExlBZGRUcnVzdCBF
+eHRlcm5hbCBDQSBSb290MB4XDTAwMDUzMDEwNDgzOFoXDTIwMDUzMDEwNDgzOFow
+gYUxCzAJBgNVBAYTAkdCMRswGQYDVQQIExJHcmVhdGVyIE1hbmNoZXN0ZXIxEDAO
+BgNVBAcTB1NhbGZvcmQxGjAYBgNVBAoTEUNPTU9ETyBDQSBMaW1pdGVkMSswKQYD
+VQQDEyJDT01PRE8gUlNBIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIICIjANBgkq
+hkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAkehUktIKVrGsDSTdxc9EZ3SZKzejfSNw
+AHG8U9/E+ioSj0t/EFa9n3Byt2F/yUsPF6c947AEYe7/EZfH9IY+Cvo+XPmT5jR6
+2RRr55yzhaCCenavcZDX7P0N+pxs+t+wgvQUfvm+xKYvT3+Zf7X8Z0NyvQwA1onr
+ayzT7Y+YHBSrfuXjbvzYqOSSJNpDa2K4Vf3qwbxstovzDo2a5JtsaZn4eEgwRdWt
+4Q08RWD8MpZRJ7xnw8outmvqRsfHIKCxH2XeSAi6pE6p8oNGN4Tr6MyBSENnTnIq
+m1y9TBsoilwie7SrmNnu4FGDwwlGTm0+mfqVF9p8M1dBPI1R7Qu2XK8sYxrfV8g/
+vOldxJuvRZnio1oktLqpVj3Pb6r/SVi+8Kj/9Lit6Tf7urj0Czr56ENCHonYhMsT
+8dm74YlguIwoVqwUHZwK53Hrzw7dPamWoUi9PPevtQ0iTMARgexWO/bTouJbt7IE
+IlKVgJNp6I5MZfGRAy1wdALqi2cVKWlSArvX31BqVUa/oKMoYX9w0MOiqiwhqkfO
+KJwGRXa/ghgntNWutMtQ5mv0TIZxMOmm3xaG4Nj/QN370EKIf6MzOi5cHkERgWPO
+GHFrK+ymircxXDpqR+DDeVnWIBqv8mqYqnK8V0rSS527EPywTEHl7R09XiidnMy/
+s1Hap0flhFMCAwEAAaOB9DCB8TAfBgNVHSMEGDAWgBStvZh6NLQm9/rEJlTvA73g
+JMtUGjAdBgNVHQ4EFgQUu69+Aj36pvE8hI6t7jiY7NkyMtQwDgYDVR0PAQH/BAQD
+AgGGMA8GA1UdEwEB/wQFMAMBAf8wEQYDVR0gBAowCDAGBgRVHSAAMEQGA1UdHwQ9
+MDswOaA3oDWGM2h0dHA6Ly9jcmwudXNlcnRydXN0LmNvbS9BZGRUcnVzdEV4dGVy
+bmFsQ0FSb290LmNybDA1BggrBgEFBQcBAQQpMCcwJQYIKwYBBQUHMAGGGWh0dHA6
+Ly9vY3NwLnVzZXJ0cnVzdC5jb20wDQYJKoZIhvcNAQEMBQADggEBAGS/g/FfmoXQ
+zbihKVcN6Fr30ek+8nYEbvFScLsePP9NDXRqzIGCJdPDoCpdTPW6i6FtxFQJdcfj
+Jw5dhHk3QBN39bSsHNA7qxcS1u80GH4r6XnTq1dFDK8o+tDb5VCViLvfhVdpfZLY
+Uspzgb8c8+a4bmYRBbMelC1/kZWSWfFMzqORcUx8Rww7Cxn2obFshj5cqsQugsv5
+B5a6SE2Q8pTIqXOi6wZ7I53eovNNVZ96YUWYGGjHXkBrI/V5eu+MtWuLt29G9Hvx
+PUsE2JOAWVrgQSQdso8VYFhH2+9uRv0V9dlfmrPb2LjkQLPNlzmuhbsdjrzch5vR
+pu/xO28QOG8=
+-----END CERTIFICATE-----
+-----BEGIN CERTIFICATE-----
+MIIGCDCCA/CgAwIBAgIQKy5u6tl1NmwUim7bo3yMBzANBgkqhkiG9w0BAQwFADCB
+hTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G
+A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNV
+BAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTQwMjEy
+MDAwMDAwWhcNMjkwMjExMjM1OTU5WjCBkDELMAkGA1UEBhMCR0IxGzAZBgNVBAgT
+EkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMR
+Q09NT0RPIENBIExpbWl0ZWQxNjA0BgNVBAMTLUNPTU9ETyBSU0EgRG9tYWluIFZh
+bGlkYXRpb24gU2VjdXJlIFNlcnZlciBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEP
+ADCCAQoCggEBAI7CAhnhoFmk6zg1jSz9AdDTScBkxwtiBUUWOqigwAwCfx3M28Sh
+bXcDow+G+eMGnD4LgYqbSRutA776S9uMIO3Vzl5ljj4Nr0zCsLdFXlIvNN5IJGS0
+Qa4Al/e+Z96e0HqnU4A7fK31llVvl0cKfIWLIpeNs4TgllfQcBhglo/uLQeTnaG6
+ytHNe+nEKpooIZFNb5JPJaXyejXdJtxGpdCsWTWM/06RQ1A/WZMebFEh7lgUq/51
+UHg+TLAchhP6a5i84DuUHoVS3AOTJBhuyydRReZw3iVDpA3hSqXttn7IzW3uLh0n
+c13cRTCAquOyQQuvvUSH2rnlG51/ruWFgqUCAwEAAaOCAWUwggFhMB8GA1UdIwQY
+MBaAFLuvfgI9+qbxPISOre44mOzZMjLUMB0GA1UdDgQWBBSQr2o6lFoL2JDqElZz
+30O0Oija5zAOBgNVHQ8BAf8EBAMCAYYwEgYDVR0TAQH/BAgwBgEB/wIBADAdBgNV
+HSUEFjAUBggrBgEFBQcDAQYIKwYBBQUHAwIwGwYDVR0gBBQwEjAGBgRVHSAAMAgG
+BmeBDAECATBMBgNVHR8ERTBDMEGgP6A9hjtodHRwOi8vY3JsLmNvbW9kb2NhLmNv
+bS9DT01PRE9SU0FDZXJ0aWZpY2F0aW9uQXV0aG9yaXR5LmNybDBxBggrBgEFBQcB
+AQRlMGMwOwYIKwYBBQUHMAKGL2h0dHA6Ly9jcnQuY29tb2RvY2EuY29tL0NPTU9E
+T1JTQUFkZFRydXN0Q0EuY3J0MCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5jb21v
+ZG9jYS5jb20wDQYJKoZIhvcNAQEMBQADggIBAE4rdk+SHGI2ibp3wScF9BzWRJ2p
+mj6q1WZmAT7qSeaiNbz69t2Vjpk1mA42GHWx3d1Qcnyu3HeIzg/3kCDKo2cuH1Z/
+e+FE6kKVxF0NAVBGFfKBiVlsit2M8RKhjTpCipj4SzR7JzsItG8kO3KdY3RYPBps
+P0/HEZrIqPW1N+8QRcZs2eBelSaz662jue5/DJpmNXMyYE7l3YphLG5SEXdoltMY
+dVEVABt0iN3hxzgEQyjpFv3ZBdRdRydg1vs4O2xyopT4Qhrf7W8GjEXCBgCq5Ojc
+2bXhc3js9iPc0d1sjhqPpepUfJa3w/5Vjo1JXvxku88+vZbrac2/4EjxYoIQ5QxG
+V/Iz2tDIY+3GH5QFlkoakdH368+PUq4NCNk+qKBR6cGHdNXJ93SrLlP7u3r7l+L4
+HyaPs9Kg4DdbKDsx5Q5XLVq4rXmsXiBmGqW5prU5wfWYQ//u+aen/e7KJD2AFsQX
+j4rBYKEMrltDR5FL1ZoXX/nUh8HCjLfn4g8wGTeGrODcQgPmlKidrv0PJFGUzpII
+0fxQ8ANAe4hZ7Q7drNJ3gjTcBpUC2JD5Leo31Rpg0Gcg19hCC0Wvgmje3WYkN5Ap
+lBlGGSW4gNfL1IYoakRwJiNiqZ+Gb7+6kHDSVneFeO/qJakXzlByjAA6quPbYzSf
++AZxAeKCINT+b72x
+-----END CERTIFICATE-----

data/lib/ruby_robot/construction_error.rb

@@ -0,0 +1,4 @@
+module RubyRobot
+class ConstructionError < RuntimeError
+end
+end

data/lib/ruby_robot/grpc/robot_service.rb

@@ -0,0 +1,102 @@
+#!/usr/bin/env ruby
+require 'grpc'
+# Tweak the load path so ruby_robot_services_pb can 
+# load ruby_robot_pb
+$: << File.dirname(__FILE__) + '/../grpc_ruby'
+require 'ruby_robot/grpc/ruby_robot_services_pb'
+require 'logger'
+$:.unshift(File.dirname(__FILE__) + '/../lib') unless $:.include?(File.dirname(__FILE__) + '/../lib')
+require 'ruby_robot'
+
+module RubyRobot
+module Grpc
+class RobotService < ::RubyRobot::RubyRobot::Service
+  def logger
+    @logger ||= proc {
+      Logger.new(STDOUT)
+    }.call
+  end
+
+  def robot
+    @@robot ||= proc {
+      rr = ::RubyRobot::Shell.new
+      def rr.placed?
+        !@robot.nil?
+      end
+      rr
+    }.call
+  end
+
+  def not_placed_error
+    ::RubyRobot::RubyRobotResponse.new(
+      error: ::RubyRobot::RubyRobotError.new(error: 400, message: "Robot is not currently placed")
+    )
+  end
+
+  def position_report
+    rr = robot.REPORT(false)
+
+    ::RubyRobot::RubyRobotResponse.new(
+      current_state: ::RubyRobot::RubyRobotRequest.new(
+        x:         rr[:x],
+        y:         rr[:y],
+        direction: rr[:direction].to_s.upcase.to_sym
+      )
+    )
+  end
+
+  def left(empty, _unused_call)
+    logger.info "#{__method__} called (robot.placed?==#{robot.placed?})"
+    if robot.placed?
+      robot.LEFT
+      position_report
+    else
+      not_placed_error
+    end
+  end
+
+  def move(empty, _unused_call)
+    logger.info "#{__method__} called (robot.placed?==#{robot.placed?})"
+    if robot.placed?
+      robot.MOVE
+      position_report
+    else
+      not_placed_error
+    end
+  end
+
+  def place(robot_request, _unused_call)
+    input = { x: robot_request.x, y: robot_request.y, direction: robot_request.direction }
+    logger.info "#{__method__} called with #{input.to_json}"
+
+    robot.PLACE(robot_request.x, robot_request.y, robot_request.direction.to_s.downcase)
+    position_report
+  end
+
+  def remove(empty, _unused_call)
+    logger.info "#{__method__} called"
+    @@robot = nil
+    ::Google::Protobuf::Empty.new
+  end
+
+  def report(empty, _unused_call)
+    logger.info "#{__method__} called (robot.placed?==#{robot.placed?})"
+    if robot.placed?
+      position_report
+    else
+      not_placed_error
+    end
+  end
+
+  def right(empty, _unused_call)
+    logger.info "#{__method__} called (robot.placed?==#{robot.placed?})"
+    if robot.placed?
+      robot.RIGHT
+      position_report
+    else
+      not_placed_error
+    end
+  end
+end
+end
+end

data/lib/ruby_robot/grpc/ruby_robot_services_pb.rb

@@ -0,0 +1,34 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: ruby_robot.proto for package 'RubyRobot'
+# Original file comments:
+#
+# gRPC service definition for the RubyRobot.
+#
+
+require 'grpc'
+require 'ruby_robot_pb'
+
+module RubyRobot
+  module RubyRobot
+    #
+    # Service definitions
+    #
+    class Service
+
+      include GRPC::GenericService
+
+      self.marshal_class_method = :encode
+      self.unmarshal_class_method = :decode
+      self.service_name = 'RubyRobot.RubyRobot'
+
+      rpc :Left, Google::Protobuf::Empty, RubyRobotResponse
+      rpc :Move, Google::Protobuf::Empty, RubyRobotResponse
+      rpc :Place, RubyRobotRequest, RubyRobotResponse
+      rpc :Remove, Google::Protobuf::Empty, Google::Protobuf::Empty
+      rpc :Report, Google::Protobuf::Empty, RubyRobotResponse
+      rpc :Right, Google::Protobuf::Empty, RubyRobotResponse
+    end
+
+    Stub = Service.rpc_stub_class
+  end
+end

data/lib/ruby_robot/grpc_helper.rb

@@ -0,0 +1,15 @@
+require 'ruby_robot/grpc_ruby/ruby_robot_pb'
+#
+# Define #to_json on ::RubyRobot::RubyRobotRequest for prettier printing.
+#
+module RubyRobot
+class RubyRobotRequest
+  def to_json
+    {
+      x: self.x,
+      y: self.y,
+      direction: self.direction.to_s
+    }.to_json
+  end
+end
+end

data/lib/ruby_robot/grpc_ruby/ruby_robot_pb.rb

@@ -0,0 +1,36 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: ruby_robot.proto
+
+require 'google/protobuf'
+
+require 'google/protobuf/empty_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "RubyRobot.RubyRobotRequest" do
+    optional :x, :int32, 1
+    optional :y, :int32, 2
+    optional :direction, :enum, 3, "RubyRobot.RubyRobotRequest.Direction"
+  end
+  add_enum "RubyRobot.RubyRobotRequest.Direction" do
+    value :NORTH, 0
+    value :EAST, 1
+    value :SOUTH, 2
+    value :WEST, 3
+  end
+  add_message "RubyRobot.RubyRobotError" do
+    optional :error, :int32, 1
+    optional :message, :string, 2
+  end
+  add_message "RubyRobot.RubyRobotResponse" do
+    oneof :response do
+      optional :current_state, :message, 1, "RubyRobot.RubyRobotRequest"
+      optional :error, :message, 2, "RubyRobot.RubyRobotError"
+    end
+  end
+end
+
+module RubyRobot
+  RubyRobotRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("RubyRobot.RubyRobotRequest").msgclass
+  RubyRobotRequest::Direction = Google::Protobuf::DescriptorPool.generated_pool.lookup("RubyRobot.RubyRobotRequest.Direction").enummodule
+  RubyRobotError = Google::Protobuf::DescriptorPool.generated_pool.lookup("RubyRobot.RubyRobotError").msgclass
+  RubyRobotResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("RubyRobot.RubyRobotResponse").msgclass
+end

data/lib/ruby_robot/grpc_shell.rb

@@ -0,0 +1,85 @@
+require 'bombshell'
+require 'logger'
+require 'ruby_robot/shell'
+require 'ruby_robot/grpc_helper'
+$: << File.dirname(__FILE__) + '/grpc_ruby'
+require 'ruby_robot/grpc/ruby_robot_services_pb'
+
+module RubyRobot
+#
+# Override all methods inherited from Shell
+# such that they use gRPC to communicate 
+# with a remote Robot.
+#
+# TODO: RPC error handling (more info at
+# https://grpc.io/docs/guides/error.html).
+#
+class GrpcShell < ::Bombshell::Environment
+  include ::Bombshell::Shell
+
+  prompt_with 'ILoveNetflixStudio&gRPC'
+
+  # TODO: Figure out if there's a way to pass args down into
+  # ::Bombshell#launch so this isn't a class attr.
+  def self.remote_url=(new_url)
+    # Convert to URI if String
+    @@remote_url = new_url.kind_of?(String) ? URI.parse(new_url) : new_url
+  end
+  def initialize
+    # TODO: Enable SSL/TLS
+    # Totally cheating here: if URI is grpc://netflix.avilla.net, 
+    # then load up the cert (stored in the gem).
+    if @@remote_url.to_s.start_with?("grpcs://netflix.avilla.net")
+      ca_path = File.join(File.dirname(__FILE__), "cacerts.crt")
+      channel_creds = GRPC::Core::ChannelCredentials.new(File.read(ca_path))
+      stub_opts = {
+        :creds => channel_creds, 
+        GRPC::Core::Channel::SSL_TARGET => @@remote_url.host
+      }
+      @stub = ::RubyRobot::RubyRobot::Stub.new(
+        "#{@@remote_url.host}:#{@@remote_url.port}", channel_creds
+      )
+    else
+      @stub = ::RubyRobot::RubyRobot::Stub.new("#{@@remote_url.host}:#{@@remote_url.port}", :this_channel_is_insecure)
+    end
+    puts "Checking state of Robot at #{@@remote_url}"
+    self.REPORT()
+  end
+
+  def PLACE(x, y, direction)
+    @stub.place(::RubyRobot::RubyRobotRequest.new(x: x, y: y, direction: direction.to_s.upcase.to_sym))
+  end
+
+  def MOVE
+    @stub.move(Google::Protobuf::Empty.new)
+  end
+
+  def LEFT
+    @stub.left(Google::Protobuf::Empty.new)
+  end
+
+  def RIGHT
+    @stub.right(Google::Protobuf::Empty.new)
+  end
+
+  def REPORT(to_stderr=false)
+    resp = @stub.report(Google::Protobuf::Empty.new)
+    if resp.error
+      puts resp.error.message 
+    else
+      puts resp.current_state.to_json
+    end
+  end
+
+  def REMOVE
+    @stub.remove(Google::Protobuf::Empty.new)
+  end
+
+  alias :QUIT :quit
+end
+end
+module Bombshell
+module Shell
+  REMOVE=:remove
+end
+end

data/lib/ruby_robot/netflix_tabletop.rb

@@ -0,0 +1,14 @@
+require 'ruby_robot/tabletop'
+
+#
+# A Tabletop which is 5x5
+#
+module RubyRobot
+class NetflixTabletop < Tabletop
+	def initialize
+  	# The instructions say that a Netflix Tabletop
+  	# is 5x5
+  	super(5, 5)
+	end
+end
+end

data/lib/ruby_robot/placement_error.rb

@@ -0,0 +1,4 @@
+module RubyRobot
+class PlacementError < RuntimeError
+end
+end

data/lib/ruby_robot/robot.rb

@@ -0,0 +1,71 @@
+module RubyRobot
+class Robot
+
+  # Directions are clockwise from north
+  VALID_DIRECTIONS = [:north, :east, :south, :west]
+
+  attr_reader :direction 
+  attr_reader :tabletop
+  
+  def initialize(direction)
+    orig_direction = direction
+    err_msg = "New Robots must have direction value of one of the following symbols: #{VALID_DIRECTIONS.join(', ')}; invalid value '#{orig_direction}'"
+    direction = direction.kind_of?(String) ? direction.downcase.to_sym : direction
+    raise ConstructionError.new(err_msg) unless VALID_DIRECTIONS.include?(direction)
+    @direction = direction
+    @tabletop = nil
+  end
+
+  def inspect
+    case @direction
+    when :north then "^"
+    when :south then "|"
+    when :east  then ">"
+    # :west
+    else "<"
+    end
+  end
+
+  def left
+    # A little cheating here...index -1 will effectively wrap around and
+    # return the last element
+    @direction = VALID_DIRECTIONS[dir_idx - 1]
+  end
+
+  def right
+    @direction = VALID_DIRECTIONS[(dir_idx + 1) % VALID_DIRECTIONS.size]
+  end
+
+  #
+  # Called by a Tabletop where this has been placed
+  #
+  def place(tabletop)
+    @tabletop = tabletop
+  end
+
+  def report
+    @tabletop.position(self).merge(direction: direction)
+  end
+
+  #
+  # TODO: Error checking for if @tabletop.nil?
+  # Also, @tabletop.move and @tabletop.move? together
+  # should be synchronized if multithreaded where > 1
+  # Robot are on a Tabletop.
+  # 
+  # Return #report after call, whether it was successful
+  # or not (assuming it _is_ in fact placed on a board).
+  #
+  def move
+    @tabletop.move(self, direction) if @tabletop.move?(self, direction)
+    report
+  end
+
+private
+
+  def dir_idx
+    VALID_DIRECTIONS.index(@direction)
+  end
+
+end
+end