refactor: migrate game, gamepace, and homerunderby models to Pydantic

Models converted:

game/ (41 classes):
- Game, MetaData, GameData, GameDataGame, GameDatetime, GameStatus
- GameTeams, GameWeather, GameInfo, ReviewInfo, GameReview, GameFlags
- GameProbablePitchers, MoundVisits, LiveData, GameDecisions, GameLeaders
- Plays, Play, PlayAbout, PlayResult, PlayReviewDetails, PlayMatchup
- PlayMatchupSplits, PlayEvent, PlayRunner, RunnerMovement, RunnerDetails
- RunnerCredits, PlayByInning, PlayByInningHits, HitsByTeam, HitCoordinates
- BoxScore, TopPerformer, BoxScoreTeam, BoxScoreTeams, BoxScoreOfficial
- BoxScoreGameStatus, PlayersDictPerson, BoxScoreVL, BoxScoreTeamInfo
- Linescore, LinescoreTeamScoring, LinescoreInning, LinescoreTeams
- LinescoreOffense, LinescoreDefense

gamepace/ (3 classes):
- GamePace, GamePaceData, PrPortalCalculatedFields

homerunderby/ (11 classes):
- HomeRunDerby, Info, EventType, Status, Round, Matchup, Seed
- Hits, HitData, Coordinates, TrajectoryData

Key changes:
- All fields use snake_case with aliases for API compatibility
- Class names standardized to PascalCase (Gamepace -> GamePace, etc.)
- Field validators handle empty dicts from API as None
- Fixed type mismatches: TrajectoryData uses float, Coordinates optional
- Updated mlb_api.py imports and return types
- Updated all related tests to use new class/field names

Author: Mattsface

mlbstatsapi/mlb_api.py

@@ -16,8 +16,8 @@
 from mlbstatsapi.models.seasons import Season
 from mlbstatsapi.models.drafts import Round
 from mlbstatsapi.models.awards import Award
-from mlbstatsapi.models.gamepace import Gamepace
-from mlbstatsapi.models.homerunderby import Homerunderby
+from mlbstatsapi.models.gamepace import GamePace
+from mlbstatsapi.models.homerunderby import HomeRunDerby
 from mlbstatsapi.models.standings import Standings
 
 from .mlb_dataadapter import MlbDataAdapter
