// //! # Warning: This library is unstable, only the executable's behaviour is subject to semver

// use std::env;

// use camino::{Utf8Path, Utf8PathBuf};
// use clap::{Args, Parser, Subcommand};
// use color_eyre::{
// 	eyre::{eyre, Context as _, Report},
// 	Section as _,
// };
// use serde::Deserialize;
// use tracing::info;

// #[derive(Parser, Debug)]
// #[command(version, about)]
// #[command(name = "cargo", bin_name = "cargo")]
// pub enum TopLevel {
// 	#[clap(name = "xcode-build-rs")]
// 	XCodeBuild(XcodeBuild),
// }

// impl TopLevel {
// 	fn inner(&self) -> &XcodeBuild {
// 		match self {
// 			TopLevel::XCodeBuild(inner) => inner,
// 		}
// 	}
// }

// #[derive(clap::Args, Debug)]
// #[command(version, about)]
// pub struct XcodeBuild {
// 	#[clap(subcommand)]
// 	mode: Mode,

// 	#[clap(flatten)]
// 	options: Options,
// }

// impl TopLevel {
// 	pub fn options(&self) -> &Options {
// 		&self.inner().options
// 	}

// 	pub fn mode(&self) -> &Mode {
// 		&self.inner().mode
// 	}
// }

// #[derive(Subcommand, Clone, Debug)]
// pub enum Mode {
// 	/// Run in XCode
// 	Xcode,
// 	/// Run a test build for an iOS simulator
// 	Test,
// }

// #[derive(Args, Debug)]
// pub struct Options {
// 	/// By default, doesn't display colour because this can be annoying in the XCode terminal
// 	#[arg(long, alias = "colour")]
// 	pub colour: bool,

// 	/// The --manifest-path option to pass to `cargo rustc builds`.
// 	/// Often you can pass `.`
// 	#[arg(long, alias = "manifest-dir", env = "CARGO_MANIFEST_DIR")]
// 	manifest_dir: Utf8PathBuf,
// }

// impl Options {
// 	/// Specifically to the *file* `Cargo.toml`, *not directory*
// 	pub fn manifest_path(&self) -> Utf8PathBuf {
// 		self.manifest_dir.to_owned().join("Cargo.toml")
// 	}
// }

// #[derive(Deserialize, Debug, Default)]
// pub struct Config {
// 	/// What features to enable for iOS builds
// 	#[serde(default)]
// 	ios: Flags,
// }

// #[derive(Debug, Deserialize, Clone)]
// pub struct Flags {
// 	#[serde(default)]
// 	features: Vec<String>,
// 	/// Whether or not to pass the flag `--no-default-features` to `cargo rustc`
// 	/// See https://doc.rust-lang.org/cargo/reference/features.html#command-line-feature-options
// 	#[serde(default = "Flags::default_default_features")]
// 	default_features: bool,
// }

// impl Flags {
// 	/// Default for [Self::default_features]
// 	fn default_default_features() -> bool {
// 		true
// 	}
// }

// impl Default for Flags {
// 	fn default() -> Self {
// 		Flags {
// 			default_features: Flags::default_default_features(),
// 			features: vec![],
// 		}
// 	}
// }

// impl Config {
// 	pub fn retrieve_from_toml_config(manifest_path: &Utf8Path) -> Result<Config, Report> {
// 		match std::fs::read_to_string(manifest_path) {
// 			Err(err) => {
// 				info!(
// 					message = "Cannot find `Cargo.toml` file in manifest_dir, using default config",
// 					?err,
// 					?manifest_path
// 				);
// 				Ok(Config::default())
// 			}
// 			Ok(config) => {
// 				let raw_config: toml::Value = toml::from_str(&config)
// 					.wrap_err_with(|| format!("Cannot parse Cargo.toml file: {:?}", manifest_path))?;
// 				let config = raw_config
// 					.get("package")
// 					.and_then(|package| package.get("metadata"))
// 					.and_then(|metadata| metadata.get("xcode-build-rs"));
// 				match config {
// 					None => {
// 						info!("Using default config since `package.metadata.xcode_build_rs` section is missing from Cargo.toml");
// 						Ok(Config::default())
// 					}
// 					Some(config) => {
// 						let config: Config = config
// 							.clone()
// 							.try_into()
// 							.wrap_err("Cannot deserialize `xcode-build-rs` section of Cargo.toml")?;
// 						info!(message = "Deserialized Config from Cargo.toml", ?config);
// 						Ok(config)
// 					}
// 				}
// 			}
// 		}
// 	}

// 	pub fn ios_feature_flags(&self) -> Flags {
// 		self.ios.clone()
// 	}
// }

