basketball 0.0.8 → 0.0.10

data/lib/basketball/season/game.rb

@@ -2,30 +2,35 @@
 
 module Basketball
   module Season
+    # Base class describing what all games have in common.
     class Game < ValueObject
-      attr_reader_value :date, :home_team, :away_team
+      value_reader :date, :home_opponent, :away_opponent
 
-      def initialize(date:, home_team:, away_team:)
+      def initialize(date:, home_opponent:, away_opponent:)
         super()
 
         raise ArgumentError, 'date is required'             unless date
-        raise ArgumentError, 'home_team is required'        unless home_team
-        raise ArgumentError, 'away_team is required'        unless away_team
-        raise ArgumentError, 'teams cannot play themselves' if home_team == away_team
+        raise ArgumentError, 'home_opponent is required'    unless home_opponent
+        raise ArgumentError, 'away_opponent is required'    unless away_opponent
+        raise ArgumentError, 'teams cannot play themselves' if home_opponent == away_opponent
 
-        @date      = date
-        @home_team = home_team
-        @away_team = away_team
+        @date          = date
+        @home_opponent = home_opponent
+        @away_opponent = away_opponent
 
         freeze
       end
 
+      def for?(team)
+        teams.include?(team)
+      end
+
       def teams
-        [home_team, away_team]
+        [home_opponent, away_opponent]
       end
 
       def to_s
-        "#{date} - #{away_team} at #{home_team}"
+        "#{date} - #{away_opponent} at #{home_opponent}"
       end
     end
   end

data/lib/basketball/season/matchup.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Basketball
+  module Season
+    # A Matchup is a late materialization of a game.  While a game is a skeleton for a future
+    # matchup, it does not materialize until game time (rosters could change right up until game time).
+    class Matchup
+      class PlayersOnBothTeamsError < StandardError; end
+
+      attr_reader :game, :home_players, :away_players
+
+      def initialize(game:, home_players: [], away_players: [])
+        raise ArgumentError, 'game is required' unless game
+
+        @game         = game
+        @home_players = home_players.uniq
+        @away_players = away_players.uniq
+
+        if home_players.intersect?(away_players)
+          raise PlayersOnBothTeamsError, 'players cannot be on both home and away team'
+        end
+
+        freeze
+      end
+    end
+  end
+end

data/lib/basketball/season/opponent.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Basketball
+  module Season
+    # Represents a team without a roster.  Equal to a team by identity.
+    # A team's roster will not be known until the last minute (when it is game time).
+    class Opponent < Entity
+      def initialize(id:)
+        super(id)
+
+        freeze
+      end
+    end
+  end
+end

data/lib/basketball/season/{season_game.rb → regular.rb}

@@ -2,7 +2,8 @@
 
 module Basketball
   module Season
-    class SeasonGame < Game
+    # A regular season game.
+    class Regular < Game
     end
   end
 end

data/lib/basketball/season/result.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Basketball
+  module Season
+    # Base class describing the end result of a game.  This should/could be sub-classed to include
+    # more sport-specific information.
+    class Result
+      extend Forwardable
+
+      class CannotTieError < StandardError; end
+
+      attr_reader :game, :home_score, :away_score
+
+      def_delegators :game, :date, :home_opponent, :away_opponent, :teams
+
+      def initialize(game:, home_score:, away_score:)
+        raise ArgumentError, 'game is required' unless game
+        raise CannotTieError, "#{game} ended in a tie" if home_score == away_score
+
+        @game       = game
+        @home_score = home_score.to_i
+        @away_score = away_score.to_i
+      end
+
+      def to_s
+        "#{game.date} - #{away_opponent} (#{away_score}) at #{home_opponent} (#{home_score})"
+      end
+
+      def ==(other)
+        game == other.game &&
+          home_score == other.home_score &&
+          away_score == other.away_score
+      end
+      alias eql? ==
+    end
+  end
+end

data/lib/basketball/season.rb

@@ -1,17 +1,16 @@
 # frozen_string_literal: true
 
-require_relative 'season/scheduling_cli'
+# Common
+require_relative 'season/arena'
+require_relative 'season/calendar'
+require_relative 'season/result'
+require_relative 'season/game'
+require_relative 'season/matchup'
+require_relative 'season/opponent'
 
-module Basketball
-  module Season
-    class ConferenceAlreadyRegisteredError < StandardError; end
-    class DivisionAlreadyRegisteredError < StandardError; end
-    class TeamAlreadyRegisteredError < StandardError; end
+# Game Subclasses
+require_relative 'season/exhibition'
+require_relative 'season/regular'
 
-    class BadConferencesSizeError < StandardError; end
-    class BadDivisionsSizeError < StandardError; end
-    class BadTeamsSizeError < StandardError; end
-
-    class UnknownTeamError < StandardError; end
-  end
-end
+# Specific
+require_relative 'season/coordinator'

data/lib/basketball/value_object.rb

