board_game_grid 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 30b06334909c284fa4df43311e971bad13b2d4b03ad0c95e09e5f05ec2240d7b
-  data.tar.gz: f9821c6b664ab4eb5cd0c766e2e4b556eab40067517c9fea3abc38bf53d36205
+  metadata.gz: fd36b2b988acedde04d34d32c977268766edbe370565d7e4afc1af072e0bd49d
+  data.tar.gz: e47c5ab5280c737da98d3757ac35864aaab0cb10d435a25ec6e8ee53db11c63d
 SHA512:
-  metadata.gz: c290da6cb71e2ef9b9eb2c841f2e86a6f165ebcf1d9fbc433f40d98f9e2117a4b3f5b1bd4bf47662489fc883a0841b67386d6b85d9eaec9d687b99c920b29cd9
-  data.tar.gz: 7be305c897cfb2290e574a6d403f71c60499f7a6315c015e4a3c1822a1f512ee19443424dde9f3e9569917885434923fc78343ae5abea11300c203b7e8305a01
+  metadata.gz: 7b9d4d05e209bad2899a5b721c457272d23e6a1f6242fa8015c3f7aac4f86bb490de63d195012f42df157d6e35bcf91ac3f8f601006511739c521f34c2e0d1e3
+  data.tar.gz: ecb84eb4ed4e7f076a37aed8203409ee8e5275560d6b5368188ee865bcaa5911c090ae7e6034b54dd44d9ec00e6e595df00597d2471ea547ec959dbdbdbd1a1e

data/lib/board_game_grid/square.rb

@@ -48,6 +48,18 @@ module BoardGameGrid
     # @return [Hash,NilClass] The piece on the square if any.
     attr_accessor :piece
 
+    # A serialized version of the square as a hash
+    #
+    # @return [Hash]
+    def as_json
+      { 
+        id: id, 
+        x: x, 
+        y: y, 
+        piece: piece && piece.as_json
+      }
+    end
+
     # checks if the square matches the attributes passed.
     #
     # @param [Symbol] attribute
@@ -86,6 +98,20 @@ module BoardGameGrid
       !piece
     end
 
+    # Is the square occupied by the specified player?
+    #
+    # @return [Boolean]
+    def occupied_by_player?(player_number)
+      piece && piece.player_number == player_number
+    end
+
+    # Is the square occupied by the specified player?
+    #
+    # @return [Boolean]
+    def occupied_by_opponent?(player_number)
+      piece && piece.player_number != player_number
+    end
+
     # Is the square the same as another one?
     #
     # @return [Boolean]
@@ -100,11 +126,5 @@ module BoardGameGrid
       Point.new(x, y)
     end
 
-    # A serialized version of the square as a hash
-    #
-    # @return [Hash]
-    def as_json
-      { id: id, x: x, y: y, piece: piece }
-    end
   end
 end

data/lib/board_game_grid/square_set.rb

@@ -47,6 +47,13 @@ module BoardGameGrid
     def_delegator :squares, :each
     def_delegator :squares, :empty?
 
+    # serializes the squares as a hash
+    #
+    # @return [Hash]
+    def as_json
+      squares.map(&:as_json)
+    end
+
     # Concat two SquareSets together
     #
     # @param [SquareSet] other
@@ -188,6 +195,35 @@ module BoardGameGrid
       select { |square| square.x == x && square.y == y }.first
     end
 
+    # Find the square with the matching piece identifier
+    #
+    # @param [Fixnum] piece_id
+    #   the unique identifier of the piece.
+    #
+    # @return [Square]
+    # ==== example:
+    #   # Find the square with a piece with id 4
+    #   square_set.find_by_piece_id(4)
+    def find_by_piece_id(piece_id)
+      find { |s| s.piece && s.piece.id == piece_id }
+    end
+
+    # Find all squares in the y direction of square
+    #
+    # @param [Square] square
+    #   the originating square
+    #
+    # @param [Fixnum] direction_y
+    #   the direction, either up (-1) or down (1)
+    #
+    # @return [SquareSet]
+    # ==== Example:
+    #   # Get all squares up from square_a
+    #   square_set.in_direction(square_a, -1)
+    def in_direction(square, direction_y)
+      select { |s| BoardGameGrid::Vector.new(square, s).direction.y == direction_y }
+    end
+
     # Find all squares within distance of square
     #
     # @param [Square] square
@@ -305,6 +341,56 @@ module BoardGameGrid
       select { |square| Vector.new(origin, square).not_orthogonal_or_diagonal? }
     end
 
+    # Takes a player number and returns all squares occupied by the player
+    #
+    # @param [Fixnum] player_number
+    #   the player's number.
+    #
+    # @return [SquareSet]
+    def occupied_by_player(player_number)
+      select { |s| s.occupied_by_player?(player_number) }
+    end
+
+    # Takes a player number and returns all squares occupied by the opponent of the player
+    #
+    # @param [Fixnum] player_number
+    #   the player's number.
+    #
+    # @return [SquareSet]
+    def occupied_by_opponent(player_number)
+      select { |s| s.occupied_by_opponent?(player_number) }
+    end
+
+    # Takes a player number and returns all squares unoccupied or occupied by the opponent of the player
+    #
+    # @param [Fixnum] player_number
+    #   the player's number.
+    #
+    # @return [SquareSet]
+    def unoccupied_or_occupied_by_opponent(player_number)
+      select { |s| s.unoccupied? || s.occupied_by_opponent?(player_number) }
+    end
+
+    # Find all squares occupied by a piece of a particular type
+    #
+    # @param [Class] piece_type
+    #   the class of the piece.
+    #
+    # @return [SquareSet]
+    def occupied_by_piece(piece_type)
+      select { |s| s.piece && s.piece.is_a?(piece_type) }
+    end
+
+    # Find all squares occupied by a piece not of a particular type
+    #
+    # @param [Class] piece_type
+    #   the class of the piece.
+    #
+    # @return [SquareSet]
+    def excluding_piece(piece_type)
+      select { |s| s.piece && !s.piece.is_a?(piece_type) }
+    end
+
     # Find all squares without pieces on them.
     #
     # @return [SquareSet]
@@ -360,12 +446,5 @@ module BoardGameGrid
 
       self.class.new(squares: _squares)
     end
-
-    # serializes the squares as a hash
-    #
-    # @return [Hash]
-    def as_json
-      squares.map(&:as_json)
-    end
   end
 end

data/lib/board_game_grid/version.rb

@@ -1,3 +1,3 @@
 module BoardGameGrid
-  VERSION = "0.1.3"
+  VERSION = "0.1.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: board_game_grid
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Mark Humphreys
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-03-26 00:00:00.000000000 Z
+date: 2020-04-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler