bmputil 1.0.0-rc.1

// SPDX-License-Identifier: MIT OR Apache-2.0
// SPDX-FileCopyrightText: 2025 1BitSquared <info@1bitsquared.com>
// SPDX-FileContributor: Writen by Rachel Mant <git@dragonmux.network>

use std::{collections::BTreeMap, path::PathBuf};
use std::str::FromStr;
use std::string::ToString;

use color_eyre::eyre::{eyre, Error, Result};
use reqwest::Url;
use serde::Deserialize;
use serde::de::Visitor;

#[derive(Deserialize)]
#[serde(deny_unknown_fields)]
pub struct Metadata
{
	#[allow(dead_code)]
	#[serde(rename = "$schema")]
	schema: String,
	pub version: usize,
	pub releases: BTreeMap<String, Release>,
}

#[derive(Deserialize)]
#[serde(deny_unknown_fields)]
pub struct Release
{
	#[serde(rename = "includesBMDA")]
	pub includes_bmda: bool,
	pub firmware: BTreeMap<Probe, Firmware>,
	pub bmda: Option<BTreeMap<TargetOS, BMDAArch>>,
}

/// Enumeration of the valid probe platforms
#[derive(PartialEq, PartialOrd, Eq, Ord, Clone, Copy)]
pub enum Probe
{
	_96bCarbon,
	BlackpillF401CC,
	BlackpillF401CE,
	BlackpillF411CE,
	Bluepill,
	CtxLink,
	F072,
	F3,
	F4Discovery,
	HydraBus,
	LaunchpadICDI,
	Native,
	Stlink,
	Stlinkv3,
	Swlink,
}

struct ProbeVisitor;

#[derive(Deserialize)]
pub struct Firmware
{
	#[serde(flatten)]
	pub variants: BTreeMap<String, FirmwareDownload>
}

#[derive(Deserialize)]
#[serde(deny_unknown_fields)]
pub struct FirmwareDownload
{
	#[serde(rename = "friendlyName")]
	pub friendly_name: String,
	#[serde(rename = "fileName")]
	pub file_name: PathBuf,
	pub uri: Url,
}

/// Enumeration of the OSes that BMDA can be officially run on
#[derive(PartialEq, PartialOrd, Eq, Ord, Clone, Copy)]
pub enum TargetOS
{
	Linux,
	MacOS,
	Windows,
}

struct TargetOSVisitor;

#[derive(Deserialize)]
pub struct BMDAArch
{
	#[serde(flatten)]
	pub binaries: BTreeMap<TargetArch, BMDABinary>
}

/// Enumeration of the CPU architectures that BMDA can be officially run on
#[derive(PartialEq, PartialOrd, Eq, Ord, Clone, Copy)]
pub enum TargetArch
{
	I386,
	AMD64,
	AArch32,
	AArch64,
}

struct TargetArchVisitor;

#[derive(Deserialize)]
#[serde(deny_unknown_fields)]
pub struct BMDABinary
{
	/// Name of the file from in the linked archive which should be executed as BMDA
	#[serde(rename = "fileName")]
	pub file_name: PathBuf,
	/// URI of where to go to pull the .zip archive of BMDA and its supporting files
	pub uri: Url,
}

// Map from a string to a Probe value
impl FromStr for Probe
{
	type Err = Error;

	fn from_str(value: &str) -> Result<Self, Self::Err>
	{
		match value {
			"96b_carbon" => Ok(Probe::_96bCarbon),
			"blackpill-f401cc" => Ok(Probe::BlackpillF401CC),
			"blackpill-f401ce" => Ok(Probe::BlackpillF401CE),
			"blackpill-f411ce" => Ok(Probe::BlackpillF411CE),
			"bluepill" => Ok(Probe::Bluepill),
			"ctxlink" => Ok(Probe::CtxLink),
			"f072" => Ok(Probe::F072),
			"f3" => Ok(Probe::F3),
			"f4discovery" => Ok(Probe::F4Discovery),
			"hydrabus" => Ok(Probe::HydraBus),
			"launchpad-icdi" => Ok(Probe::LaunchpadICDI),
			"native" => Ok(Probe::Native),
			"stlink" => Ok(Probe::Stlink),
			"stlinkv3" => Ok(Probe::Stlinkv3),
			"swlink" => Ok(Probe::Swlink),
			&_ => Err(eyre!("Failed to translate invalid probe name {value} to Probe enum"))
		}
	}
}

