mlb-api 1.0.3

Endpoints for MLB's public Statcast API.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

//! Returns a list of alumni associated with a team; [`PeopleResponse`].

use crate::person::PeopleResponse;
use crate::season::SeasonId;
use crate::team::TeamId;
use crate::request::RequestURL;
use bon::Builder;
use std::fmt::{Display, Formatter};
use crate::person::PersonHydrations;

#[derive(Builder)]
#[builder(derive(Into))]
pub struct AlumniRequest<H: PersonHydrations = ()> {
	#[builder(into)]
	team_id: TeamId,
	#[builder(into)]
	season: Option<SeasonId>,
	#[builder(into)]
	hydrations: H::RequestData,
}

impl AlumniRequest {
	pub fn for_team(team_id: impl Into<TeamId>) -> AlumniRequestBuilder<(), alumni_request_builder::SetHydrations<alumni_request_builder::SetTeamId>> {
		Self::builder()
			.team_id(team_id.into())
			.hydrations(())
	}
}

impl<S: alumni_request_builder::State + alumni_request_builder::IsComplete, H: PersonHydrations> crate::request::RequestURLBuilderExt for AlumniRequestBuilder<H, S> {
	type Built = AlumniRequest<H>;
}

impl<H: PersonHydrations> Display for AlumniRequest<H> {
	fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
		let hydrations = Some(H::hydration_text(&self.hydrations)).filter(|s| !s.is_empty());
		write!(f, "http://statsapi.mlb.com/api/v1/teams/{}/alumni{}", self.team_id, gen_params! { "season"?: self.season, "hydrate"?: hydrations })
	}
}

impl<H: PersonHydrations> RequestURL for AlumniRequest<H> {
	type Response = PeopleResponse<H>;
}

#[cfg(test)]
mod tests {
	use crate::request::RequestURLBuilderExt;
	use crate::team::alumni::AlumniRequest;
	use crate::team::TeamsRequest;
	use crate::TEST_YEAR;

	#[tokio::test]
	#[cfg_attr(not(feature = "_heavy_tests"), ignore)]
	async fn test_heavy() {
		let season = TEST_YEAR;
		let teams = TeamsRequest::mlb_teams().season(season).build_and_get().await.unwrap();
		for team in teams.teams {
			let _ = AlumniRequest::<()>::for_team(team.id).season(season).build_and_get().await.unwrap();
		}
	}
}