tic_tac_toe_master 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 351d57128ecff0b1e7863f2ef9b19deee6682ce88034d37ca1dadc84d221c724
+  data.tar.gz: a5ad2103845661007da9d62b74db2195c2b137ed326dd75e90a9a5b979cd889e
+SHA512:
+  metadata.gz: 0e3901d3c0ddfe7161b359e22cb9fa7a0860a0dcb359e64b6031c3f278eba5e86e6d3eaf02010563215412fac66ecf20b8b399fceb29d5ac0ca4c42040b5e0f4
+  data.tar.gz: 3f8c37708cec0f31dae1b8868ab92e4ad85b5cc24afb7d043c0ee3d5eebc59605c10ea3352cd64eea0dd8f37fbd4753958ac63a0afa8b3d0bb982297f07701cd

data/lib/tic_tac_toe_master/board.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module TicTacToeMaster
+  # Represents the game board for Tic Tac Toe
+  class Board
+    attr_reader :grid
+
+    FIELD_SIZE = (1..9)
+
+    WIN_CONBINATIONS = [
+      [0, 1, 2], [3, 4, 5], [6, 7, 8],
+      [0, 3, 6], [1, 4, 7], [2, 5, 8],
+      [0, 4, 8], [2, 4, 6]
+    ].freeze
+
+    def initialize
+      @grid = FIELD_SIZE.to_a
+    end
+
+    def draw
+      puts '-----------'
+
+      grid.each_slice(3) do |row|
+        puts " #{row.join(' | ')} "
+        puts '-----------'
+      end
+    end
+
+    def place(position, symbol)
+      return false unless valid_position?(position)
+
+      grid[position - 1] = symbol
+      true
+    end
+
+    def valid_position?(position)
+      FIELD_SIZE.cover?(position) && grid[position - 1].is_a?(Integer)
+    end
+
+    def full?
+      grid.none?(Integer)
+    end
+
+    def winner?(symbol)
+      WIN_CONBINATIONS.any? do |combo|
+        combo.all? { |index| grid[index] == symbol }
+      end
+    end
+  end
+end

data/lib/tic_tac_toe_master/game.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module TicTacToeMaster
+  # Controls the main game flow
+  class Game
+    attr_reader :player1, :player2, :current_player, :board
+
+    def initialize(player1_name:, player2_name:)
+      @player1 = Player.new(player1_name, 'X')
+      @player2 = Player.new(player2_name, 'O')
+      @board = Board.new
+      @current_player = @player1
+    end
+
+    # Makes a move for the current player at the given position.
+    # Returns:
+    # :invalid  - if the move is invalid
+    # :win      - if the current player wins
+    # :draw     - if the board is full (draw)
+    # :next_turn - if the game should continue
+    def make_move(position)
+      return :invalid unless board.place(position, current_player.symbol)
+
+      if board.winner?(current_player.symbol)
+        :win
+      elsif board.full?
+        :draw
+      else
+        switch_player
+        :next_turn
+      end
+    end
+
+    private
+
+    def switch_player
+      @current_player = current_player == player1 ? player2 : player1
+    end
+  end
+end

data/lib/tic_tac_toe_master/player.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module TicTacToeMaster
+  # Represents a Player with name and symbol(X or O)
+  class Player
+    attr_reader :name, :symbol
+
+    def initialize(name, symbol)
+      @name = name
+      @symbol = symbol
+    end
+  end
+end

data/lib/tic_tac_toe_master/ui/console_ui.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module TicTacToeMaster
+  module UI
+    # Console interface display option
+    class ConsoleUI
+      def initialize(game)
+        @game = game
+      end
+
+      def start
+        puts '🎮 Welcome to Tic Tac Toe!'
+
+        loop do
+          @game.board.draw
+
+          case @game.make_move(ask_for_move)
+          when :invalid
+            puts '❌ Invalid move, try again.'
+          when :win
+            @game.board.draw
+            puts "🏆 #{@game.current_player.name} wins!"
+            break
+          when :draw
+            @game.board.draw
+            puts "🤝 It's a draw!"
+            break
+          end
+        end
+        puts "\n👋 Game over!"
+      end
+
+      private
+
+      def ask_for_move
+        print "\n#{@game.current_player.name} #{@game.current_player.symbol}, " \
+              "choose a position #{TicTacToeMaster::Board::FIELD_SIZE}: "
+        gets.to_i
+      end
+    end
+  end
+end

data/lib/tic_tac_toe_master/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module TicTacToeMaster
+  VERSION = '0.1.0'
+end

data/lib/tic_tac_toe_master.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require_relative 'tic_tac_toe_master/version'
+require_relative 'tic_tac_toe_master/game'
+require_relative 'tic_tac_toe_master/board'
+require_relative 'tic_tac_toe_master/player'
+require_relative 'tic_tac_toe_master/ui/console_ui'
+
+# Main namespace for TicTacToeMaster gem.
+# Provides an entry point to start the Tic Tac Toe game
+# using different UI implementations (e.g., ConsoleUI, WebUI).
+module TicTacToeMaster
+  class << self
+    # Starts the Tic Tac Toe game.
+    #
+    # Options:
+    # ui_class - the UI class to use (default: UI::ConsoleUI)
+    # player1_name, player2_name - optional names for players
+    #
+    # Examples:
+    #   TicTacToeMaster.start
+    #   TicTacToeMaster.start(ui_class: UI::ConsoleUI, player1_name: 'Alice', player2_name: 'Bob')
+    def start(ui_class: UI::ConsoleUI, player1_name: nil, player2_name: nil)
+      player1_name, player2_name = resolve_player_names(ui_class, player1_name, player2_name)
+
+      game = Game.new(player1_name: player1_name, player2_name: player2_name)
+      ui_class.new(game).start
+    end
+
+    private
+
+    # Determines or asks for player names depending on the UI type.
+    # For ConsoleUI, it prompts for names if not provided.
+    # For other UIs, both names must be passed explicitly.
+    #
+    # Returns an array: [player1_name, player2_name]
+    def resolve_player_names(ui_class, player1_name, player2_name)
+      if ui_class == UI::ConsoleUI
+        player1_name ||= ask_for_name('Player 1 (X)')
+        player2_name ||= ask_for_name('Player 2 (O)')
+      else
+        unless player1_name && player2_name
+          raise ArgumentError, 'player1_name and player2_name are required for non-console UI'
+        end
+      end
+
+      [player1_name, player2_name]
+    end
+
+    # Prompts the user to enter a name for the given player.
+    #
+    # Returns the entered string (stripped of whitespace).
+    def ask_for_name(label)
+      print "Enter name for #{label}: "
+      gets.strip
+    end
+  end
+end

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: tic_tac_toe_master
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Vitalii Matseiko
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-11-11 00:00:00.000000000 Z
+dependencies: []
+description: TicTacToeMaster is a gem that allows you to play Tic Tac Toe in the console.
+email:
+- realnatisk@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/tic_tac_toe_master.rb
+- lib/tic_tac_toe_master/board.rb
+- lib/tic_tac_toe_master/game.rb
+- lib/tic_tac_toe_master/player.rb
+- lib/tic_tac_toe_master/ui/console_ui.rb
+- lib/tic_tac_toe_master/version.rb
+homepage: https://github.com/Natisk/tic_tac_toe_master
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/Natisk/tic_tac_toe_master
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.16
+signing_key:
+specification_version: 4
+summary: A simple Tic Tac Toe game implemented in Ruby.
+test_files: []