basketball 0.0.19 → 0.0.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd49f58b9f207574c1d2d24dfbfbcc95aa19aa1b20dfef193e7ed5f76dc9c40b
-  data.tar.gz: 27b5646e17b6e4e195938b6df2c5aa72afa5cd8d83c19abe9cbbe52d603b6399
+  metadata.gz: 6742218e05c042c3cfe5c5ae155b4deaa22a8c1c1aeeac9c3ef2cdb69c38be42
+  data.tar.gz: 3d151a9df301c7160f0e3884ff961a984f64d5071e2081e3e01eddff557069ab
 SHA512:
-  metadata.gz: '09133208c27fa5edf1667a669178703ce702a3b9f20a2d0bb5006dc4ba3260b9b9ccd51db7bbc53cf61d2df12806fd0241ca6cb8ede153ca3af2782c30eeddf9'
-  data.tar.gz: 1e82cd3b7057c8e2ce63a1df77a4ecd4ea7ab8c64275db9d70c1e40d2f006b9b1e128d2a92311b3f3c3f99e35d5507f81ad8c5faec385906814ea53d32ce6583
+  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/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.19'
+  VERSION = '0.0.20'
 end

metadata

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