Contents

# frozen_string_literal: true

require_relative File.join("qi", "move")

# The Qi abstraction.
#
# @example Apply a move to a classic Shogi problem
#   Qi.call(
#     [43, 13, "+B"],
#     in_hand: %w[S r r b g g g g s n n n n p p p p p p p p p p p p p p p p p],
#     square: {
#        3 => "s",
#        4 => "k",
#        5 => "s",
#       22 => "+P",
#       43 => "+B"
#     }
#   )
#   # => {:in_hand=>["S", "r", "r", "b", "g", "g", "g", "g", "s", "n", "n", "n", "n", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p"], :square=>{3=>"s", 4=>"k", 5=>"s", 22=>"+P", 13=>"+B"}}
module Qi
  # Apply a move to the position.
  #
  # @param move [Array] The move to play.
  # @param in_hand [Array] The list of pieces in hand.
  # @param square [Hash] The index of each piece on the board.
  #
  # @see https://developer.sashite.com/specs/portable-chess-notation
  # @see https://developer.sashite.com/specs/portable-move-notation
  #
  # @example Apply a move to a classic Shogi problem
  #   call(
  #     [43, 13, "+B"],
  #     in_hand: %w[S r r b g g g g s n n n n p p p p p p p p p p p p p p p p p],
  #     square: {
  #        3 => "s",
  #        4 => "k",
  #        5 => "s",
  #       22 => "+P",
  #       43 => "+B"
  #     }
  #   )
  #   # => {:in_hand=>["S", "r", "r", "b", "g", "g", "g", "g", "s", "n", "n", "n", "n", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p", "p"], :square=>{3=>"s", 4=>"k", 5=>"s", 22=>"+P", 13=>"+B"}}
  #
  # @return [Hash] The piece set of the next position.
  def self.call(move, in_hand:, square:)
    Move.new(move).call(in_hand: in_hand, square: square)
  end
end

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
qi-9.0.0.beta2	lib/qi.rb
qi-9.0.0.beta1	lib/qi.rb