Tiếp nhận & Kiểm định File Upload (UploadFile Validation & Processing)

Mục tiêu kiến thức

• Tiếp nhận file thông qua UploadFile = File(...) trong FastAPI.
• Kiểm tra kiểu dữ liệu MIME (content_type), giới hạn kích thước byte, và đọc nội dung bất đồng bộ.

Mô tả bài toán

Viết hàm create_file_upload_app() -> FastAPI: Định nghĩa endpoint: POST /upload/csv:

• Tham số: file: UploadFile = File(...).
• Kiểm định:
• Kiểm tra MIME type: file.content_type phải là "text/csv" hoặc "application/vnd.ms-excel". Nếu không khớp, raise HTTPException(status_code=400, detail="Only CSV files allowed").
• Đọc nội dung: contents = await file.read().
• Kiểm tra kích thước: Nếu len(contents) > 10240 (10 KB), raise HTTPException(status_code=413, detail="File too large").
• Đếm số dòng: Giải mã nội dung text utf-8 và đếm số dòng (dựa trên contents.decode("utf-8").strip().splitlines()).
• Trả về JSON:

  {
      "filename": file.filename,
      "size_bytes": len(contents),
      "line_count": len(lines),
      "status": "VALID"
  }

Ràng buộc

• Thời gian chạy tối đa: 1000ms.
• Giới hạn bộ nhớ: 256MB.
• Dữ liệu đầu vào tuân thủ đúng kiểu dữ liệu và miền giá trị được mô tả.