//! Theseus process management interface use uuid::Uuid; pub use crate::{ state::{ Hooks, JavaSettings, MemorySettings, Profile, Settings, WindowSize, }, State, }; use crate::{ state::{MinecraftChild, ProfilePathId}, util::io::IOError, }; // Gets whether a child process stored in the state by UUID has finished #[tracing::instrument] pub async fn has_finished_by_uuid(uuid: &Uuid) -> crate::Result { Ok(get_exit_status_by_uuid(uuid).await?.is_some()) } // Gets the exit status of a child process stored in the state by UUID #[tracing::instrument] pub async fn get_exit_status_by_uuid( uuid: &Uuid, ) -> crate::Result> { let state = State::get().await?; let children = state.children.read().await; Ok(children.exit_status(uuid).await?.and_then(|f| f.code())) } // Gets the UUID of each stored process in the state #[tracing::instrument] pub async fn get_all_uuids() -> crate::Result> { let state = State::get().await?; let children = state.children.read().await; Ok(children.keys()) } // Gets the UUID of each *running* stored process in the state #[tracing::instrument] pub async fn get_all_running_uuids() -> crate::Result> { let state = State::get().await?; let children = state.children.read().await; children.running_keys().await } // Gets the Profile paths of each *running* stored process in the state #[tracing::instrument] pub async fn get_all_running_profile_paths() -> crate::Result> { let state = State::get().await?; let children = state.children.read().await; children.running_profile_paths().await } // Gets the Profiles (cloned) of each *running* stored process in the state #[tracing::instrument] pub async fn get_all_running_profiles() -> crate::Result> { let state = State::get().await?; let children = state.children.read().await; children.running_profiles().await } // Gets the UUID of each stored process in the state by profile path #[tracing::instrument] pub async fn get_uuids_by_profile_path( profile_path: ProfilePathId, ) -> crate::Result> { let state = State::get().await?; let children = state.children.read().await; children.running_keys_with_profile(profile_path).await } // Gets output of a child process stored in the state by UUID, as a string #[tracing::instrument] pub async fn get_output_by_uuid(uuid: &Uuid) -> crate::Result { let state = State::get().await?; // Get stdout from child let children = state.children.read().await; // Extract child or return crate::Error if let Some(child) = children.get(uuid) { let child = child.read().await; Ok(child.output.get_output().await?) } else { Err(crate::ErrorKind::LauncherError(format!( "No child process by UUID {}", uuid )) .as_error()) } } // Kill a child process stored in the state by UUID, as a string #[tracing::instrument] pub async fn kill_by_uuid(uuid: &Uuid) -> crate::Result<()> { let state = State::get().await?; let children = state.children.read().await; if let Some(mchild) = children.get(uuid) { let mut mchild = mchild.write().await; kill(&mut mchild).await } else { // No error returned for already finished process Ok(()) } } // Wait for a child process stored in the state by UUID #[tracing::instrument] pub async fn wait_for_by_uuid(uuid: &Uuid) -> crate::Result<()> { let state = State::get().await?; let children = state.children.read().await; // No error returned for already killed process if let Some(mchild) = children.get(uuid) { let mut mchild = mchild.write().await; wait_for(&mut mchild).await } else { // No error returned for already finished process Ok(()) } } // Kill a running child process directly #[tracing::instrument(skip(running))] pub async fn kill(running: &mut MinecraftChild) -> crate::Result<()> { running .current_child .write() .await .kill() .await .map_err(IOError::from)?; Ok(()) } // Await on the completion of a child process directly #[tracing::instrument(skip(running))] pub async fn wait_for(running: &mut MinecraftChild) -> crate::Result<()> { // We do not wait on the Child directly, but wait on the thread manager. // This way we can still run all cleanup hook functions that happen after. running .manager .take() .ok_or_else(|| { crate::ErrorKind::LauncherError(format!( "Process manager already completed or missing for process {}", running.uuid )) })? .await? .map_err(|err| { crate::ErrorKind::LauncherError(format!( "Error running minecraft: {err}" )) })?; Ok(()) }