Expand description
Purpose: Facade for filesystem utility helpers used across Ralph.
Responsibilities:
- Declare focused fsutil companion modules.
- Re-export the stable filesystem utility API used by crate callers.
- Keep fsutil regression coverage colocated with the fsutil module.
Scope:
- Thin facade only; filesystem helper behavior lives in sibling companion modules.
Usage:
- Used through
crate::fsutil::*imports across queue, config, runtime, and integration code. - Keeps the existing
crate::fsutilsurface stable while implementation is split.
Invariants/Assumptions:
- Existing public and crate-internal fsutil imports remain valid without caller changes.
- Companion modules stay private; the facade owns the stable surface.
Re-exports§
pub use crate::constants::paths::RALPH_TEMP_PREFIX;
Functions§
- cleanup_
default_ temp_ dirs - cleanup_
stale_ temp_ dirs - cleanup_
stale_ temp_ entries - create_
ralph_ temp_ dir - create_
ralph_ temp_ file - Creates a NamedTempFile in the ralph temp directory with the ralph_ prefix. This ensures the file will be caught by cleanup_default_temp_dirs().
- expand_
tilde - Expands a leading
~to the user’s home directory ($HOME) for Unix-style paths. - ralph_
temp_ root - safeguard_
text_ dump - Writes a safeguard dump with raw (non-redacted) content.
- safeguard_
text_ dump_ redacted - Writes a safeguard dump with redaction applied to sensitive content.
- write_
atomic