cat-dev 0.0.13

A library for interacting with the CAT-DEV hardware units distributed by Nintendo (i.e. a type of Wii-U DevKits).
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

//! API's for interacting with `/mion/status.cgi`.
//!
//! These APIs allow changing the status of Disc In/Disc Out, etc. You can view
//! the setup page on the actual main page of the MION dashboard.

use crate::{
	errors::NetworkError,
	mion::{
		cgis::{do_simple_request, encode_url_parameters, parse_result_from_body},
		proto::cgis::StatusOperation,
	},
};
use reqwest::{Client, Method};
use std::{fmt::Display, net::Ipv4Addr, ops::Deref};

/// Perform an `eject` event to set the current DISC IN/Eject state for the
/// MION.
///
/// ## Errors
///
/// - If we cannot encode the parameters as a form url encoded.
/// - If we cannot make the HTTP request.
/// - If the server does not respond with a 200.
/// - If we cannot read the body from HTTP.
/// - If we cannot parse the HTML response.
pub async fn set_disc_eject_state(mion_ip: Ipv4Addr, disc_in: bool) -> Result<bool, NetworkError> {
	set_disc_eject_state_with_raw_client(&Client::default(), mion_ip, disc_in).await
}

/// Perform an `eject` event to set the current DISC IN/Eject state for the
/// MION, but with an already existing HTTP Client.
///
/// ## Errors
///
/// - If we cannot encode the parameters as a form url encoded.
/// - If we cannot make the HTTP request.
/// - If the server does not respond with a 200.
/// - If we cannot read the body from HTTP.
/// - If we cannot parse the HTML response.
pub async fn set_disc_eject_state_with_raw_client(
	client: &Client,
	mion_ip: Ipv4Addr,
	disc_in: bool,
) -> Result<bool, NetworkError> {
	let body_as_string = do_raw_status_request(
		client,
		mion_ip,
		&[
			("operation", Into::<&str>::into(StatusOperation::Eject)),
			("disc", if disc_in { "in" } else { "out" }),
			("frommenu", "no"),
		],
	)
	.await?;

	Ok(parse_result_from_body(
		&body_as_string,
		Into::<&str>::into(StatusOperation::Eject),
	)?)
}

/// Perform a raw operation on the MION board's `/mion/status.cgi` page.
///
/// *note: you probably want to call one of the actual methods, as this is
/// basically just a thin wrapper around an HTTP Post Request. Not doing much
/// else more. A lot of it requires that you set things up correctly.*
///
/// ## Errors
///
/// - If we cannot make an HTTP request to the MION Request.
/// - If we fail to encode your parameters into a request body.
pub async fn do_raw_status_request(
	client: &Client,
	mion_ip: Ipv4Addr,
	url_parameters: &[(impl Deref<Target = str>, impl Display)],
) -> Result<String, NetworkError> {
	do_simple_request::<String>(
		client,
		Method::POST,
		format!("http://{mion_ip}/mion/status.cgi"),
		Some(encode_url_parameters(url_parameters)),
		None,
	)
	.await
}