tools/upload.py

import os
import mimetypes

UPLOAD_DIR = "uploads"
os.makedirs(UPLOAD_DIR, exist_ok=True)


def save_uploads(files):
    """
    Save uploaded files and return metadata.

    Returns:
    [
        {
            "name": "...",
            "path": "...",
            "type": "...",
            "size": ...
        }
    ]
    """

    uploaded_files = []

    for file in files:
        filepath = os.path.join(UPLOAD_DIR, file.name)

        with open(filepath, "wb") as f:
            f.write(file.getbuffer())

        uploaded_files.append({
            "name": file.name,
            "path": filepath,
            "type": mimetypes.guess_type(filepath)[0],
            "size": os.path.getsize(filepath)
        })

    return uploaded_files