obliterate 1.0.0

Force-remove Files and Directories on Linux Including Paths with 000 Permissions.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

//! # Resource Obliteration and Unmount Management
//!
//! This crate provides a robust mechanism for force-removing directory trees on Linux systems.
//! Unlike standard removal functions, it is designed to handle complex scenarios such as
//! nested mount points and restrictive file permissions.
//!
//! ## Key Features
//!
//! * **Recursive Obliteration:** Force-removes files and directories even if they lack
//!   write permissions by dynamically adjusting file modes.
//! * **Mount-Point Detection:** Automatically identifies and lazily unmounts filesystems
//!   nested within the target path to prevent data corruption or orphaned mounts.
//! * **Safety Guards:** Prevents dangerous operations, such as attempting to delete
//!   parent directories (`..`) or invalid path components.
//! * **Stack Safety:** Utilizes stack growth management to handle extremely deep
//!   directory structures without triggering stack overflows.

mod obliterate;
mod error;
mod unmount;

/// Re-exports high-level functions for file and directory removal.
pub use obliterate::{remove, ensure_removed};

/// Re-exports errors.
pub use error::Error;

#[cfg(test)]
mod tests;