@@ -1,34 +1,15 @@
 # frozen_string_literal: true
 
+require_relative 'value_object_dsl'
+
 module Basketball
+  # A Value Object is something that has no specific identity, instead its identity is the sum of
+  # the attribute values. Changing one will change the entire object's identity.
+  # Comes with a very simple DSL provided by ValueObjectDSL for specifying properties along with
+  # base equality and sorting methods.
   class ValueObject
     include Comparable
-
-    class << self
-      def all_value_keys
-        @all_value_keys ||= ancestors.flat_map do |ancestor|
-          if ancestor < Basketball::ValueObject
-            ancestor.value_keys
-          else
-            []
-          end
-        end.uniq.sort
-      end
-
-      def all_sorted_value_keys
-        all_value_keys.sort
-      end
-
-      def value_keys
-        @value_keys ||= []
-      end
-
-      def attr_reader_value(*keys)
-        keys.each { |k| value_keys << k.to_sym }
-
-        attr_reader(*keys)
-      end
-    end
+    extend ValueObjectDSL
 
     def to_s
       to_h.map { |k, v| "#{k}: #{v}" }.join(', ')
@@ -52,7 +33,7 @@ module Basketball
     alias eql? ==
 
     def hash
-      all_sorted_values.map(&:hash).hash
+      all_sorted_values.hash
     end
 
     def all_sorted_values

data/lib/basketball/value_object_dsl.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Basketball
+  # Class-level methods that extend core Ruby attr_* methods.
+  module ValueObjectDSL
+    def all_value_keys
+      @all_value_keys ||= ancestors.flat_map do |ancestor|
+        if ancestor < Basketball::ValueObject
+          ancestor.value_keys
+        else
+          []
+        end
+      end.uniq.sort
+    end
+
+    def all_sorted_value_keys
+      all_value_keys.sort
+    end
+
+    def value_keys
+      @value_keys ||= []
+    end
+
+    def value_reader(*keys)
+      keys.each { |k| value_keys << k.to_sym }
+
+      attr_reader(*keys)
+    end
+  end
+end

data/lib/basketball/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Basketball
-  VERSION = '0.0.8'
+  VERSION = '0.0.10'
 end

data/lib/basketball.rb

@@ -1,16 +1,21 @@
 # frozen_string_literal: true
 
-require 'faker'
+require 'date'
 require 'fileutils'
 require 'forwardable'
 require 'json'
-require 'securerandom'
 require 'slop'
 
-# Top-level
+# Generic
 require_relative 'basketball/entity'
 require_relative 'basketball/value_object'
 
-# Submodules
+# Dependent on Generic
+require_relative 'basketball/org'
+
+# Dependent on Org
 require_relative 'basketball/draft'
 require_relative 'basketball/season'
+
+# Dependent on All
+require_relative 'basketball/app'

metadata

@@ -1,29 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: basketball
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.10
 platform: ruby
 authors:
 - Matthew Ruggio
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-05-16 00:00:00.000000000 Z
+date: 2023-06-01 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: faker
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.2'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.2'
 - !ruby/object:Gem::Dependency
   name: slop
   requirement: !ruby/object:Gem::Requirement
@@ -38,15 +24,15 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.10'
-description: |2
-      This library is meant to serve as the domain for a basketball league/season simulator/turn-based game.
-      It models core ideas such as: players, general managers, draft strategy, drafting, season generation, season simultation,
-      playoff generation, playoff simulation, and more.
+description: "    This library is meant to serve as the domain for a basketball league/season
+  simulator/turn-based game. It models core ideas such as: players, general managers,
+  draft strategy, drafting, season generation, season simultation, playoff generation,
+  playoff simulation, and more.\n"
 email:
 - mattruggio@icloud.com
 executables:
-- basketball-draft
-- basketball-season-scheduling
+- basketball-coordinator
+- basketball-room
 extensions: []
 extra_rdoc_files: []
 files:
@@ -62,38 +48,45 @@ files:
 - README.md
 - Rakefile
 - basketball.gemspec
-- exe/basketball-draft
-- exe/basketball-season-scheduling
+- exe/basketball-coordinator
+- exe/basketball-room
 - lib/basketball.rb
+- lib/basketball/app.rb
+- lib/basketball/app/coordinator_cli.rb
+- lib/basketball/app/coordinator_repository.rb
+- lib/basketball/app/document_repository.rb
+- lib/basketball/app/file_store.rb
+- lib/basketball/app/in_memory_store.rb
+- lib/basketball/app/league_repository.rb
+- lib/basketball/app/league_serializable.rb
+- lib/basketball/app/room_cli.rb
+- lib/basketball/app/room_repository.rb
 - lib/basketball/draft.rb
-- lib/basketball/draft/cli.rb
+- lib/basketball/draft/assessment.rb
 - lib/basketball/draft/event.rb
 - lib/basketball/draft/front_office.rb
