Struct Guard 

pub struct Guard { /* private fields */ }

What decides whether a launch may proceed. Build one with Guard::for_workspace (apps) or Guard::for_temp_roots (engines without a workspace).

Implementations

impl Guard

pub fn for_temp_roots(app: Option<&str>) -> Guard

Guard for an engine or any launch without a workspace: paths must sit in a system temp root and break no forbidden-location rule.

pub fn for_workspace(ws: &QaWorkspace) -> Result<Guard, UserDataViolation>

Guard for an app launched in ws. Fails when the home is not a QA root this runner created or is itself in a forbidden location.

pub fn with_user_homes(self, homes: Vec<PathBuf>) -> Guard

Replace the user homes the guard protects (default: HOME and USERPROFILE of this process). Tests point it at a fake home.

pub fn with_app(self, app: &str) -> Guard

Name the app under test; its real data directories become forbidden.

pub fn forbidden(&self, resolved: &Path) -> Option<(Rule, String)>

First forbidden-location rule resolved breaks, ignoring any QA root.

pub fn check_dir(&self, path: &Path) -> Result<PathBuf, UserDataViolation>

Judge one directory the runner would hand to the app. Returns its resolved path.

pub fn check_env( &self, env: &[(String, String)], ) -> Result<(), UserDataViolation>

Judge every absolute-path value of a launch environment.

Trait Implementations

impl Clone for Guard

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Guard

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.