Struct SessionDir 

pub struct SessionDir { /* private fields */ }

Session directory manager

Manages temporary directories for REPL sessions with performance optimizations:

• Linux: Tries tmpfs (/dev/shm) for RAM-backed storage
• macOS/Windows: Uses OS temp directory with caching
• All platforms: Respects OXUR_REPL_TEMP_DIR override

Examples

use oxur_repl::session::SessionDir;
use oxur_repl::protocol::SessionId;

let session_id = SessionId::new("test-session");
let dir = SessionDir::new(&session_id).expect("Failed to create session dir");

// Use directory for compilation artifacts
let source_path = dir.path().join("eval_0.rs");

// Cleanup happens automatically on drop

Implementations

impl SessionDir

pub fn new(session_id: &SessionId) -> Result<Self, SessionDirError>

Create a new session directory

Strategy (per ODD-0026 Decision 4):

1. Check OXUR_REPL_TEMP_DIR environment variable
2. Try tmpfs on Linux (/dev/shm)
3. Fall back to OS temp directory

Errors

Returns error if directory creation fails

pub fn path(&self) -> &Path

Get the path to this session directory

pub fn is_tmpfs(&self) -> bool

Check if this directory is on tmpfs

pub fn session_id(&self) -> &SessionId

Get the session ID

pub fn write_source( &self, name: impl AsRef<str>, content: impl AsRef<str>, ) -> Result<PathBuf, SessionDirError>

Write source code to a file in this directory

Arguments

• name - File name (e.g., “eval_0.rs”)
• content - Source code content

pub fn create_subdir( &self, name: impl AsRef<str>, ) -> Result<PathBuf, SessionDirError>

Create a subdirectory within this session directory

pub fn cleanup(&self) -> Result<(), SessionDirError>

Clean up the session directory

Removes all files and the directory itself. Called automatically on drop, but can be called explicitly.

pub fn list_files(&self) -> Result<Vec<PathBuf>, SessionDirError>

List all files in the session directory

pub fn get_stats(&self) -> Result<DirStats, SessionDirError>

Get directory statistics

Returns (file_count, total_bytes) for all files in the session directory. This recursively walks subdirectories.

Trait Implementations

impl Clone for SessionDir

fn clone(&self) -> SessionDir

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionDir

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

Formats the value using the given formatter.

impl Drop for SessionDir

fn drop(&mut self)

Executes the destructor for this type.