File upload processing in Flask - Performance & Optimization

Performance: File upload processing

MEDIUM IMPACT

This affects page load speed and interaction responsiveness by how the server handles file uploads and how the frontend manages upload UI and feedback.

Handling file uploads in a Flask app

Flask

from flask import Flask, request
import threading
import os
app = Flask(__name__)

def save_file_async(data, filename):
    with open(os.path.join('/tmp', filename), 'wb') as f:
        f.write(data)

@app.route('/upload', methods=['POST'])
def upload():
    file = request.files['file']
    filename = file.filename
    data = file.read()
    threading.Thread(target=save_file_async, args=(data, filename)).start()
    return 'Upload started'

Offloads file saving to a background thread, freeing the server to respond quickly and handle other requests.

📈 Performance GainNon-blocking upload handling improves INP and server throughput.

Handling file uploads in a Flask app

Flask

from flask import Flask, request
app = Flask(__name__)

@app.route('/upload', methods=['POST'])
def upload():
    file = request.files['file']
    file.save('/tmp/' + file.filename)
    return 'Upload complete'

Saving files synchronously blocks the server during upload, causing slow response and poor user experience under load.

📉 Performance CostBlocks server request handling during file save, increasing response time and INP.

Performance Comparison

Pattern	DOM Operations	Reflows	Paint Cost	Verdict
Synchronous file save in Flask route	Minimal DOM changes	0 reflows	Low paint cost	[X] Bad
Asynchronous file save with background thread	Minimal DOM changes	0 reflows	Low paint cost	[OK] Good

Rendering Pipeline

File upload processing mainly affects server response time which impacts the browser's ability to paint updated UI and respond to user input.

→Network

→JavaScript Execution

→Paint

⚠️ BottleneckServer-side blocking during file save delays response and UI update.

Core Web Vital Affected

INP

This affects page load speed and interaction responsiveness by how the server handles file uploads and how the frontend manages upload UI and feedback.

Optimization Tips

1Avoid blocking server routes with synchronous file save operations.

2Use background threads or asynchronous tasks to handle file saving.

3Monitor server response times in DevTools Network panel to detect upload delays.

Performance Quiz - 3 Questions

What is the main performance problem with saving uploaded files synchronously in a Flask route?

A It causes the browser to repaint multiple times.

B It increases the size of the uploaded file.

C It blocks the server from handling other requests until saving finishes.

D It reduces the file upload speed on the client side.

DevTools: Network

How to check: Open DevTools, go to Network tab, upload a file and observe the request duration and response time.

What to look for: Look for long blocking times or delayed responses indicating server-side processing delays.

Practice

1. What does request.files in Flask represent when handling file uploads?

easy

A. A dictionary-like object containing uploaded files

B. A list of all form fields submitted

C. A string with the file path on the server

D. A function to save files automatically

Solution

1. Step 1: Understand request.files role

   It holds files sent by the client in a dictionary-like object where keys are input names.

2. Step 2: Differentiate from other request parts

   Unlike form fields in request.form, request.files specifically contains uploaded files.

3. Final Answer:

   A dictionary-like object containing uploaded files -> Option A

4. Quick Check:

   Files = dictionary-like object [OK]

Hint: Remember: files come in a dictionary, not a list or string [OK]

Common Mistakes:

• Confusing request.files with request.form
• Expecting a list instead of a dictionary-like object
• Thinking it automatically saves files

2. Which of the following is the correct way to check if a file was uploaded in Flask?

easy

A. if request.files.filename == ''

B. if 'file' in request.files and request.files['file'].filename != ''

C. if request.form['file'] != None

D. if request.files['file'] is None

Solution

1. Step 1: Check file presence in request.files

   Use 'file' in request.files to confirm the file input exists.

2. Step 2: Verify filename is not empty

   Check request.files['file'].filename != '' to ensure a file was selected.

3. Final Answer:

   if 'file' in request.files and request.files['file'].filename != '' -> Option B

4. Quick Check:

   Check key and filename not empty [OK]

Hint: Check key exists and filename is not empty string [OK]

Common Mistakes:

• Checking request.form instead of request.files
• Using is None instead of checking filename
• Comparing filename directly to None

3. Given this Flask code snippet:

file = request.files['photo']
filename = secure_filename(file.filename)
file.save(f"uploads/{filename}")
return f"Saved {filename}"

What will be the output if a user uploads a file named my cat.png?

medium

A. Saved mycat.png

B. Saved my cat.png

C. Saved my_cat.png

D. Error due to spaces in filename

Solution

1. Step 1: Understand secure_filename effect

   This function replaces spaces with underscores and removes unsafe characters.

2. Step 2: Apply to 'my cat.png'

   The filename becomes 'my_cat.png' after sanitization.

3. Final Answer:

   Saved my_cat.png -> Option C

4. Quick Check:

   Spaces replaced by underscores in filename [OK]

Hint: Remember secure_filename replaces spaces with underscores [OK]

Common Mistakes:

• Assuming spaces remain in filename
• Expecting filename unchanged
• Thinking spaces cause save error

4. What is wrong with this Flask file upload code?

file = request.files['file']
file.save(file.filename)
return 'File saved!'

medium

A. It does not check if a file was uploaded

B. It saves file to a wrong directory

C. It should use request.form instead of request.files

D. It uses an unsafe filename directly

Solution

1. Step 1: Identify filename safety issue

   Using file.filename directly can allow unsafe paths or characters.

2. Step 2: Recommend using secure_filename

   To avoid security risks, filenames must be sanitized before saving.

3. Final Answer:

   It uses an unsafe filename directly -> Option D

4. Quick Check:

   Always sanitize filenames before saving [OK]

Hint: Always use secure_filename before saving files [OK]

Common Mistakes:

• Not checking if file exists before saving
• Saving files without sanitizing filename
• Confusing request.form with request.files

5. You want to allow users to upload only PNG images and save them safely in Flask. Which code snippet correctly implements this?

hard

A. file = request.files['image']
if file and file.filename.endswith('.png'):
filename = secure_filename(file.filename)
file.save(f"uploads/{filename}")
return 'PNG saved'
else:
return 'Invalid file'

B. file = request.files['image']
if file.filename:
file.save(file.filename)
return 'File saved'
else:
return 'No file'

C. file = request.files.get('image')
if file and file.filename:
filename = secure_filename(file.filename)
file.save(f"uploads/{filename}")
return 'File saved'
else:
return 'No file uploaded'

D. file = request.files['image']
if file and file.filename.endswith('.png'):
file.save(file.filename)
return 'PNG saved'
else:
return 'Invalid file'

Solution

1. Step 1: Check file presence and extension

   file = request.files['image'] if file and file.filename.endswith('.png'): filename = secure_filename(file.filename) file.save(f"uploads/{filename}") return 'PNG saved' else: return 'Invalid file' checks if file exists and filename ends with '.png' to allow only PNG files.

2. Step 2: Use secure_filename before saving

   It sanitizes the filename to prevent security issues before saving.

3. Step 3: Return appropriate messages

   Returns confirmation if saved, else an invalid file message.

4. Final Answer:

   Option A correctly checks extension and uses secure_filename -> Option A

5. Quick Check:

   Check extension + secure filename + save [OK]

Hint: Check extension and sanitize filename before saving [OK]

Common Mistakes:

• Not sanitizing filename before saving
• Not checking file extension properly
• Saving files without checking if uploaded