pvoutput-client 0.0.3

Client for the PVOutput.org 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

use jiff::civil::Date;
use proptest::property_test;
use rand::{prelude::*, rng};

use crate::{
	Client, ClientError,
	types::{
		error::AddOutputError,
		response::{AggregateDate, Shade},
	},
};

mod parse;

#[test]
#[ignore = "makes a network request"]
fn invalid_credentials() {
	let client = Client::new("invalid", 1, None, None).unwrap();
	let result = tokio::runtime::Builder::new_current_thread()
		.enable_all()
		.build()
		.unwrap()
		.block_on(async { client.get_ladder(None).await });

	assert!(matches!(result, Err(ClientError::InvalidApiKey)));
}

/// WARNING: This test may make a network request.
/// It's not *supposed* to, but if there's a bug in the implementation of [`Client::add_outputs`], it could.
#[test]
fn missing_data() {
	let client = Client::new("invalid", 0, None, None).unwrap();
	let result = tokio::runtime::Builder::new_current_thread()
		.build()
		.unwrap()
		.block_on(async { client.add_outputs(vec![]).await });

	assert!(matches!(result, Err(ClientError::EndpointSpecific(AddOutputError::NoData))));
}

#[test]
fn sort_shade_levels() {
	let sorted = vec![Shade::No, Shade::Low, Shade::Medium, Shade::High];
	let mut levels = sorted.clone();
	levels.shuffle(&mut rng());
	levels.sort();
	assert_eq!(levels, sorted);
}

#[property_test]
#[test]
#[allow(clippy::cast_possible_wrap)]
fn aggregate_date(#[strategy = 0..=9999u16] year: u16, #[strategy = 1..=12u8] month: u8) {
	let date = AggregateDate::Year(year);
	assert_eq!(date.year(), year);
	assert_eq!(date.as_arbitrary_date().unwrap(), Date::new(year as i16, 1, 1).unwrap());

	let date = AggregateDate::YearAndMonth(year, month);
	assert_eq!(date.year(), year);
	assert_eq!(date.as_arbitrary_date().unwrap(), Date::new(year as i16, month as i8, 1).unwrap());
}