basketball 0.0.19 → 0.0.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd49f58b9f207574c1d2d24dfbfbcc95aa19aa1b20dfef193e7ed5f76dc9c40b
-  data.tar.gz: 27b5646e17b6e4e195938b6df2c5aa72afa5cd8d83c19abe9cbbe52d603b6399
+  metadata.gz: 0e5c1826475c5a5d9f7ff227034e533c17998a9dff9a1f71107eed48dd5cf176
+  data.tar.gz: edd7a5e117b6f5f17288220f788dc0c4f8a23f69d095d354521ed3834b1c3261
 SHA512:
-  metadata.gz: '09133208c27fa5edf1667a669178703ce702a3b9f20a2d0bb5006dc4ba3260b9b9ccd51db7bbc53cf61d2df12806fd0241ca6cb8ede153ca3af2782c30eeddf9'
-  data.tar.gz: 1e82cd3b7057c8e2ce63a1df77a4ecd4ea7ab8c64275db9d70c1e40d2f006b9b1e128d2a92311b3f3c3f99e35d5507f81ad8c5faec385906814ea53d32ce6583
+  metadata.gz: 76d04eb4fded2ca78f37f6b19cbed042beb8f206470e065bbe314a9cf67d2976a3283fab12c9de3f3932226098180bec18fb600c6cdab18fac030f75e3bf7687
+  data.tar.gz: 51069a1317e825eda9adfd980448651dc6e8f415b94e70709b4f9bea4c7f3a6569206d8b42fd32c55b6e9261973b47c7e735f3a3d651bdaace110fa2772c2cf9

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/front_office.rb

@@ -16,16 +16,18 @@ module Basketball
 
       private_constant :DEFAULT_MAX_STAR_LEVEL, :DEFAULT_MAX_RISK_LEVEL, :MAX_POSITIONS
 
-      attr_reader :prioritized_positions, :risk_level, :star_level, :scout
+      attr_reader :name, :prioritized_positions, :risk_level, :star_level, :scout
 
       def initialize(
         id:,
+        name: '',
         prioritized_positions: [],
         risk_level: rand(0..DEFAULT_MAX_RISK_LEVEL),
         star_level: rand(0..DEFAULT_MAX_STAR_LEVEL)
       )
         super(id)
 
+        @name                  = name.to_s
         @risk_level            = risk_level.to_i
         @star_level            = star_level.to_i
         @prioritized_positions = prioritized_positions

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,11 @@ 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
+      class MaxPlayerCountError < StandardError; end
+
+      MAX_PLAYER_COUNT = 18
+
       attr_reader :players, :name
 
       def initialize(id:, name: '', players: [])
@@ -26,10 +31,23 @@ 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)
 
+        if (players.length + 1) >= MAX_PLAYER_COUNT
+          raise MaxPlayerCountError, "max player count reached: #{MAX_PLAYER_COUNT}"
+        end
+
         players << player
 
         self

data/lib/basketball/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: basketball
 version: !ruby/object:Gem::Version
-  version: 0.0.19
+  version: 0.0.21
 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,