battlesnake 0.1.1 → 0.1.3

data/docs/Battlesnake/Location.html

@@ -69,11 +69,13 @@
   <dl>
     <dt>Inherits:</dt>
     <dd>
-      <span class="inheritName">Object</span>
+      <span class="inheritName"><span class='object_link'><a href="Base.html" title="Battlesnake::Base (class)">Base</a></span></span>
       
         <ul class="fullTree">
           <li>Object</li>
           
+            <li class="next"><span class='object_link'><a href="Base.html" title="Battlesnake::Base (class)">Base</a></span></li>
+          
             <li class="next">Battlesnake::Location</li>
           
         </ul>
@@ -369,6 +371,17 @@
     </ul>
   
 
+
+  
+  
+  
+  
+  
+  
+  
+  
+  <h3 class="inherited">Methods inherited from <span class='object_link'><a href="Base.html" title="Battlesnake::Base (class)">Base</a></span></h3>
+  <p class="inherited"><span class='object_link'><a href="Base.html#==-instance_method" title="Battlesnake::Base#== (method)">#==</a></span></p>
 <div id="constructor_details" class="method_details_list">
   <h2>Constructor Details</h2>
   
@@ -995,7 +1008,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  4 19:07:50 2022 by
+  Generated on Mon Nov  7 15:30:13 2022 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.28 (ruby-2.7.2).
 </div>

data/docs/Battlesnake/Snake.html

@@ -69,11 +69,13 @@
   <dl>
     <dt>Inherits:</dt>
     <dd>
-      <span class="inheritName">Object</span>
+      <span class="inheritName"><span class='object_link'><a href="Base.html" title="Battlesnake::Base (class)">Base</a></span></span>
       
         <ul class="fullTree">
           <li>Object</li>
           
+            <li class="next"><span class='object_link'><a href="Base.html" title="Battlesnake::Base (class)">Base</a></span></li>
+          
             <li class="next">Battlesnake::Snake</li>
           
         </ul>
@@ -502,6 +504,17 @@
     </ul>
   
 
+
+  
+  
+  
+  
+  
+  
+  
+  
+  <h3 class="inherited">Methods inherited from <span class='object_link'><a href="Base.html" title="Battlesnake::Base (class)">Base</a></span></h3>
+  <p class="inherited"><span class='object_link'><a href="Base.html#==-instance_method" title="Battlesnake::Base#== (method)">#==</a></span></p>
 <div id="constructor_details" class="method_details_list">
   <h2>Constructor Details</h2>
   
@@ -1339,7 +1352,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  4 19:07:50 2022 by
+  Generated on Mon Nov  7 15:30:13 2022 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.28 (ruby-2.7.2).
 </div>

data/docs/Battlesnake.html

@@ -79,7 +79,7 @@
   <dl>
     <dt>Defined in:</dt>
     <dd>lib/battlesnake.rb<span class="defines">,<br />
-  lib/battlesnake/board.rb,<br /> lib/battlesnake/snake.rb,<br /> lib/battlesnake/version.rb,<br /> lib/battlesnake/location.rb</span>
+  lib/battlesnake/base.rb,<br /> lib/battlesnake/game.rb,<br /> lib/battlesnake/board.rb,<br /> lib/battlesnake/snake.rb,<br /> lib/battlesnake/version.rb,<br /> lib/battlesnake/location.rb</span>
 </dd>
   </dl>
   
@@ -102,7 +102,7 @@
     
   
     
-      <strong class="classes">Classes:</strong> <span class='object_link'><a href="Battlesnake/Board.html" title="Battlesnake::Board (class)">Board</a></span>, <span class='object_link'><a href="Battlesnake/Error.html" title="Battlesnake::Error (class)">Error</a></span>, <span class='object_link'><a href="Battlesnake/Location.html" title="Battlesnake::Location (class)">Location</a></span>, <span class='object_link'><a href="Battlesnake/Snake.html" title="Battlesnake::Snake (class)">Snake</a></span>
+      <strong class="classes">Classes:</strong> <span class='object_link'><a href="Battlesnake/Base.html" title="Battlesnake::Base (class)">Base</a></span>, <span class='object_link'><a href="Battlesnake/Board.html" title="Battlesnake::Board (class)">Board</a></span>, <span class='object_link'><a href="Battlesnake/Error.html" title="Battlesnake::Error (class)">Error</a></span>, <span class='object_link'><a href="Battlesnake/Game.html" title="Battlesnake::Game (class)">Game</a></span>, <span class='object_link'><a href="Battlesnake/Location.html" title="Battlesnake::Location (class)">Location</a></span>, <span class='object_link'><a href="Battlesnake/Snake.html" title="Battlesnake::Snake (class)">Snake</a></span>
     
   
 </p>
