fsiter - File System Iteration & Search

The fsiter module is a powerful alternative to ls and find, providing flexible filtering, depth-first search (DFS) traversal, and script-friendly queries.

When to Activate

• When the user wants to list specific file types (e.g., hidden-only, files-only).
• When performing recursive directory traversal with depth limits.
• When checking if a directory is empty or if specific patterns exist.
• When counting files or directories in a tree for reporting.

Core Principles & Rules

• Depth-First Search: Use --dfs for controlled tree traversal with custom callbacks.
• Efficient Filtering: Combine --file, --folder, and --hidden to pinpoint targets.
• Script-Ready: Subcommands like --filecount and --dirempty provide reliable exit codes and values for automation.

Additional Scenarios

• Existence Check: Quickly verify if patterns exist using --exist.
• Recursive Processing: Use --dfs with depth limits to process files in specific tree levels.