ai_games-four_in_a_row 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 112f56e83bbfff9998c24bdcc5fc2bfb872389a4
+  data.tar.gz: e939277afc1ec3927f1fc41398e93f17ba120264
+SHA512:
+  metadata.gz: 46c9df8a8797ccd1c93a5a77946adb80241739ec96f995d67dee8f057c672b9bfcd618f961e204846709c514eb7e6a39a0f09e399e6361707fa06936c512473b
+  data.tar.gz: c7e60410280b9e3d42ddd2f3a1fa967dc03d5b170f57a3c4b835723eb8c81bf5960b87804bc2b6168c128994adad71d7371a59f88ee31d226842f87952b88477

data/.gitignore

@@ -0,0 +1,147 @@
+# Created by https://www.gitignore.io/api/linux,osx,windows,ruby,rubymine
+
+### Linux ###
+*~
+
+# KDE directory preferences
+.directory
+
+# Linux trash folder which might appear on any partition or disk
+.Trash-*
+
+
+### OSX ###
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+
+### Windows ###
+# Windows image file caches
+Thumbs.db
+ehthumbs.db
+
+# Folder config file
+Desktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk
+
+
+### Ruby ###
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+
+### RubyMine ###
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio
+
+*.iml
+
+## Directory-based project format:
+.idea/
+# if you remove the above rule, at least ignore the following:
+
+# User-specific stuff:
+# .idea/workspace.xml
+# .idea/tasks.xml
+# .idea/dictionaries
+
+# Sensitive or high-churn files:
+# .idea/dataSources.ids
+# .idea/dataSources.xml
+# .idea/sqlDataSources.xml
+# .idea/dynamic.xml
+# .idea/uiDesigner.xml
+
+# Gradle:
+# .idea/gradle.xml
+# .idea/libraries
+
+# Mongo Explorer plugin:
+# .idea/mongoSettings.xml
+
+## File-based project format:
+*.ipr
+*.iws
+
+## Plugin-specific files:
+
+# IntelliJ
+/out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties

data/.rubocop.yml