// impl Flags {
// 	pub fn into_args(&self) -> Vec<String> {
// 		let mut args = vec![];
// 		if !self.default_features {
// 			args.push("--no-default-features".into());
// 		}
// 		for feature in self.features.iter() {
// 			args.push("--features".into());
// 			args.push(feature.clone());
// 		}
// 		args
// 	}
// }

// pub fn release_profile() -> Result<bool, Report> {
// 	let mut is_release_build = true;
// 	const CONFIGURATION: &str = "CONFIGURATION";
// 	let configuration_env_var = env::var(CONFIGURATION);
// 	if configuration_env_var == Ok("Release".into()) {
// 		is_release_build = true;
// 		info!(
// 			message =
// 				"Assuming a --release profile since the CONFIGURATION env flag was set to 'Release'",
// 			?configuration_env_var
// 		);
// 	} else if configuration_env_var == Ok("Debug".into()) {
// 		is_release_build = false;
// 		info!(
// 			message =
// 				"Assuming not a release profile since the CONFIGURATION env flag was set to 'Debug'",
// 			?configuration_env_var
// 		);
// 	} else {
// 		info!(
// 			message = "No known release profile was provided in the CONFIGURATION env var",
// 			?configuration_env_var,
// 			?is_release_build
// 		);
// 	}
// 	Ok(is_release_build)
// }

// pub fn is_simulator() -> Result<bool, Report> {
// 	let mut is_simulator = false;
// 	if let Some(llvm_target_triple_suffix) = env::var_os("LLVM_TARGET_TRIPLE_SUFFIX") {
// 		if llvm_target_triple_suffix == *"-simulator" {
// 			info!(
// 				message = "Assuming building for a simulator",
// 				?llvm_target_triple_suffix
// 			);
// 			is_simulator = true;
// 		}
// 	}
// 	Ok(is_simulator)
// }

// pub enum Archs {
// 	X86_64,
// 	Arm64,
// }

// pub fn parse_archs() -> color_eyre::Result<Archs> {
// 	impl Archs {
// 		fn try_from_str(str: &str) -> Result<Self, Report> {
// 			Ok(match str {
// 				"x86_64" => Archs::X86_64,
// 				"arm64" => Archs::Arm64,
// 				_ => {
// 					return Err(eyre!("Cannot parse ARCHS env variable").note(format!("ARCHS: {:?}", str)))
// 				}
// 			})
// 		}
// 	}

// 	match env::var("ARCHS") {
// 		Err(e) => Err(e).wrap_err("No ARCHS env var present")?,
// 		Ok(archs) => Archs::try_from_str(&archs),
// 	}
// }

// pub fn rustc(
// 	target: &'static str,
// 	release: bool,
// 	flags: Flags,
// 	manifest_dir: &Utf8Path,
// ) -> Result<(), Report> {
// 	let rustc_path = which::which("cargo").wrap_err("Cannot find cargo executable path")?;
// 	// don't change this to pure. just don't.
// 	let mut rustc = bossy::Command::impure(&rustc_path).with_args([
// 		"rustc",
// 		"--crate-type",
// 		"staticlib",
// 		"--lib",
// 		"--target",
// 		target,
// 		"--manifest-path",
// 		manifest_dir.as_str(),
// 	]);
// 	for flag in flags.into_args() {
// 		rustc.add_arg(flag);
// 	}
// 	if release {
// 		rustc.add_arg("--release");
// 	}
// 	info!(message = "About to run rustc", cwd = ?cwd(), ?rustc_path, ?flags, ?manifest_dir);
// 	rustc
// 		.run_and_wait()
// 		.wrap_err("rustc invocation failed, likely a Rust-side build error")?;
// 	Ok(())
// }

// pub fn cwd() -> Result<Utf8PathBuf, Report> {
// 	Utf8PathBuf::try_from(env::current_dir().wrap_err("Cannot find cwd")?).wrap_err("CWD is not UTF8")
// }

// pub fn debug_confirm_on_path(
// 	paths: &[std::path::PathBuf],
// 	bin: &'static str,
// ) -> Result<bool, Report> {
// 	let bin_path = which::which(bin).wrap_err("Couldn't find binary")?;
// 	let bin_dir = {
// 		let mut bin_path = bin_path.clone();
// 		bin_path.pop();
// 		bin_path
// 	};
// 	let bin_contained = paths.contains(&bin_dir);
// 	info!(
// 		?bin_contained,
// 		?bin_dir,
// 		?bin_path,
// 		"Debug searching for `{}` bin path, was successful: {}",
// 		bin,
// 		bin_contained
// 	);
// 	Ok(bin_contained)
// }