// Map from a Probe value to a string
impl ToString for Probe
{
	fn to_string(&self) -> String
	{
		match self {
			Probe::_96bCarbon => "96b_carbon",
			Probe::BlackpillF401CC => "blackpill-f401cc",
			Probe::BlackpillF401CE => "blackpill-f401ce",
			Probe::BlackpillF411CE => "blackpill-f411ce",
			Probe::Bluepill => "bluepill",
			Probe::CtxLink => "ctxlink",
			Probe::F072 => "f072",
			Probe::F3 => "f3",
			Probe::F4Discovery => "f4discovery",
			Probe::HydraBus => "hydrabus",
			Probe::LaunchpadICDI => "launchpad-icdi",
			Probe::Native => "native",
			Probe::Stlink => "stlink",
			Probe::Stlinkv3 => "stlinkv3",
			Probe::Swlink => "swlink",
		}.to_string()
	}
}

// serde deserialisation for Probe (has to be custom to get the name mapping right)
impl<'de> Deserialize<'de> for Probe
{
	fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
		where D: serde::Deserializer<'de>
	{
		deserializer.deserialize_str(ProbeVisitor)
	}
}

// serde deserialisation helper for Probe to turn values into the right type
impl<'de> Visitor<'de> for ProbeVisitor
{
	type Value = Probe;

	fn expecting(&self, formatter: &mut std::fmt::Formatter) -> std::fmt::Result
	{
		formatter.write_str("a valid probe platform name")
	}

	fn visit_str<E>(self, value: &str) -> Result<Self::Value, E>
		where E: serde::de::Error,
	{
		Probe::from_str(value)
			.map_err(|e| E::custom(e.to_string()))
	}
}

// Map from a string to a TargetOS value
impl FromStr for TargetOS
{
	type Err = Error;

	fn from_str(value: &str) -> Result<Self, Self::Err>
	{
		match value {
			"linux" => Ok(TargetOS::Linux),
			"macos" => Ok(TargetOS::MacOS),
			"windows" => Ok(TargetOS::Windows),
			&_ => Err(eyre!("Failed to translate invalid operating system name {value} to TargetOS enum"))
		}
	}
}

// Map from a ToString value to a string
impl ToString for TargetOS
{
	fn to_string(&self) -> String
	{
		match self {
			TargetOS::Linux => "Linux",
			TargetOS::MacOS => "macOS",
			TargetOS::Windows => "Windows",
		}.to_string()
	}
}

// serde deserialisation for TargetOS (has to be custom to get the name mapping right)
impl<'de> Deserialize<'de> for TargetOS
{
	fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
		where D: serde::Deserializer<'de>
	{
		deserializer.deserialize_str(TargetOSVisitor)
	}
}

// serde deserialisation helper for TargetOS to turn values into the right type
impl<'de> Visitor<'de> for TargetOSVisitor
{
	type Value = TargetOS;

	fn expecting(&self, formatter: &mut std::fmt::Formatter) -> std::fmt::Result
	{
		formatter.write_str("a valid OS target name")
	}

	fn visit_str<E>(self, value: &str) -> Result<Self::Value, E>
		where E: serde::de::Error,
	{
		TargetOS::from_str(value)
			.map_err(|e| E::custom(e.to_string()))
	}
}

// Map from a string to a TargetOS value
impl FromStr for TargetArch
{
	type Err = Error;

	fn from_str(value: &str) -> Result<Self, Self::Err>
	{
		match value {
			"i386" => Ok(TargetArch::I386),
			"amd64" => Ok(TargetArch::AMD64),
			"aarch32" => Ok(TargetArch::AArch32),
			"aarch64" => Ok(TargetArch::AArch64),
			&_ => Err(eyre!("Failed to translate invalid architecture name {value} to TargetArch enum"))
		}
	}
}

// Map from a ToString value to a string
impl ToString for TargetArch
{
	fn to_string(&self) -> String
	{
		match self {
			TargetArch::I386 => "i386",
			TargetArch::AMD64 => "AMD64",
			TargetArch::AArch32 => "AArch32",
			TargetArch::AArch64 => "AArch64",
		}.to_string()
	}
}

// serde deserialisation for TargetArch (has to be custom to get the name mapping right)
impl<'de> Deserialize<'de> for TargetArch
{
	fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
		where D: serde::Deserializer<'de>
	{
		deserializer.deserialize_str(TargetArchVisitor)
	}
}

// serde deserialisation helper for TargetArch to turn values into the right type
impl<'de> Visitor<'de> for TargetArchVisitor
{
	type Value = TargetArch;

	fn expecting(&self, formatter: &mut std::fmt::Formatter) -> std::fmt::Result
	{
		formatter.write_str("a valid OS target name")
	}

	fn visit_str<E>(self, value: &str) -> Result<Self::Value, E>
		where E: serde::de::Error,
	{
		TargetArch::from_str(value)
			.map_err(|e| E::custom(e.to_string()))
	}
}