@@ -0,0 +1,6 @@
+AllCops:
+  Exclude:
+    - 'bin/**/*'
+
+Style/Documentation:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.1.0
+before_install: gem install bundler -v 1.10.6

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,27 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people
+who contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual
+language or imagery, derogatory comments or personal attacks, trolling, public
+or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct. Project maintainers who do not follow the
+Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by opening an issue or contacting one or more of the project
+maintainers.
+
+This Code of Conduct is adapted from the
+[Contributor Covenant](http://contributor-covenant.org), version 1.0.0,
+available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ai_games-four_in_a_row.gemspec
+gemspec
+
+gem 'ai_games-logger', github: 'jdno/ai_games-logger', branch: 'develop'
+gem 'ai_games-parser', github: 'jdno/ai_games-parser', branch: 'develop'

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Jan David Nose
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,42 @@
+# AIGames::FourInARow
+
+Library and starter bot for [The AI Games'] new competition
+[Four in a Row](http://theaigames.com/competitions/four-in-a-row/).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ai_games-four_in_a_row'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ai_games-four_in_a_row
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run
+`rake test` to run the tests. You can also run `bin/console` for an interactive
+prompt that will allow you to experiment.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/jdno/ai_games-four_in_a_row. This project is intended to be a
+safe, welcoming space for collaboration, and contributors are expected to adhere
+to the [Contributor Covenant](contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the
+[MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,10 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task default: :test

data/ai_games-four_in_a_row.gemspec

@@ -0,0 +1,37 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ai_games/four_in_a_row/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'ai_games-four_in_a_row'
+  spec.version       = AIGames::FourInARow::VERSION
+  spec.authors       = ['Jan David Nose']
+  spec.email         = ['jandavid@awesometechnology.de']
+
+  spec.summary       = <<-EOF
+    Framework and starter bot for The AI Games' 'Four in a Row' competition"
+EOF
+  spec.description   = <<-EOF
+This gem provides a framework that can be used to implement a bot for The
+AI Games' competition 'Four in a Row'. It handles the communication with the
+game engine, so that you can focus on your bot.
+  EOF
+  spec.homepage      = 'https://github.com/jdno/ai_games-four_in_a_row'
+  spec.license       = 'MIT'
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'ai_games-logger'
+  spec.add_runtime_dependency 'ai_games-parser'
+
+  spec.add_development_dependency 'bundler', '~> 1.10'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'minitest'
+  spec.add_development_dependency 'rubocop'
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "ai_games/four_in_a_row"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/ai_games/four_in_a_row.rb

@@ -0,0 +1,26 @@
+# Copyright (c) 2015 Jan David Nose
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+require 'ai_games/four_in_a_row/version'
+
+module AIGames
+  module FourInARow
+    # Your code goes here...
+  end
+end

data/lib/ai_games/four_in_a_row/bot.rb

@@ -0,0 +1,55 @@
+# Copyright (c) 2015 Jan David Nose
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+require 'ai_games/four_in_a_row/match'
+
+module AIGames
+  module FourInARow
+    class Bot
+      # Time in milliseconds that the bot has in its time bank
+      attr_accessor :current_time_bank
+
+      # Maximum time in milliseconds that the bot can have in its time bank
+      attr_accessor :maximum_time_bank
+
+      # Time in milliseconds that is added to the bot's time bank each move
+      attr_accessor :time_per_move
+
+      # The match instance
+      attr_reader :match
+
+      # Initializes a new bot.
+      def initialize(match = nil)
+        @match = match || Match.instance
+      end
+
+      # Places a disk. This method MUST return a single integer value, denoting
+      # the column you want to drop a pin in. To customize your bot, overwrite
+      # this method with your own implementation.
+      def place_disc
+        rand(0..match.columns)
+      end
+
+      # Starts this bot.
+      def run
+        @match.parser.run
+      end
+    end
+  end
+end

data/lib/ai_games/four_in_a_row/match.rb

@@ -0,0 +1,71 @@
+# Copyright (c) 2015 Jan David Nose
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+require 'ai_games/four_in_a_row/bot'
+require 'ai_games/four_in_a_row/parser'
+require 'ai_games/four_in_a_row/playing_field'
+require 'singleton'
+
+module AIGames
+  module FourInARow
+    # This class maintains a state of the current match and provides access to
+    # the bots, the playing field and the parser. It implements the singleton
+    # pattern to ensure that only a single instance of the match state exists
+    # at any given time.
+    class Match
+      # This class implements the singleton pattern to ensure that there is only
+      # a single instance passed around the application at any time. This is
+      # important due to the way information is shared between the parser and
+      # the bots.
+      include Singleton
+
+      # A hash mapping the ids to the bots, with bots[0] being nil and bots[1]
+      # and bots[2] containing the two players.
+      attr_reader :bots
+
+      # The player's bot
+      attr_reader :my_bot
+
+      # The enemy's bot
+      attr_reader :enemy_bot
+
+      # The current round
+      attr_accessor :round
+
+      # The instance of the parser
+      attr_reader :parser
+
+      # The instance of the playing field
+      attr_accessor :playing_field
+
+      # Initializes a new match instance. If a custom bot is given, it is used
+      # as the player's bot, else the default bot is used for both the player
+      # and the enemy.
+      def initialize(bot = nil)
+        @bots = {}
+        @bots[0] = nil
+        @my_bot = bot || Bot.new(self)
+        @enemy_bot = Bot.new(self)
+        @parser = Parser.new(self)
+        @round = 0
+        @playing_field = PlayingField.new(6, 7)
+      end
+    end
+  end
+end

data/lib/ai_games/four_in_a_row/parser.rb

@@ -0,0 +1,156 @@
+# Copyright (c) 2015 Jan David Nose
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+require 'ai_games/logger'
+require 'ai_games/parser/abstract_parser'
+
+module AIGames
+  module FourInARow
+    # The parser handles the communication with the game engine. It sets up the
+    # game using the information provided by the engine before the game starts,
+    # and updates the match when new information comes in.
+    class Parser < AIGames::Parser::AbstractParser
+      # The match instance
+      attr_reader :match
+
+      # Initializes the parser with the given match instance.
+      def initialize(match, options = nil)
+        super(options)
+        @match = match
+      end
+
+      # For the methods parsing the input, a few cops have been disabled.
+      # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/LineLength
+
+      # Parses the game engine's commands. This overwrites DefaultParser.parse
+      # with the specific instructions needed for the "Four In A Row"
+      # competition.
+      def parse(command_array)
+        case command_array[0]
+        when 'action'
+          parse_action command_array[2].to_i
+        when 'update'
+          parse_update command_array[2..-1]
+        when 'settings'
+          parse_settings command_array[1..-1]
+        else
+          Logger.warn('Parser.parse : Unknown command ' \
+            "'#{command_array.join ' '}'")
+        end
+      end
+
+      private
+
+      # Parses all commands starting with "action". Right now, this is true only
+      # for a single command. The response to this command is the move the bot
+      # wants to make.
+      def parse_action(time_bank)
+        @match.my_bot.current_time_bank = time_bank
+        "place_disc #{@match.my_bot.place_disk}"
+      end
+
+      # Parses all commands starting with "update". This is either the number of
+      # round, or an update to the playing field.
+      def parse_update(updates_array)
+        case updates_array[0]
+        when 'round'
+          match.round = updates_array[1].to_i
+        when 'field'
+          parse_field updates_array[1]
+        else
+          Logger.warn("Parser.parse_updates : Unknown command 'update game" \
+            "#{updates_array.join ' '}'")
+        end
+      end
+
+      # Parses all commands starting with "settings". These are issued once when
+      # the game starts, and configure the game.
+      def parse_settings(settings_array)
+        case settings_array[0]
+        when 'timebank'
+          parse_time_bank settings_array[1].to_i
+        when 'time_per_move'
+          parse_time_per_move settings_array[1].to_i
+        when 'player_names'
+          # Names are irrelevant, do nothing.
+        when 'your_bot'
+          # Names are irrelevant, do nothing.
+        when 'your_botid'
+          parse_bot_id settings_array[1].to_i
+        when 'field_columns'
+          parse_columns settings_array[1].to_i
+        when 'field_rows'
+          parse_rows settings_array[1].to_i
+        else
+          Logger.warn("Parser.parse_settings : Unknown command 'settings " \
+                          "#{settings_array.join ' '}'")
+        end
+      end
+
+      # rubocop:enable all
+
+      # Parses the updated playing field. The only argument is the new playing
+      # field encoded as a string.
+      def parse_field(field_string)
+        i = 0
+        field_string.split(';').each do |r|
+          j = 0
+          r.split(',').each do |c|
+            match.playing_field[i][j] = match.bots[c.to_i]
+            j += 1
+          end
+          i += 1
+        end
+      end
+
+      # Sets up the bot ids in the beginning of the game.
+      def parse_bot_id(id)
+        match.bots[id] = match.my_bot
+
+        if id == 1
+          match.bots[2] = match.enemy_bot
+        else
+          match.bots[1] = match.enemy_bot
+        end
+      end
+
+      # Sets the playing field's number of columns
+      def parse_columns(columns)
+        match.playing_field.columns = columns
+      end
+
+      # Sets the playing field's number of rows
+      def parse_rows(rows)
+        match.playing_field.rows = rows
+      end
+
+      # Sets the maximum time bank the bots can use
+      def parse_time_bank(time_bank)
+        match.my_bot.maximum_time_bank    = time_bank
+        match.enemy_bot.maximum_time_bank = time_bank
+      end
+
+      # Sets the time that is added with each move
+      def parse_time_per_move(time)
+        match.my_bot.time_per_move    = time
+        match.enemy_bot.time_per_move = time
+      end
+    end
+  end
+end

data/lib/ai_games/four_in_a_row/playing_field.rb

@@ -0,0 +1,68 @@
+# Copyright (c) 2015 Jan David Nose
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+module AIGames
+  module FourInARow
+    # This class represents the playing field of the game. It has a given number
+    # of columns and rows, and each field can either be empty or filled. If a
+    # field is filled, the name of the player whose chip fills the field is
+    # stored in it.
+    class PlayingField
+      # The number of columns of the playing field
+      attr_reader :columns
+
+      # The number of rows of the playing field
+      attr_reader :rows
+
+      # A two-dimensional array containing all the fields of the playing field
+      attr_reader :fields
+
+      # Initialize the playing field with the given number of rows and columns.
+      def initialize(rows = 0, columns = 0)
+        resize_field rows, columns
+      end
+
+      # Shortcut to the field elements, using the playing field itself like the
+      # underlying array structure.
+      def [](index)
+        @fields[index]
+      end
+
+      # Sets number of rows. If the new number of rows is greater than the
+      # current number of rows, the array gets resized.
+      def rows=(rows)
+        resize_field rows, @columns
+      end
+
+      # Sets the number of columns. If the new number of columns is greater than
+      # the current number of columns, the array gets resized.
+      def columns=(columns)
+        resize_field @rows, columns
+      end
+
+      private
+
+      def resize_field(rows, columns)
+        @columns = columns
+        @rows = rows
+        @fields = Array.new(rows) { Array.new(columns) { nil } }
+      end
+    end
+  end
+end

data/lib/ai_games/four_in_a_row/version.rb

@@ -0,0 +1,24 @@
+# Copyright (c) 2015 Jan David Nose
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+module AIGames
+  module FourInARow
+    VERSION = '0.1.0'
+  end
+end

metadata

@@ -0,0 +1,148 @@
+--- !ruby/object:Gem::Specification
+name: ai_games-four_in_a_row
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jan David Nose
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-11-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ai_games-logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ai_games-parser
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |
+  This gem provides a framework that can be used to implement a bot for The
+  AI Games' competition 'Four in a Row'. It handles the communication with the
+  game engine, so that you can focus on your bot.
+email:
+- jandavid@awesometechnology.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- ai_games-four_in_a_row.gemspec
+- bin/console
+- bin/setup
+- lib/ai_games/four_in_a_row.rb
+- lib/ai_games/four_in_a_row/bot.rb
+- lib/ai_games/four_in_a_row/match.rb
+- lib/ai_games/four_in_a_row/parser.rb
+- lib/ai_games/four_in_a_row/playing_field.rb
+- lib/ai_games/four_in_a_row/version.rb
+homepage: https://github.com/jdno/ai_games-four_in_a_row
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: Framework and starter bot for The AI Games' 'Four in a Row' competition"
+test_files: []