@@ -129,7 +129,7 @@
 
 </div>
         </dt>
-        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>0.1.0</span><span class='tstring_end'>&quot;</span></span></pre></dd>
+        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>0.1.2</span><span class='tstring_end'>&quot;</span></span></pre></dd>
       
     </dl>
   
@@ -145,7 +145,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  4 19:07:49 2022 by
+  Generated on Mon Nov  7 15:30:13 2022 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.28 (ruby-2.7.2).
 </div>

data/docs/_index.html

@@ -80,6 +80,13 @@
           <li class="letter">B</li>
           <ul>
             
+              <li>
+                <span class='object_link'><a href="Battlesnake/Base.html" title="Battlesnake::Base (class)">Base</a></span>
+                
+                  <small>(Battlesnake)</small>
+                
+              </li>
+            
               <li>
                 <span class='object_link'><a href="Battlesnake.html" title="Battlesnake (module)">Battlesnake</a></span>
                 
@@ -111,6 +118,21 @@
         </ul>
       
         
+        <ul id="alpha_G" class="alpha">
+          <li class="letter">G</li>
+          <ul>
+            
+              <li>
+                <span class='object_link'><a href="Battlesnake/Game.html" title="Battlesnake::Game (class)">Game</a></span>
+                
+                  <small>(Battlesnake)</small>
+                
+              </li>
+            
+          </ul>
+        </ul>
+      
+        
         <ul id="alpha_L" class="alpha">
           <li class="letter">L</li>
           <ul>
@@ -149,7 +171,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  4 19:07:49 2022 by
+  Generated on Mon Nov  7 15:30:12 2022 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.28 (ruby-2.7.2).
 </div>

data/docs/class_list.html

@@ -43,7 +43,7 @@
 
       <ul id="full_list" class="class">
         <li id="object_" class="odd"><div class="item" style="padding-left:30px"><span class='object_link'><a href="top-level-namespace.html" title="Top Level Namespace (root)">Top Level Namespace</a></span></div></li>
