Struct SandboxPath 

pub struct SandboxPath { /* private fields */ }

A path that has been validated to be within a SandboxRoot.

Cannot be constructed directly; must come from SandboxRoot::join(). This type guarantees that the path:

• Does not escape the sandbox root
• Does not contain .. traversal components
• Is not an absolute path outside the root
• Does not contain symlinks (if configured)

Example

use xchecker_utils::paths::{SandboxRoot, SandboxConfig};

let root = SandboxRoot::new("/workspace", SandboxConfig::default())?;
let path = root.join("src/lib.rs")?;

// Use the full path for I/O operations
let content = std::fs::read_to_string(path.as_path())?;

// Use the relative path for display or storage
println!("File: {}", path.relative().display());

Implementations

impl SandboxPath

pub fn as_path(&self) -> &Path

Get the full path for I/O operations.

This returns the complete path including the sandbox root, suitable for use with std::fs operations.

pub fn relative(&self) -> &Path

Get the relative portion of the path.

This returns the path relative to the sandbox root, suitable for display or storage in artifacts.

pub fn to_path_buf(&self) -> PathBuf

Convert to a PathBuf for ownership.

pub fn relative_to_path_buf(&self) -> PathBuf

Convert the relative path to a PathBuf.

Trait Implementations

impl AsRef<Path> for SandboxPath

fn as_ref(&self) -> &Path

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for SandboxPath

fn clone(&self) -> SandboxPath

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SandboxPath

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

Formats the value using the given formatter.