-- lib/basketball/draft/league.rb
-- lib/basketball/draft/pick_event.rb
-- lib/basketball/draft/player.rb
-- lib/basketball/draft/player_search.rb
-- lib/basketball/draft/position.rb
+- lib/basketball/draft/pick.rb
 - lib/basketball/draft/room.rb
-- lib/basketball/draft/room_serializer.rb
-- lib/basketball/draft/roster.rb
-- lib/basketball/draft/sim_event.rb
-- lib/basketball/draft/skip_event.rb
+- lib/basketball/draft/scout.rb
+- lib/basketball/draft/skip.rb
 - lib/basketball/entity.rb
+- lib/basketball/org.rb
+- lib/basketball/org/league.rb
+- lib/basketball/org/player.rb
+- lib/basketball/org/position.rb
+- lib/basketball/org/team.rb
 - lib/basketball/season.rb
+- lib/basketball/season/arena.rb
 - lib/basketball/season/calendar.rb
-- lib/basketball/season/calendar_serializer.rb
-- lib/basketball/season/conference.rb
 - lib/basketball/season/coordinator.rb
-- lib/basketball/season/division.rb
+- lib/basketball/season/exhibition.rb
 - lib/basketball/season/game.rb
-- lib/basketball/season/league.rb
-- lib/basketball/season/league_serializer.rb
-- lib/basketball/season/preseason_game.rb
-- lib/basketball/season/scheduling_cli.rb
-- lib/basketball/season/season_game.rb
-- lib/basketball/season/team.rb
+- lib/basketball/season/matchup.rb
+- lib/basketball/season/opponent.rb
+- lib/basketball/season/regular.rb
+- lib/basketball/season/result.rb
 - lib/basketball/value_object.rb
+- lib/basketball/value_object_dsl.rb
 - lib/basketball/version.rb
 homepage: https://github.com/mattruggio/basketball
 licenses:
@@ -123,5 +116,5 @@ requirements: []
 rubygems_version: 3.4.6
 signing_key:
 specification_version: 4
-summary: Basketball League Game Room
+summary: Basketball Simulation Domain Model
 test_files: []

data/lib/basketball/draft/league.rb

@@ -1,70 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'roster'
-
-module Basketball
-  module Draft
-    class League
-      class RosterNotFoundError < StandardError; end
-      class RosterAlreadyAddedError < StandardError; end
-
-      attr_reader :free_agents, :rosters
-
-      def initialize(free_agents: [], front_offices: [])
-        @rosters     = []
-        @free_agents = []
-
-        front_offices.each { |front_office| add_roster(front_office) }
-        free_agents.each   { |p| register!(player: p) }
-
-        freeze
-      end
-
-      def roster(front_office)
-        rosters.find { |r| r == front_office }
-      end
-
-      def register!(player:, front_office: nil)
-        raise PlayerRequiredError, 'player is required' unless player
-
-        rosters.each do |roster|
-          if roster.registered?(player)
-            raise PlayerAlreadyRegisteredError,
-                  "#{player} already registered to: #{roster.id}"
-          end
-        end
-
-        if free_agents.include?(player)
-          raise PlayerAlreadyRegisteredError,
-                "#{player} already registered as a free agent"
-        end
-
-        if front_office
-          roster = roster(front_office)
-
-          raise RosterNotFoundError, "Roster not found for: #{front_office}" unless roster
-
-          roster.sign!(player)
-        else
-          free_agents << player
-        end
-
-        self
-      end
-
-      def to_s
-        (['League'] + rosters.map(&:to_s)).join("\n")
-      end
-
-      private
-
-      def add_roster(front_office)
-        raise RosterAlreadyAddedError, "#{front_office} already added" if rosters.include?(front_office)
-
-        rosters << Roster.new(id: front_office.id, name: front_office.name)
-
-        self
-      end
-    end
-  end
-end

data/lib/basketball/draft/player.rb

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-
-module Basketball
-  module Draft
-    class Player < Entity
-      STAR_THRESHOLD         = 75
-      OVERALL_STAR_INDICATOR = '⭐'
-
-      private_constant :STAR_THRESHOLD, :OVERALL_STAR_INDICATOR
-
-      attr_reader :first_name, :last_name, :position, :overall
-
-      def initialize(id:, position:, first_name: '', last_name: '', overall: 0)
-        super(id)
-
-        raise ArgumentError, 'position is required' unless position
-
-        @first_name = first_name.to_s
-        @last_name  = last_name.to_s
-        @position   = position
-        @overall    = overall.to_i
-
-        freeze
-      end
-
-      def full_name
-        "#{first_name.strip} #{last_name.strip}".strip
-      end
-
-      def to_s
-        "[#{super}] #{full_name} (#{position}) #{overall} #{star_indicators.join(', ')}".strip
-      end
-
-      private
-
-      def star_indicators
-        [].tap do |indicators|
-          indicators << OVERALL_STAR_INDICATOR if overall >= STAR_THRESHOLD
-        end
-      end
-    end
-  end
-end