@@ -1099,7 +1099,7 @@ def get_game_ids(self, date: str = None,
 
         return game_ids
 
-    def get_gamepace(self, season: str, sport_id=1, **params) -> Union[Gamepace, None]:
+    def get_gamepace(self, season: str, sport_id=1, **params) -> Union[GamePace, None]:
         """
         Get pace of game metrics for specific sport, league or team.
 
@@ -1164,7 +1164,7 @@ def get_gamepace(self, season: str, sport_id=1, **params) -> Union[Gamepace, Non
             or 'leagues' in mlb_data.data and mlb_data.data['leagues']
             or 'sports' in mlb_data.data and mlb_data.data['sports']):
 
-            return Gamepace(**mlb_data.data)
+            return GamePace(**mlb_data.data)
 
     def get_venue(self, venue_id: int, **params) -> Union[Venue, None]:
         """
@@ -2016,7 +2016,7 @@ def get_awards(self, award_id: str, **params) -> List[Award]:
 
         return awards_list
 
-    def get_homerun_derby(self, game_id, **params) -> Union[Homerunderby, None]:
+    def get_homerun_derby(self, game_id, **params) -> Union[HomeRunDerby, None]:
         """
         The homerun derby endpoint on the Stats API allows for users to 
         request information from the MLB database pertaining to the 
@@ -2036,7 +2036,7 @@ def get_homerun_derby(self, game_id, **params) -> Union[Homerunderby, None]:
 
         Returns
         -------
-        Homerunderby object
+        HomeRunDerby object
 
         See Also
         --------
@@ -2049,7 +2049,7 @@ def get_homerun_derby(self, game_id, **params) -> Union[Homerunderby, None]:
             None
 
         if 'status' in mlb_data.data and mlb_data.data['status']:
-            return Homerunderby(**mlb_data.data)
+            return HomeRunDerby(**mlb_data.data)
 
 
     def get_team_stats(self, team_id: int, stats: list, groups: list, **params) -> dict:

mlbstatsapi/models/game/__init__.py

@@ -1,5 +1,52 @@
 from .game import Game
 from .attributes import MetaData
-from .livedata.plays import Plays
-from .livedata.linescore import Linescore
-from .livedata.boxscore import BoxScore
+from .gamedata import (
+    GameData,
+    GameDataGame,
+    GameDatetime,
+    GameStatus,
+    GameTeams,
+    GameWeather,
+    GameInfo,
+    ReviewInfo,
+    GameReview,
+    GameFlags,
+    GameProbablePitchers,
+    MoundVisits,
+)
+from .livedata import (
+    LiveData,
+    GameDecisions,
+    GameLeaders,
+    Plays,
+    Play,
+    PlayAbout,
+    PlayResult,
+    PlayReviewDetails,
+    PlayMatchup,
+    PlayMatchupSplits,
+    PlayEvent,
+    PlayRunner,
+    RunnerMovement,
+    RunnerDetails,
+    RunnerCredits,
+    PlayByInning,
+    PlayByInningHits,
+    HitsByTeam,
+    HitCoordinates,
+    BoxScore,
+    TopPerformer,
+    BoxScoreVL,
+    BoxScoreTeamInfo,
+    BoxScoreGameStatus,
+    PlayersDictPerson,
+    BoxScoreTeam,
+    BoxScoreTeams,
+    BoxScoreOfficial,
+    Linescore,
+    LinescoreTeamScoring,
+    LinescoreInning,
+    LinescoreTeams,
+    LinescoreOffense,
+    LinescoreDefense,
+)

mlbstatsapi/models/game/attributes.py

@@ -1,23 +1,24 @@
 from typing import List
-from dataclasses import dataclass
+from pydantic import Field
+from mlbstatsapi.models.base import MLBBaseModel
 
-@dataclass
-class MetaData:
+
+class MetaData(MLBBaseModel):
     """
-    A class to represent a Game's metaData.
+    A class to represent a Game's metadata.
 
     Attributes
     ----------
     wait : int
-        No idea what this wait signifies
+        Wait value.
     timestamp : str
-        The timeStamp
-    gameevents : List[str]
-        Current game events for this game
-    logicalevents : List[str]
-        Current logical events for this game
+        The timestamp.
+    game_events : List[str]
+        Current game events for this game.
+    logical_events : List[str]
+        Current logical events for this game.
     """
     wait: int
     timestamp: str
-    gameevents: List[str]
-    logicalevents: List[str]
+    game_events: List[str] = Field(alias="gameevents")
+    logical_events: List[str] = Field(alias="logicalevents")

mlbstatsapi/models/game/game.py

@@ -1,48 +1,34 @@
-from typing import Union, Optional
-from dataclasses import dataclass
-
+from pydantic import Field
+from mlbstatsapi.models.base import MLBBaseModel
 from mlbstatsapi.models.game.gamedata import GameData
 from mlbstatsapi.models.game.livedata import LiveData
-
 from .attributes import MetaData
 
 
-@dataclass
-class Game:
+class Game(MLBBaseModel):
     """
     A class to represent a Game.
 
     Attributes
     ----------
-    gamepk : int
-        id number of this game
+    game_pk : int
+        ID number of this game.
     link : str
-        link to the api address for this game
-    copyright : str
-        MLB AM copyright information
+        Link to the API address for this game.
     metadata : MetaData
-        metaData of this game
-    gamedata : GameData
-        gameData of this game
-    livedata : LiveData
-        liveData of this game
-
-    Methods
-    -------
-    id():
-        returns this games id
+        Metadata of this game.
+    game_data : GameData
+        Game data of this game.
+    live_data : LiveData
+        Live data of this game.
     """
-    gamepk: int
+    game_pk: int = Field(alias="gamepk")
     link: str
-    metadata: Union[MetaData, dict]
-    gamedata: Union[GameData, dict]
-    livedata: Union[LiveData, dict]
-
-    def __post_init__(self):
-        self.metadata = MetaData(**self.metadata)
-        self.gamedata = GameData(**self.gamedata)
-        self.livedata = LiveData(**self.livedata)
+    metadata: MetaData
+    game_data: GameData = Field(alias="gamedata")
+    live_data: LiveData = Field(alias="livedata")
 
     @property
-    def id(self):
-        return self.gamepk
+    def id(self) -> int:
+        """Returns this game's ID."""
+        return self.game_pk

mlbstatsapi/models/game/gamedata/__init__.py

@@ -1,2 +1,14 @@
 from .gamedata import GameData
-from .attributes import GameStatus, MoundVisits
+from .attributes import (
+    GameDataGame,
+    GameDatetime,
+    GameStatus,
+    GameTeams,
+    GameWeather,
+    GameInfo,
+    ReviewInfo,
+    GameReview,
+    GameFlags,
+    GameProbablePitchers,
+    MoundVisits,
+)