isaacs/rimraf
Rimraf
rimraf is a Node.js recursive file deletion tool and cross-platform filesystem utility. It provides both a programmatic library and a command-line interface for removing files and directories and all of their contained contents across different operating systems.
The utility supports glob-based file deletion, allowing the removal of items that match specific wildcard patterns rather than just literal paths. It also includes the ability to abort deletion processes mid-execution and apply custom predicate-based filtering to exclude specific files or folders.
The project covers broad filesystem management capabilities including recursive depth-first traversal, cross-platform path normalization, and asynchronous I/O. These features enable tasks such as automated build artifact removal and general project workspace cleanup.
Features
- File Deletions - Provides a command-line interface for executing recursive file and folder deletions with interactive confirmation.
- Programmatic File Operations - Provides a programmatic API for managing disk space and directory structures within Node.js applications.
- Cross-Platform Path Manipulation - Provides utilities to normalize file path separators and formats for consistent deletion across Windows, macOS, and Linux.
- File Pattern Matching - Identifies target files for deletion using wildcard and recursive glob patterns.
- Glob Pattern Selectors - Supports removing files and directories that match specific glob patterns instead of literal paths.
- Cross-Platform File Operations - Provides consistent recursive directory removal and file operations across different operating systems.
- Recursive Deletion - Implements recursive removal of folders and all their contained contents across different operating systems.
- Asynchronous File I/O - Implements non-blocking filesystem operations using Node.js asynchronous APIs to prevent event loop stalls.
- Recursive Directory Traversers - Performs depth-first traversal of directory trees to ensure child items are removed before their parent folders.
- Filesystem Path Filtering - Allows using custom boolean functions to selectively exclude specific files or folders from being deleted.
- Build Artifact Cleaners - Facilitates the clearing of temporary directories and build outputs to ensure a fresh development state.
- CLI File Managers - Ships as a command-line utility for executing deep file deletions with interactive confirmation.
- Glob-Based Deletion Utilities - Provides a specialized tool for removing files and directories based on glob patterns within Node.js projects.
- Pattern-Based File Deletions - Enables the removal of groups of files and directories matching specific glob patterns to clean project workspaces.
- Deletion Predicates - Provides a mechanism to evaluate custom boolean predicates against paths to exclude specific items from deletion.
- File System Utilities - Recursive file deletion.
- Cross-Platform Utilities - Deletes files or directories like rm -rf.
- File System - Performs deep file system deletion.
- Filesystem Utilities - Cross-platform file and directory deletion.
