list_dir

To list directory contents recursively, provide the target path and enable the recursive flag. This returns all descendant files and subdirectories as relative paths, enabling full-tree inspection of your project structure.

The best way to enumerate immediate files and subdirectories is by performing a flat listing on the target path. This returns only the direct children of the specified directory without traversing nested folders.

Yes, you can generate a manifest of files by enumerating the target directory. By enabling recursive traversal, you capture all descendant paths as relative names to document the complete file structure.

Directory traversal handles missing paths and non-directory inputs gracefully by managing common filesystem errors. This ensures the enumeration process stops safely without crashing when encountering invalid targets.

No external dependencies are required to audit a codebase folder structure. The enumeration operates directly on the filesystem using a required path and an optional recursive flag to return the contents.