Struct Playground 

pub struct Playground { /* private fields */ }

A real practice directory with a tracked working directory per session.

Implementations

impl Playground

pub fn open(root: PathBuf) -> Result<Self>

Open (creating on demand) the playground at root.

pub fn open_with_display( root: PathBuf, display: impl Into<String>, ) -> Result<Self>

Open a playground whose paths are shown to the learner under display (e.g. ~/ArcAcademy/home).

pub fn root(&self) -> &Path

The canonicalized playground root.

pub fn cwd(&self) -> &Path

The tracked working directory (absolute real path inside the root).

pub fn has_lesson(&self) -> bool

Whether a lesson directory is currently active.

pub fn display_cwd(&self) -> String

Friendly display path for the tracked cwd, e.g. ~/ArcAcademy/playground/file-mgmt/practice.

pub fn enter_lesson( &mut self, lesson_id: &str, setup: &[SetupFile], ) -> Result<PathBuf>

Enter a lesson: create <root>/<lesson-id>/, materialize its starter files (without clobbering files the learner already changed), and cd there. Returns the lesson directory.

pub fn reset_lesson(&mut self) -> Result<PathBuf>

Wipe and re-materialize the active lesson’s playground directory.

rm safety: only ever deletes inside the playground root — the target is canonicalized and its prefix verified before removal.

pub fn change_directory(&mut self, target: &str) -> Result<String>

Change the tracked working directory (the cd builtin for real practice mode). The target is canonicalized and must remain inside the playground. Returns the new display path.

Trait Implementations

impl PracticeWorld for Playground

fn locate(&self, lesson_path: &str) -> Option<PathBuf>

Real path for a path relative to the lesson home, if it stays inside

fn cwd_relative(&self) -> String

Current directory relative to the lesson home (“” at the home)

fn kind_at(&self, lesson_path: &str) -> Option<EntryKind>

What is at a path relative to the lesson home; None when the path would leave it. By default, the real file PracticeWorld::locate gives.

fn read_text(&self, lesson_path: &str) -> Option<String>

A text file’s contents, by a path relative to the lesson home. By default, read from the real file PracticeWorld::locate gives.