-<li id='object_Battlesnake' class='even'><div class='item' style='padding-left:30px'><a class='toggle'></a> <span class='object_link'><a href="Battlesnake.html" title="Battlesnake (module)">Battlesnake</a></span><small class='search_info'>Top Level Namespace</small></div><ul><li id='object_Battlesnake::Board' class='collapsed odd'><div class='item' style='padding-left:45px'><span class='object_link'><a href="Battlesnake/Board.html" title="Battlesnake::Board (class)">Board</a></span> &lt; Object<small class='search_info'>Battlesnake</small></div></li><li id='object_Battlesnake::Error' class='collapsed even'><div class='item' style='padding-left:45px'><span class='object_link'><a href="Battlesnake/Error.html" title="Battlesnake::Error (class)">Error</a></span> &lt; StandardError<small class='search_info'>Battlesnake</small></div></li><li id='object_Battlesnake::Location' class='collapsed odd'><div class='item' style='padding-left:45px'><span class='object_link'><a href="Battlesnake/Location.html" title="Battlesnake::Location (class)">Location</a></span> &lt; Object<small class='search_info'>Battlesnake</small></div></li><li id='object_Battlesnake::Snake' class='collapsed even'><div class='item' style='padding-left:45px'><span class='object_link'><a href="Battlesnake/Snake.html" title="Battlesnake::Snake (class)">Snake</a></span> &lt; Object<small class='search_info'>Battlesnake</small></div></li></ul></li>
+<li id='object_Battlesnake' class='even'><div class='item' style='padding-left:30px'><a class='toggle'></a> <span class='object_link'><a href="Battlesnake.html" title="Battlesnake (module)">Battlesnake</a></span><small class='search_info'>Top Level Namespace</small></div><ul><li id='object_Battlesnake::Base' class='collapsed odd'><div class='item' style='padding-left:45px'><span class='object_link'><a href="Battlesnake/Base.html" title="Battlesnake::Base (class)">Base</a></span> &lt; Object<small class='search_info'>Battlesnake</small></div></li><li id='object_Battlesnake::Board' class='collapsed even'><div class='item' style='padding-left:45px'><span class='object_link'><a href="Battlesnake/Board.html" title="Battlesnake::Board (class)">Board</a></span> &lt; Base<small class='search_info'>Battlesnake</small></div></li><li id='object_Battlesnake::Error' class='collapsed odd'><div class='item' style='padding-left:45px'><span class='object_link'><a href="Battlesnake/Error.html" title="Battlesnake::Error (class)">Error</a></span> &lt; StandardError<small class='search_info'>Battlesnake</small></div></li><li id='object_Battlesnake::Game' class='collapsed even'><div class='item' style='padding-left:45px'><span class='object_link'><a href="Battlesnake/Game.html" title="Battlesnake::Game (class)">Game</a></span> &lt; Base<small class='search_info'>Battlesnake</small></div></li><li id='object_Battlesnake::Location' class='collapsed odd'><div class='item' style='padding-left:45px'><span class='object_link'><a href="Battlesnake/Location.html" title="Battlesnake::Location (class)">Location</a></span> &lt; Base<small class='search_info'>Battlesnake</small></div></li><li id='object_Battlesnake::Snake' class='collapsed even'><div class='item' style='padding-left:45px'><span class='object_link'><a href="Battlesnake/Snake.html" title="Battlesnake::Snake (class)">Snake</a></span> &lt; Base<small class='search_info'>Battlesnake</small></div></li></ul></li>
 
       </ul>
     </div>

data/docs/file.README.html

@@ -97,7 +97,7 @@
 </div></div>
 
       <div id="footer">
-  Generated on Fri Nov  4 19:07:49 2022 by
+  Generated on Mon Nov  7 15:30:13 2022 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.28 (ruby-2.7.2).
 </div>

data/docs/index.html

@@ -97,7 +97,7 @@
 </div></div>
 
       <div id="footer">
-  Generated on Fri Nov  4 19:07:49 2022 by
+  Generated on Mon Nov  7 15:30:12 2022 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.28 (ruby-2.7.2).
 </div>

data/docs/method_list.html

@@ -46,8 +46,8 @@
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="Battlesnake/Snake.html#as_json-instance_method" title="Battlesnake::Snake#as_json (method)">#as_json</a></span>
-      <small>Battlesnake::Snake</small>
+      <span class='object_link'><a href="Battlesnake/Base.html#==-instance_method" title="Battlesnake::Base#== (method)">#==</a></span>
+      <small>Battlesnake::Base</small>
     </div>
   </li>
   
@@ -60,6 +60,22 @@
   </li>
   
 
+  <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Battlesnake/Game.html#as_json-instance_method" title="Battlesnake::Game#as_json (method)">#as_json</a></span>
+      <small>Battlesnake::Game</small>
+    </div>
+  </li>
+  
+
+  <li class="even ">
+    <div class="item">
+      <span class='object_link'><a href="Battlesnake/Snake.html#as_json-instance_method" title="Battlesnake::Snake#as_json (method)">#as_json</a></span>
+      <small>Battlesnake::Snake</small>
+    </div>
+  </li>
+  
+
   <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Battlesnake/Board.html#as_json-instance_method" title="Battlesnake::Board#as_json (method)">#as_json</a></span>
@@ -68,6 +84,22 @@
   </li>
   
 
+  <li class="even ">
+    <div class="item">
+      <span class='object_link'><a href="Battlesnake/Board.html#available%3F-instance_method" title="Battlesnake::Board#available? (method)">#available?</a></span>
+      <small>Battlesnake::Board</small>
+    </div>
+  </li>
+  
+
+  <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Battlesnake/Board.html#available_directions-instance_method" title="Battlesnake::Board#available_directions (method)">#available_directions</a></span>
+      <small>Battlesnake::Board</small>
+    </div>
+  </li>
+  
+
   <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Battlesnake/Snake.html#body-instance_method" title="Battlesnake::Snake#body (method)">#body</a></span>
