mlb_api/requests/stats/
mod.rs

1//! # The Stats API
2//!
3//! The second most likely reason you're here.
4//!
5//! [`mlb_api`](crate)'s stats system designed to be simple to use.
6//! Create a stats type, then create the hydrations which have stats in it, then request it.
7//!
8//! Almost all the types here are for private use and occasionally might be
9//!
10//! ## Examples
11//! See [`stats_hydrations!`](crate::stats_hydrations) for examples on how to use the macro.
12//!
13//! ## Notes
14//! 1. The stat type registry is admittedly incomplete, only some stat types are implemented (see [`stat_types`]), more will come in the future.
15//! 2. Some stats are only implemented for specific [`StatGroup`](crate::meta::StatGroup)s, if you have a complicated request such as:
16//! ```
17//! stats_hydrations! {
18//!     pub struct TechnicalStats {
19//!         [Sabermetrics, Career] + [Hitting, Pitching, Fielding, Catching]
20//!     }
21//! }
22//! ```
23//! `stats.sabermetrics.fielding` and `.catching` will be of type `()`.
24//! 3. It is an intentional decision that [`SituationCode`](crate::meta::SituationCode)s
25//! are not registered in an enum as if new cutting-edge situation-codes come out,
26//! this API being outdated shouldn't limit in that factor.
27
28use serde::de::DeserializeOwned;
29use std::convert::Infallible;
30use std::fmt::Debug;
31
32#[doc(hidden)]
33pub mod macros;
34#[doc(hidden)]
35pub mod raw;
36#[doc(hidden)]
37pub mod wrappers;
38pub mod leaders;
39#[doc(hidden)]
40mod units;
41#[doc(hidden)]
42pub mod parse;
43pub mod derived;
44
45pub use units::*;
46
47#[cfg(test)]
48mod tests;
49
50// pub use derived::*;
51
52pub trait Stat: Debug + Clone + PartialEq + Default {
53	type Split: DeserializeOwned;
54
55	type TryFromSplitError;
56
57	/// # Errors
58	/// See [`Self::TryFromSplitError`]
59	fn from_splits(splits: impl Iterator<Item=Self::Split>) -> Result<Self, Self::TryFromSplitError> where Self: Sized;
60}
61
62/// Represents the types defined in [`raw`], not the wrapped final types. In the serialized format, this represents the `stat` field.
63pub trait RawStat: Debug + DeserializeOwned + Clone + PartialEq {}
64
65impl RawStat for () {}
66impl SingletonSplitStat for () {}
67
68/// Represents types that are made from a single 'split' in the serialized format (able to be deserialized)
69pub trait SingletonSplitStat: Debug + DeserializeOwned + Clone + PartialEq + Default {
70
71}
72
73impl<T: SingletonSplitStat> Stat for T {
74	type Split = Self;
75
76	type TryFromSplitError = &'static str;
77
78	fn from_splits(mut splits: impl Iterator<Item=Self::Split>) -> Result<Self, Self::TryFromSplitError>
79	where
80		Self: Sized
81	{
82		splits.next().ok_or("length of stat splits is not >= 1, cannot convert to unit type.")
83	}
84}
85
86pub trait StatTypeStats {
87	type Hitting: Stat;
88
89	type Pitching: Stat;
90
91	type Fielding: Stat;
92
93	type Catching: Stat;
94}
95
96impl<T: Stat> Stat for Option<T> {
97	type Split = T::Split;
98	type TryFromSplitError = Infallible;
99
100	fn from_splits(splits: impl Iterator<Item=Self::Split>) -> Result<Self, Self::TryFromSplitError>
101	where
102		Self: Sized
103	{
104		Ok(T::from_splits(splits).ok())
105	}
106}
107
108#[doc(hidden)]
109pub mod stat_types {
110	use super::StatTypeStats;
111	use crate::stats::raw::{FieldedMatchup, PitchStat, PlayStat, catching, fielding, hitting, pitching};
112	use crate::stats::wrappers::{AccumulatedVsPlayerMatchup, ByMonth, ByPosition, BySeason, ByWeekday, Career, Map, Map2D, SingleMatchup, WithGame, WithHomeAndAway, WithMonth, WithNone, WithPlayer, WithPositionAndSeason, WithSeason, WithTeam, WithWeekday, WithWinLoss};
113
114	macro_rules! stat_type_stats {
115		($name:ident {
116			$hitting:ty,
117			$pitching:ty,
118			$catching:ty,
119			$fielding:ty $(,)?
120		}) => {
121			$crate::macro_use::pastey::paste! {
122				#[doc(hidden)]
123				pub struct [<__ $name StatTypeStats>];
124
125				impl StatTypeStats for [<__ $name StatTypeStats>] {
126					type Hitting = $hitting;
127					type Pitching = $pitching;
128					type Fielding = $fielding;
129					type Catching = $catching;
130				}
131			}
132		};
133	}
134
135	// NOTES
136	// 1. Make sure all modules are correct, `hitting`, `pitching`, `catching`, then `fielding`.
137
138	stat_type_stats!(Projected { WithPlayer<hitting::__ProjectedStatsData>, WithPlayer<pitching::__ProjectedStatsData>, (), () });
139	stat_type_stats!(YearByYear { Map<WithSeason<hitting::__YearByYearStatsData>, BySeason>, Map<WithSeason<pitching::__YearByYearStatsData>, BySeason>, Map<WithSeason<catching::__YearByYearStatsData>, BySeason>, Map2D<WithPositionAndSeason<fielding::__YearByYearStatsData>, BySeason, ByPosition> });
140	stat_type_stats!(YearByYearAdvanced { Map<WithSeason<hitting::__YearByYearAdvancedStatsData>, BySeason>, Map<WithSeason<pitching::__YearByYearAdvancedStatsData>, BySeason>, (), () });
141	stat_type_stats!(Season { WithSeason<hitting::__SeasonStatsData>, WithSeason<pitching::__SeasonStatsData>, WithSeason<catching::__SeasonStatsData>, Map2D<WithPositionAndSeason<fielding::__SeasonStatsData>, BySeason, ByPosition> });
142	stat_type_stats!(Career { Career<hitting::__CareerStatsData>, Career<pitching::__CareerStatsData>, Career<catching::__CareerStatsData>, Career<fielding::__CareerStatsData> });
143	stat_type_stats!(SeasonAdvanced { WithSeason<hitting::__SeasonAdvancedStatsData>, WithSeason<pitching::__SeasonAdvancedStatsData>, (), () });
144	stat_type_stats!(CareerAdvanced { Career<hitting::__CareerAdvancedStatsData>, Career<pitching::__CareerAdvancedStatsData>, (), () });
145	stat_type_stats!(GameLog { Vec<WithGame<hitting::__GameLogStatsData>>, Vec<WithGame<pitching::__GameLogStatsData>>, Vec<WithGame<catching::__GameLogStatsData>>, Vec<WithGame<fielding::__GameLogStatsData>> });
146	stat_type_stats!(PlayLog { Vec<SingleMatchup<PlayStat>>, Vec<SingleMatchup<PlayStat>>, Vec<SingleMatchup<PlayStat>>, Vec<SingleMatchup<PlayStat>> });
147	stat_type_stats!(PitchLog { Vec<SingleMatchup<PitchStat>>, Vec<SingleMatchup<PitchStat>>, Vec<SingleMatchup<PitchStat>>, Vec<SingleMatchup<PitchStat>> });
148	// 'metricLog'?
149	// 'metricAverages'?
150	// stat_type_stats!(PitchArsenal { Vec<PitchUsage>, Vec<PitchUsage>, (), () }); // has no stat group
151	// 'outsAboveAverage'?
152	stat_type_stats!(ExpectedStatistics { WithPlayer<hitting::__ExpectedStatisticsStatsData>, WithPlayer<pitching::__ExpectedStatisticsStatsData>, (), () });
153	stat_type_stats!(Sabermetrics { WithPlayer<hitting::__SabermetricsStatsData>, WithPlayer<pitching::__SabermetricsStatsData>, (), () });
154	// stat_type_stats!(SprayChart { SprayChart, SprayChart, (), () }); // does not have statGroup on the response
155	// 'tracking'?
156	// stat_type_stats!(VsPlayer { AccumulatedMatchup<VsPlayerHittingStats>, AccumulatedMatchup<VsPlayerPitchingStats>, (), () });
157	// stat_type_stats!(VsPlayerTotal { AccumulatedMatchup<VsPlayerHittingStats>, AccumulatedMatchup<VsPlayerPitchingStats>, (), () });
158	stat_type_stats!(VsPlayer5Y { AccumulatedVsPlayerMatchup<hitting::__VsPlayerStatsData>, AccumulatedVsPlayerMatchup<pitching::__VsPlayerStatsData>, (), () });
159	// stat_type_stats!(VsTeam { Multiple<AccumulatedVsTeamSeasonalPitcherSplit<HittingStats>>, (), (), () });
160	// stat_type_stats!(VsTeam5Y { Multiple<AccumulatedVsTeamSeasonalPitcherSplit<HittingStats>>, (), (), () });
161	// stat_type_stats!(VsTeamTotal { AccumulatedVsTeamTotalMatchup<HittingStats>, (), (), () });
162	stat_type_stats!(LastXGames { WithTeam<hitting::__LastXGamesStatsData>, WithTeam<pitching::__LastXGamesStatsData>, WithTeam<catching::__LastXGamesStatsData>, WithTeam<fielding::__LastXGamesStatsData> });
163	stat_type_stats!(ByDateRange { WithTeam<hitting::__ByDateRangeStatsData>, WithTeam<pitching::__ByDateRangeStatsData>, WithTeam<catching::__ByDateRangeStatsData>, WithTeam<fielding::__ByDateRangeStatsData> });
164	stat_type_stats!(ByDateRangeAdvanced { WithTeam<hitting::__ByDateRangeAdvancedStatsData>, WithTeam<pitching::__ByDateRangeAdvancedStatsData>, WithTeam<catching::__ByDateRangeAdvancedStatsData>, WithTeam<fielding::__ByDateRangeAdvancedStatsData> });
165	stat_type_stats!(ByMonth { Map<WithMonth<hitting::__ByMonthStatsData>, ByMonth>, Map<WithMonth<pitching::__ByMonthStatsData>, ByMonth>, Map<WithMonth<catching::__ByMonthStatsData>, ByMonth>, Map<WithMonth<fielding::__ByMonthStatsData>, ByMonth> });
166	stat_type_stats!(ByDayOfWeek { Map<WithWeekday<hitting::__ByDayOfWeekStatsData>, ByWeekday>, Map<WithWeekday<pitching::__ByDayOfWeekStatsData>, ByWeekday>, Map<WithWeekday<catching::__ByDayOfWeekStatsData>, ByWeekday>, Map<WithWeekday<fielding::__ByDayOfWeekStatsData>, ByWeekday> });
167	stat_type_stats!(HomeAndAway { WithHomeAndAway<hitting::__HomeAndAwayStatsData>, WithHomeAndAway<pitching::__HomeAndAwayStatsData>, WithHomeAndAway<catching::__HomeAndAwayStatsData>, WithHomeAndAway<fielding::__HomeAndAwayStatsData> });
168	stat_type_stats!(WinLoss { WithWinLoss<hitting::__WinLossStatsData>, WithWinLoss<pitching::__WinLossStatsData>, WithWinLoss<catching::__WinLossStatsData>, WithWinLoss<fielding::__WinLossStatsData> });
169	// stat_type_stats!(Rankings { WithPlayerAndTeam<hitting::__RankingsStatsData>, WithPlayerAndTeam<pitching::__RankingsStatsData>, (), () });
170	// stat_type_stats!(RankingsByYear { Map<WithPlayerAndTeam<hitting::__RankingsByYearStatsData>, BySeason>, Map<WithPlayerAndTeam<pitching::__RankingsByYearStatsData>, BySeason>, (), () });
171	// stat_type_stats!(HotColdZones { HittingHotColdZones, PitchingHotColdZones, (), () }); // has no stat group
172	stat_type_stats!(OpponentsFaced { Vec<FieldedMatchup>, Vec<FieldedMatchup>, Vec<FieldedMatchup>, Vec<FieldedMatchup> });
173	stat_type_stats!(StatSplits { WithSeason<hitting::__StatSplitsStatsData>, WithSeason<pitching::__StatSplitsStatsData>, (), () });
174	stat_type_stats!(StatSplitsAdvanced { WithSeason<hitting::__StatSplitsAdvancedStatsData>, WithSeason<pitching::__StatSplitsAdvancedStatsData>, (), () });
175	// stat_type_stats!(AtGameStart { Multiple<WithGame<hitting::AtGameStart>>, Multiple<WithGame<pitching::AtGameStart>>, Multiple<WithGame<catching::AtGameStart>>, Multiple<WithGame<fielding::AtGameStart>> });
176	// 'vsOpponents'?
177	stat_type_stats!(Boxscore { WithNone<hitting::__BoxscoreStatsData>, WithNone<pitching::__BoxscoreStatsData>, (), WithNone<fielding::__BoxscoreStatsData>, });
178}
mlb_api/requests/stats/mod.rs

mlb_api/requests/stats/
mod.rs
