basketball 0.0.18 → 0.0.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: afad5b6023e9b0baf1dc11fe6874d4cc46430c1698aa4e97bf5dc2df8cbb314e
-  data.tar.gz: f98bb161b770d7148c4fb271ab1b58b2347cfe7b85f94acf1fb6332a4517e61b
+  metadata.gz: 6742218e05c042c3cfe5c5ae155b4deaa22a8c1c1aeeac9c3ef2cdb69c38be42
+  data.tar.gz: 3d151a9df301c7160f0e3884ff961a984f64d5071e2081e3e01eddff557069ab
 SHA512:
-  metadata.gz: 439ca00c393c39e8535ffc21b504b66aaf2a987f09e424ba55b8d4d33d740c6ece187e8e2821239b1d2fa7512aa3743e8a8750be9c41d71259a6093eb2bff57a
-  data.tar.gz: 433fbfeaf16e28312b165ff2b293b9a529ea57e95f0e03e4637b730f1dc36c22c095717825da54da6e0549eeccbeedbb999caf7db5afed80e8e439b25a15d2cd
+  metadata.gz: d1a696a182a4b196030c79926591149d864c744fb27eab6c114800ee066f7edfb9cb340efda8ba96a96322d1bbf1dcf452e9777b678a91c71e9c31523743f165
+  data.tar.gz: 4aac8527166debde576f7c91ff7e40aaf7bde42ec33214f96e8f86b66a174d5d8f65db31cca44be04c0c003f1ae631ef0454b8f650ad66957c95eff0b9494133

data/README.md

@@ -19,6 +19,7 @@ Element      | Description
 **Division** | A collection of teams.
 **Draft** | Bounded context (sub-module) dealing with running a round-robin player draft for teams.
 **Exhibition** | Pre-season game which has no impact to team record.
+**Free Agent** | A player who is not signed to any team but is able to be signed.
 **Front Office** | Identifiable as a team, contains logic for how to auto-pick draft selections.  Meant to be subclassed and extended to include more intricate player selection logic as the base will simply randomly select a player.
 **Game** | Matches up a date with two teams (home and away) to represent a coordinatord match-up.
 **League** | Describes a league in terms of structure composed of conferences, divisions, teams, and players.