@@ -166,13 +198,21 @@
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="Battlesnake/Location.html#initialize-instance_method" title="Battlesnake::Location#initialize (method)">#initialize</a></span>
-      <small>Battlesnake::Location</small>
+      <span class='object_link'><a href="Battlesnake/Game.html#id-instance_method" title="Battlesnake::Game#id (method)">#id</a></span>
+      <small>Battlesnake::Game</small>
     </div>
   </li>
   
 
   <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Battlesnake/Snake.html#initialize-instance_method" title="Battlesnake::Snake#initialize (method)">#initialize</a></span>
+      <small>Battlesnake::Snake</small>
+    </div>
+  </li>
+  
+
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Battlesnake/Board.html#initialize-instance_method" title="Battlesnake::Board#initialize (method)">#initialize</a></span>
       <small>Battlesnake::Board</small>
@@ -180,10 +220,18 @@
   </li>
   
 
+  <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Battlesnake/Location.html#initialize-instance_method" title="Battlesnake::Location#initialize (method)">#initialize</a></span>
+      <small>Battlesnake::Location</small>
+    </div>
+  </li>
+  
+
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="Battlesnake/Snake.html#initialize-instance_method" title="Battlesnake::Snake#initialize (method)">#initialize</a></span>
-      <small>Battlesnake::Snake</small>
+      <span class='object_link'><a href="Battlesnake/Game.html#initialize-instance_method" title="Battlesnake::Game#initialize (method)">#initialize</a></span>
+      <small>Battlesnake::Game</small>
     </div>
   </li>
   
@@ -205,6 +253,14 @@
   
 
   <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Battlesnake/Game.html#map-instance_method" title="Battlesnake::Game#map (method)">#map</a></span>
+      <small>Battlesnake::Game</small>
+    </div>
+  </li>
+  
+
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Battlesnake/Location.html#move-instance_method" title="Battlesnake::Location#move (method)">#move</a></span>
       <small>Battlesnake::Location</small>
@@ -212,7 +268,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Battlesnake/Snake.html#name-instance_method" title="Battlesnake::Snake#name (method)">#name</a></span>
       <small>Battlesnake::Snake</small>
@@ -220,6 +276,46 @@
   </li>
   
 
+  <li class="even ">
+    <div class="item">
+      <span class='object_link'><a href="Battlesnake/Board.html#occupied%3F-instance_method" title="Battlesnake::Board#occupied? (method)">#occupied?</a></span>
+      <small>Battlesnake::Board</small>
+    </div>
+  </li>
+  
+
+  <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Battlesnake/Board.html#occupied_locations-instance_method" title="Battlesnake::Board#occupied_locations (method)">#occupied_locations</a></span>
+      <small>Battlesnake::Board</small>
+    </div>
+  </li>
+  
+
+  <li class="even ">
+    <div class="item">
+      <span class='object_link'><a href="Battlesnake/Board.html#on_board%3F-instance_method" title="Battlesnake::Board#on_board? (method)">#on_board?</a></span>
+      <small>Battlesnake::Board</small>
+    </div>
+  </li>
+  
+
+  <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Battlesnake/Board.html#paths-instance_method" title="Battlesnake::Board#paths (method)">#paths</a></span>
+      <small>Battlesnake::Board</small>
+    </div>
+  </li>
+  
+
+  <li class="even ">
+    <div class="item">
+      <span class='object_link'><a href="Battlesnake/Game.html#ruleset-instance_method" title="Battlesnake::Game#ruleset (method)">#ruleset</a></span>
+      <small>Battlesnake::Game</small>
+    </div>
+  </li>
+  
+
   <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Battlesnake/Snake.html#shout-instance_method" title="Battlesnake::Snake#shout (method)">#shout</a></span>
@@ -237,6 +333,14 @@
   
 
   <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Battlesnake/Game.html#source-instance_method" title="Battlesnake::Game#source (method)">#source</a></span>
