File upload forms in Flask - Performance & Optimization

Performance: File upload forms

MEDIUM IMPACT

This affects page load speed and interaction responsiveness when users upload files through forms.

Handling file uploads in a Flask form

Flask

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

@app.route('/upload', methods=['POST'])
def upload():
    file = request.files['file']
    with open('/tmp/' + file.filename, 'wb') as f:
        while chunk := file.stream.read(4096):
            f.write(chunk)
    return 'File uploaded!'

Streaming file in chunks avoids blocking server for long periods, improving responsiveness for large uploads.

📈 Performance GainReduces blocking time during upload, improving INP and user experience for large files.

Handling file uploads in a Flask form

Flask

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

@app.route('/upload', methods=['POST'])
def upload():
    file = request.files['file']
    data = file.read()
    with open('/tmp/' + file.filename, 'wb') as f:
        f.write(data)
    return 'File uploaded!'

Loading the entire file into memory at once blocks the server and delays response, causing slow interaction for users uploading large files.

📉 Performance CostLoads entire file into memory, causing high memory usage and blocking during allocation, increasing INP and delaying response by seconds for large files.

Performance Comparison

Pattern	DOM Operations	Reflows	Paint Cost	Verdict
Loading full file into memory	Minimal	0	Low	[X] Bad
Streaming file in chunks	Minimal	0	Low	[OK] Good

Rendering Pipeline

File upload forms impact the server response time and client interaction responsiveness. The browser sends the file data, which the server processes before responding. Large files can delay server response, affecting interaction to next paint (INP).

→Network

→Server Processing

→Response Rendering

⚠️ BottleneckServer Processing during full file memory load

Core Web Vital Affected

INP

This affects page load speed and interaction responsiveness when users upload files through forms.

Optimization Tips

1Avoid blocking server operations during file uploads.

2Use streaming or chunked file handling to improve responsiveness.

3Monitor upload request times in DevTools Network panel.

Performance Quiz - 3 Questions

What is the main performance issue with loading an uploaded file all at once into memory in Flask?

A It causes excessive DOM reflows in the browser

B It increases CSS paint cost

C It blocks the server during processing, increasing response time

D It reduces network bandwidth

DevTools: Network

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

What to look for: Look for long request times indicating blocking server processing; shorter times indicate better performance.

Practice

1. What must you set in the HTML form tag to allow file uploads in a Flask app?

easy

A. method="get"

B. enctype="multipart/form-data"

C. action="upload"

D. type="file"

Solution

1. Step 1: Understand form encoding for file uploads

   File uploads require the form to send data in a special format that supports files, which is "multipart/form-data".

2. Step 2: Identify the correct form attribute

   The form tag must have the attribute enctype="multipart/form-data" to handle file uploads correctly.

3. Final Answer:

   enctype="multipart/form-data" -> Option B

4. Quick Check:

   Form enctype = multipart/form-data [OK]

Hint: File uploads always need enctype multipart/form-data [OK]

Common Mistakes:

• Using method="get" instead of post
• Forgetting enctype attribute
• Setting type="file" on form tag instead of input
• Confusing action URL with encoding

2. Which Flask code correctly accesses an uploaded file named 'photo' from a form?

easy

A. file = request.form['photo']

B. file = request.args['photo']

C. file = request.data['photo']

D. file = request.files['photo']

Solution

1. Step 1: Identify where uploaded files are stored in Flask

   Uploaded files are stored in request.files, not in request.form or request.args.

2. Step 2: Access the file by its form field name

   Use request.files['photo'] to get the uploaded file object named 'photo'.

3. Final Answer:

   file = request.files['photo'] -> Option D

4. Quick Check:

   Uploaded files = request.files [OK]

Hint: Use request.files to get uploaded files, not request.form [OK]

Common Mistakes:

• Using request.form to get files
• Using request.args which is for URL params
• Trying to access request.data as a dict
• Misspelling 'files' or field name

3. What will the following Flask code print if no file is uploaded?

file = request.files.get('document')
if file and file.filename != '':
    print('File received')
else:
    print('No file uploaded')

medium

A. File received

B. KeyError exception

C. No file uploaded

D. Empty string printed

Solution

1. Step 1: Understand request.files.get behavior when no file sent

   request.files.get('document') returns None if no file was uploaded with that name.

2. Step 2: Evaluate the if condition

   Since file is None, the condition 'file and file.filename != ""' is False, so the else block runs.

3. Final Answer:

   No file uploaded -> Option C

4. Quick Check:

   No file means else prints [OK]

Hint: Check file is not None and filename not empty to confirm upload [OK]

Common Mistakes:

• Assuming request.files['document'] raises error if missing
• Not checking filename for empty string
• Expecting 'File received' even if no file sent
• Confusing request.files.get with request.files[]

4. Identify the error in this Flask file upload snippet:

file = request.files['file']
filename = secure_filename(file)
save_path = os.path.join('uploads', filename)
file.save(save_path)

medium

A. secure_filename should be called on file.filename, not file

B. file.save() requires a file object, not a path

C. os.path.join cannot join strings

D. request.files['file'] returns a string, not a file object

Solution

1. Step 1: Check usage of secure_filename

   secure_filename expects a string filename, but file is a file object, so file.filename should be passed.

2. Step 2: Confirm correct file saving steps

   After getting a safe filename, join path and call file.save(path) correctly.

3. Final Answer:

   secure_filename should be called on file.filename, not file -> Option A

4. Quick Check:

   Pass filename string to secure_filename [OK]

Hint: Use secure_filename(file.filename), not file itself [OK]

Common Mistakes:

• Passing file object to secure_filename
• Confusing file.save argument type
• Misusing os.path.join with non-string
• Assuming request.files returns string

5. You want to allow users to upload multiple images at once and save only PNG files securely. What issue does this Flask code snippet have?

files = request.files.getlist('images')
for file in files:
    if file and file.filename.endswith('.png'):
        filename = secure_filename(file.filename)
        file.save(os.path.join('uploads', filename))

hard

A. file.filename.endswith('.png') is case-sensitive and may miss '.PNG'

B. getlist() returns a single file, so loop will fail

C. secure_filename should be called after saving the file

D. This code correctly filters PNG files and saves them securely

Solution

1. Step 1: Understand getlist() usage

   request.files.getlist('images') correctly returns a list of uploaded files for the field 'images'.

2. Step 2: Check file extension filtering

   Using file.filename.endswith('.png') is case-sensitive and will miss files with uppercase extensions like '.PNG'.

3. Step 3: Confirm secure_filename usage

   secure_filename is correctly called before saving the file.

4. Final Answer:

   file.filename.endswith('.png') is case-sensitive and may miss '.PNG' -> Option A

5. Quick Check:

   Check file extension case-insensitively [OK]

Hint: Check file extensions case-insensitively for uploads [OK]

Common Mistakes:

• Assuming getlist returns one file
• Calling secure_filename after saving
• Ignoring uppercase file extensions
• Not checking if file is None before saving