@@ -62,6 +63,13 @@ The input for the main object `Basketball::Draft::Room` is an array of teams (`B
 * **Basketball::Draft::Room#pick!(player)**: Pick an exact player for the current front office.
 * **Basketball::Draft::Room#sim_rest!**: Simulate the rest of the picks.
 
+### Org Module
+
+The Org module contains all the structural and transactional for the basketball league as a whole. A League can be made up of free agents and conferences, conferences can have divisions, divisions can have teams, and teams can have players.  The main object: `Basketball::Org::League` allows for the control through its API:
+
+* **Basketball::Org::League#sign!**: Sign a player to a team.
+* **Basketball::Org::League#release!**: Release a player from a team and place them in the free agent pool.
+
 ### Season Module
 
 The Season module knows how to execute a calendar of games for a League and generate results. The main object is the `Basketball::Season::Coordinator` class. Once instantiated there are four main methods:

data/lib/basketball/draft/event.rb

@@ -4,21 +4,20 @@ module Basketball
   module Draft
     # Describes what all Room events have to have to be considered an "event".
     class Event < Entity
-      attr_reader :pick, :round, :round_pick, :front_office
+      attr_reader :round, :round_pick, :front_office
 
-      def initialize(front_office:, pick:, round:, round_pick:)
-        super()
+      def initialize(id:, front_office:, round:, round_pick:)
+        super(id)
 
         raise ArgumentError, 'front_office required' unless front_office
 
         @front_office = front_office
-        @pick         = pick.to_i
         @round        = round.to_i
         @round_pick   = round_pick.to_i
       end
 
       def to_s
-        "[#{id}] ##{pick} R:#{round} P:#{round_pick} - #{front_office}"
+        "[#{id}] R:#{round} P:#{round_pick} - #{front_office}"
       end
     end
   end

data/lib/basketball/draft/pick.rb

@@ -6,8 +6,8 @@ module Basketball
     class Pick < Event
       attr_reader :player, :auto
 
-      def initialize(front_office:, player:, pick:, round:, round_pick:, auto: false)
-        super(front_office:, pick:, round:, round_pick:)
+      def initialize(id:, front_office:, player:, round:, round_pick:, auto: false)
+        super(id:, front_office:, round:, round_pick:)
 
         raise ArgumentError, 'player required' unless player
 

data/lib/basketball/draft/room.rb

@@ -148,7 +148,7 @@ module Basketball
       def skip!
         return if done?
 
-        event = Skip.new(front_office:, pick:, round:, round_pick:)
+        event = Skip.new(id: pick, front_office:, round:, round_pick:)
 
         add_event!(event)
 
@@ -159,7 +159,7 @@ module Basketball
         return if done?
 
         player = front_office.pick(assessment)
-        event  = Pick.new(front_office:, pick:, round:, round_pick:, player:, auto: true)
+        event  = Pick.new(id: pick, front_office:, round:, round_pick:, player:, auto: true)
 
         add_event!(event)
 
@@ -183,7 +183,7 @@ module Basketball
       def pick!(player)
         return nil if done?
 
-        event = Pick.new(front_office:, pick:, round:, round_pick:, player:)
+        event = Pick.new(id: pick, front_office:, round:, round_pick:, player:)
 
         add_event!(event)
       end
@@ -199,7 +199,7 @@ module Basketball
         raise EndOfDraftError, "#{total_picks} pick limit reached" if done?
         raise UnknownFrontOfficeError, "#{front_office} doesnt exist" unless front_offices.include?(event.front_office)
         raise EventOutOfOrderError, "#{event.front_office} cant pick right now" if event.front_office != front_office
-        raise EventOutOfOrderError, "#{event} has wrong pick" if event.pick != pick
+        raise EventOutOfOrderError, "#{event} has wrong pick" if event.id != pick
         raise EventOutOfOrderError, "#{event} has wrong round" if event.round != round
         raise EventOutOfOrderError, "#{event} has wrong round_pick" if event.round_pick != round_pick
 

data/lib/basketball/org/league.rb

@@ -13,28 +13,69 @@ module Basketball
       include HasDivisions
 
       class ConferenceAlreadyRegisteredError < StandardError; end
+      class NotSignedError < StandardError; end
 
-      alias signed? player?
+      attr_reader :conferences, :free_agents
 
-      attr_reader :conferences
-
-      def initialize(conferences: [])
+      def initialize(conferences: [], free_agents: [])
         super()
 
         @conferences = []
+        @free_agents = []
 
         conferences.each { |c| register!(c) }
+        free_agents.each { |p| free_agent!(p) }
       end
 
       def to_s
         conferences.map(&:to_s).join("\n")
       end
 
+      def free_agent?(player)
+        free_agents.include?(player)
+      end
+
+      def free_agent!(player)
+        raise ArgumentError, 'player is required' unless player
+        raise PlayerAlreadySignedError, "#{player} already registered" if player?(player)
+
+        @free_agents << player
+
+        self
+      end
+
+      def release!(player)
+        raise ArgumentError, 'player is required' unless player
+        raise NotSignedError, 'player is currently a free agent' if free_agent?(player)
+
+        team = team_for_player(player)
+
+        raise NotSignedError, 'player was not found to be signed by any team' unless team
+
+        team.release!(player)
+
+        free_agents << player
+
+        self
+      end
+
+      def signed?(player)
+        signed_players.include?(player)
+      end
+
+      def signed_players
+        conferences.flat_map(&:players)
+      end
+
       def sign!(player:, team:)
         raise ArgumentError, 'player is required' unless player
         raise ArgumentError, 'team is required' unless team
         raise UnregisteredTeamError, "#{team} not registered" unless team?(team)
-        raise PlayerAlreadySignedError, "#{player} already registered" if player?(player)
+        raise PlayerAlreadySignedError, "#{player} already registered" if signed?(player)
+
+        # If this player was a free agent then make sure we remove them from the free agent pool.
+        # It is OK if they weren't, they can still be directly signed.
+        free_agents.delete(player) if free_agent?(player)
 
         # It is OK to pass in a detached team as long as its equivalent resides in this
         # League's object graph.
@@ -67,7 +108,7 @@ module Basketball
       end
 
       def players
-        conferences.flat_map(&:players)
+        conferences.flat_map(&:players) + free_agents
       end
 
       def conference_for(team)
@@ -93,6 +134,10 @@ module Basketball
       def team_for(id)
         teams.find { |team| team.id == id }
       end
+
+      def team_for_player(player)
+        teams.find { |t| t.signed?(player) }
+      end
     end
   end
 end

data/lib/basketball/org/team.rb

@@ -5,6 +5,8 @@ module Basketball
     # Base class describing a team.  A team here is bare metal and is just described by an ID
     # and a collection of Player objects.
     class Team < Entity
+      class PlayerNotSignedError < StandardError; end
+
       attr_reader :players, :name
 
       def initialize(id:, name: '', players: [])
@@ -26,6 +28,15 @@ module Basketball
         players.include?(player)
       end
 
+      def release!(player)
+        raise ArgumentError, 'player is required' unless player
+        raise PlayerNotSignedError, "#{player} id not signed by #{self}" unless signed?(player)
+
+        players.delete(player)
+
+        self
+      end
+
       def sign!(player)
         raise ArgumentError, 'player is required' unless player
         raise PlayerAlreadySignedError, "#{player} already signed by #{self}" if signed?(player)

data/lib/basketball/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: basketball
 version: !ruby/object:Gem::Version
-  version: 0.0.18
+  version: 0.0.20
 platform: ruby
 authors:
 - Matthew Ruggio
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-06-14 00:00:00.000000000 Z
+date: 2023-06-16 00:00:00.000000000 Z
 dependencies: []
 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,