List Directory

from moru import Sandbox

sandbox = Sandbox.create()

# List directory contents
entries = sandbox.files.list("/home/user")

for entry in entries:
    print(f"{entry.name} ({entry.type}): {entry.size} bytes")

# List with depth 1 (default) - immediate children only
entries = sandbox.files.list("/home/user", depth=1)

# List with depth 2 - includes grandchildren
entries = sandbox.files.list("/home/user", depth=2)

# Deep recursive listing
entries = sandbox.files.list("/home/user", depth=10)

for entry in entries:
    print(entry.path)

entries = sandbox.files.list("/home/user")

# Get only files
files = [e for e in entries if e.type == "file"]

# Get only directories
dirs = [e for e in entries if e.type == "dir"]

print(f"Files: {len(files)}, Directories: {len(dirs)}")

def print_tree(entries, indent=0):
    # Group by parent directory
    by_parent = {}
    for entry in entries:
        parent = "/".join(entry.path.split("/")[:-1])
        by_parent.setdefault(parent, []).append(entry)

    def print_dir(path, level):
        children = by_parent.get(path, [])
        for child in sorted(children, key=lambda e: e.name):
            prefix = "  " * level
            icon = "📁" if child.type == "dir" else "📄"
            print(f"{prefix}{icon} {child.name}")
            if child.type == "dir":
                print_dir(child.path, level + 1)

    print_dir("/home/user", 0)

entries = sandbox.files.list("/home/user", depth=5)
print_tree(entries)

# List as root to see all files
entries = sandbox.files.list("/root", user="root")

# List as specific user
entries = sandbox.files.list("/home/alice", user="alice")

# Find all Python files
result = sandbox.commands.run("find /home/user -name '*.py' -type f")
python_files = result.stdout.strip().split("\n")

# Find files modified in last hour
result = sandbox.commands.run("find /home/user -mmin -60 -type f")
recent_files = result.stdout.strip().split("\n")

from moru.exceptions import NotFoundException

try:
    entries = sandbox.files.list("/nonexistent/path")
except NotFoundException:
    print("Directory not found")