+      <small>Battlesnake::Game</small>
+    </div>
+  </li>
+  
+
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Battlesnake/Snake.html#squad-instance_method" title="Battlesnake::Snake#squad (method)">#squad</a></span>
       <small>Battlesnake::Snake</small>
@@ -244,6 +348,14 @@
   </li>
   
 
+  <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Battlesnake/Game.html#timeout-instance_method" title="Battlesnake::Game#timeout (method)">#timeout</a></span>
+      <small>Battlesnake::Game</small>
+    </div>
+  </li>
+  
+
   <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Battlesnake/Board.html#width-instance_method" title="Battlesnake::Board#width (method)">#width</a></span>

data/docs/top-level-namespace.html

@@ -100,7 +100,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Nov  4 19:07:49 2022 by
+  Generated on Mon Nov  7 15:30:13 2022 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.28 (ruby-2.7.2).
 </div>

data/lib/battlesnake/base.rb

@@ -0,0 +1,15 @@
+module Battlesnake
+  ##
+  # Base class for "model" classes - _Game, Board, Snake, Location,_ etc.
+  class Base
+    ##
+    # Whether both locations have the same coordinates.
+    #
+    # @param other [Location]
+    #
+    # @return [Boolean] true if location objects have the same coordinates.
+    def ==(other)
+      other.is_a?(self.class) && self.as_json == other.as_json
+    end
+  end
+end

data/lib/battlesnake/board.rb

@@ -3,7 +3,7 @@ require 'json'
 module Battlesnake
   ##
   # Represents a single iteration (turn) of a Battlesnake board during gameplay.
-  class Board
+  class Board < Base
     # @return [Hash] board as a data structure usable by other objects.
     attr_reader :as_json
 
@@ -39,5 +39,180 @@ module Battlesnake
       @food = data['food'].map{ |attrs| Location.new(attrs) }
       @hazards = data['hazards'].map{ |attrs| Location.new(attrs) }
     end
