Struct Ctx 

pub struct Ctx<'a> {
    pub workspace: &'a Path,
    pub section_root: PathBuf,
    pub cwd: Option<PathBuf>,
    pub home: &'a Path,
    pub level: LevelId,
}

The facts about the player’s situation that requirements, answers and cd rules consult.

The engine never reads the process working directory, HOME or any environment variable: the caller captures them once and hands them in here. That keeps every rule a plain function of its inputs, so tests run in parallel without chdir or set_var.

Fields

workspace: &'a Path

The workspace root (holds level-N directories and the marker files).

section_root: PathBuf

The absolute directory every path of the current level is relative to.

cwd: Option<PathBuf>

The player’s current directory, already canonical, or None when it no longer exists (the player deleted the directory they were standing in).

home: &'a Path

The logical $HOME.

level: LevelId

The level being checked.

Implementations

impl<'a> Ctx<'a>

pub fn new( workspace: &'a Path, section_root: PathBuf, cwd: Option<PathBuf>, home: &'a Path, level: LevelId, ) -> Self

Gather the facts. See the field docs for what each one must be.

pub fn markers(&self) -> Markers<'a>

The marker files of the current level.

pub fn home_name(&self) -> String

The last component of $HOME, such as ada for /home/ada (empty for /).

pub fn path(&self, rel: &str) -> Result<PathBuf, ContainmentError>

Resolve a section-relative path with the full containment rules: no absolute paths, no .., no symlinked component.

Trait Implementations

impl<'a> Clone for Ctx<'a>

fn clone(&self) -> Ctx<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Ctx<'a>

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

Formats the value using the given formatter.