How to List File Metadata in Python

from pathlib import Path
import json

def format_files_data(directory_path):
    """Return a list of JSON-serializable dicts with file metadata."""
    base = Path(directory_path)
    if not base.is_dir():
        raise ValueError(f"Not a directory: {directory_path}")

    files_data = []
    for file_path in base.iterdir():
        if file_path.is_file():
            stats = file_path.stat()
            files_data.append({
                "name": file_path.name,
                "size_bytes": stats.st_size,
                "modified_time": stats.st_mtime,
            })

    return files_data

if __name__ == "__main__":
    import tempfile
    from pathlib import Path

    with tempfile.TemporaryDirectory() as tmpdir:
        tmp = Path(tmpdir)
        (tmp / "notes.txt").write_text("hello world")
        (tmp / "data.csv").write_text("a,b,c\n1,2,3")

        result = format_files_data(tmpdir)
        print(json.dumps(result, indent=2))