+
+    ##
+    # List of all occupied locations on the board; snakes, food, hazards, etc
+    #
+    # @return [Array<Location>] list of occupied locations
+    def occupied_locations
+      return @occupied_locations if defined?(@occupied_locations)
+      @occupied_locations = snakes.map(&:body).flatten + food + hazards
+    end
+
+    ##
+    # Whether the supplied location is occupied.
+    #
+    # @param [Location] location being checked for occupancy.
+    #
+    # @return [Boolean] true if location is occupied by snakes, food, hazards, etc.
+    def occupied?(location)
+      occupied_locations.include?(location)
+    end
+
+    ##
+    # Where the supplied location falls within the boundaries of the board.
+    #
+    # @param [Location] location being tested.
+    #
+    # @return [Boolean] true if location is within the boundaries of the board.
+    def on_board?(location)
+      location.x >= 0 && location.y >= 0 && location.x < width && location.y < height
+    end
+
+    ##
+    # Whether the supplied location is available (unoccupied).
+    #
+    # @param [Location] location being tested for availability.
+    #
+    # @return [Boolean] true if location is available (unoccupied by snakes, food, hazards, etc).
+    def available?(location)
+      on_board?(location) && !occupied?(location)
+    end
+
+    ##
+    # List of directions (up, down, left, right) available for moving from given _Location_.
+    #
+    # @param [Location] location from which moving is desired.
+    #
+    # @return [Array<String>] list of direction strings ("up", "down", "left", "right")
+    def available_directions(location)
+      Location::DIRECTIONS.select do |direction|
+        available?(location.move(direction))
+      end
+    end
+
+    ##
+    # List of valid, consecutive paths from one location to the next. Paths may not:
+    #
+    #  - wander outside board boundaries.
+    #  - use the same location more than once.
+    #  - contain occupied locations, EXCEPT the start/end locations.
+    #
+    # The exception for start/end locations allows us to generate paths, for example, from a snake
+    # to a food location, without having to calulate the starting/ending permutations ourselves.
+    #
+    # @param from [Location] starting location, may be occupied
+    # @param to   [Location] starting location, may be occupied
+    #
+    # @return [Array<Path>] a list of paths, which themselves are lists of consecutive, valid locations.
+    def find_path(from, to, max_distance: nil)
+      @paths = []
+      @ideal_path_size = from.distance(to) + 1
+      @shortest_path_size = max_distance || @ideal_path_size
+      @ideal_path_size_found = false
+
+      recursive_paths(from, to, [from])
+
+      @paths.select{ |path| path.size == @shortest_path_size }.first
+    end
+
+    def recursive_paths(from, to, path)
+      head = path.last
+
+      # give up if path is too long already.
+      return [] if path.size > @shortest_path_size || @ideal_path_size_found
+
+      # if we've made it to "to", we have a successful candidate path.
+      if head.as_json == to.as_json
+        @paths << path
+        @shortest_path_size = [@shortest_path_size, path.size].min
+        @ideal_path_size_found = true if path.size == @ideal_path_size
+
+        return path
+      end
+
+      available_directions(head).sort_by do |direction|
+        # prefer to continue in same direction
+        neck = path[-2]
+
+        if neck && neck.direction(head) == direction
+          0
+        else
+          rand
+        end
+      end.map do |direction|
+        # convert direction string to a location
+        head.move(direction)
+      end.map do |location|
+        # convert location to a full path
+        path + [location]
+      end.select do |candidate|
+        # don't allow paths that overlap themselves
+        candidate.size == candidate.uniq(&:as_json).size
+      end.each do |candidate|
+        # recurse into remaining candidate paths
+        recursive_paths(from, to, candidate)
+      end
+    end
+
+    def shorty(location)
+      "#{location.x}:#{location.y}"
+    end
+
+    def shorties(list)
+      case list.first
+      when Array
+        list.map{ |l| shorties(l) }
+      when Location
+        list.map{|x| shorty(x)}.join(' ')
+      end
+    end
+
+    def print_grid(path, prefix: '  ')
+      max_x = path.map(&:x).max
+      max_y = path.map(&:y).max
+
+      (0..max_y).each do |row|
+        y = max_y - row
+
+        cols = (0..max_x).map do |x|
+          loc = Location.new(x, y)
+
+          if path.include?(loc)
+            after = path.index{ |l| l.as_json == loc.as_json} + 1
+
+            if after >= path.size
+              "\u00d7"
+            elsif loc.as_json == path.first.as_json
+              case loc.direction(path[after])
+              when 'up'
+                "\u21a5"
+              when 'down'
+                "\u21a7"
+              when 'left'
+                "\u21a4"
+              when 'right'
+                "\u21a6"
+              end
+            else
+              case loc.direction(path[after])
+              when 'up'
+                "\u2191"
+              when 'down'
+                "\u2193"
+              when 'left'
+                "\u2190"
+              when 'right'
+                "\u2192"
+              end
+            end
+          else
+            'O'
+          end
+        end.join(' ')
+
+        puts "#{prefix}  #{cols}"
+      end
+    end
   end
 end

data/lib/battlesnake/game.rb

@@ -0,0 +1,44 @@
+require 'json'
+
+module Battlesnake
+  ##
+  # Represents a Battlesnake game.
+  class Game < Base
+    # @return [Hash] snake as a data structure usable by other objects.
+    attr_reader :as_json
+
+    # @return [String] unique identifier for this game.
+    attr_reader :id
+
+    # @return [Hash] information about the ruleset being used to run this game.
+    attr_reader :ruleset
+
+    # @return [String] name of the map used to populate the game board with snakes, food, and hazards.
+    attr_reader :map
+
+    # @return [Integer] how much time player APIs have to respond to requests for this game.
+    attr_reader :timeout
+
+    # @return [String] source of this game.
+    attr_reader :source
+
+    ##
+    # Returns a new instance of Game.
+    #
+    # @param json_or_hash [String,Hash] can be a hash of attributes, or a JSON string which
+    #   represents such a structure.
+    #
+    # @return [Game]
+    def initialize(json_or_hash)
+      data = json_or_hash.is_a?(String) ? JSON.parse(json_or_hash) : json_or_hash
+
+      @as_json = data
+
+      @id = data['id']
+      @ruleset = data['ruleset']
+      @map = data['map']
+      @timeout = data['timeout']
+      @source = data['source']
+    end
+  end
+end