Testing routes and responses in Flask - Cheat Sheet & Quick Revision

Recall & Review

beginner

What is the purpose of testing routes in a Flask application?

Testing routes ensures that the web app responds correctly to different URLs and HTTP methods, verifying that users get the expected pages or data.

beginner

Which Flask tool helps simulate requests to test routes without running the server?

Flask's test client allows you to send fake requests to your app routes and check responses, all inside your test code.

beginner

How do you check the status code of a response in Flask testing?

After sending a test request, you access response.status_code to see if it matches expected values like 200 for success or 404 for not found.

intermediate

Why is it important to test both GET and POST routes in Flask?

GET and POST handle different actions: GET fetches data, POST sends data. Testing both ensures your app handles user requests correctly in all cases.

beginner

What does the following Flask test code check?

response = client.get('/hello')
assert b'Hello' in response.data

It checks that when the '/hello' route is requested, the response contains the word 'Hello' in its content, confirming the route returns expected text.

What method of Flask's test client simulates a GET request?

A client.fetch()

B client.post()

C client.request()

D client.get()

client.get() sends a simulated GET request to a route for testing.

Which attribute holds the raw response content in Flask testing?

A response.data

B response.content

C response.text

D response.body

response.data contains the raw bytes of the response body in Flask tests.

What status code usually means a route was found and responded successfully?

A 500

B 200

C 404

D 302

Status code 200 means OK, the request succeeded.

To test a POST route with form data, which method is used?

A client.post(data={...})

B client.put()

C client.get()

D client.delete()

client.post() with data argument sends form data in a POST request.

Why should tests check response content besides status code?

A To verify the server is running

B To test CSS styles

C To confirm the route returns expected data

D To check the database connection

Checking content ensures the route returns the right information, not just a successful status.

Explain how to use Flask's test client to check a route's response status and content.

Think about simulating requests and reading response properties.

Describe why testing both GET and POST routes is important in a Flask app.

Consider how users interact with web pages.

Practice

1. What is the main purpose of using app.test_client() in Flask testing?

easy

A. To create a database connection for testing

B. To start the Flask server for manual testing

C. To simulate HTTP requests to routes without running the server

D. To generate HTML templates automatically

Solution

1. Step 1: Understand the role of app.test_client()

   This method creates a client that can send HTTP requests to the Flask app internally without needing the server to run.

2. Step 2: Compare with other options

   Starting the server or creating a database connection are unrelated to test_client(). It does not generate templates either.

3. Final Answer:

   To simulate HTTP requests to routes without running the server -> Option C

4. Quick Check:

   app.test_client() simulates requests [OK]

Hint: Remember test_client() simulates requests internally [OK]

Common Mistakes:

• Thinking test_client() starts the server
• Confusing test_client() with database setup
• Assuming it generates HTML templates

2. Which of the following is the correct way to test a GET request to the '/' route using Flask's test client?

easy

A. response = client.post('/')

B. response = client.get('/')

C. response = client.request('PUT', '/')

D. response = client.fetch('/')

Solution

1. Step 1: Identify the HTTP method for the route

   The question asks for a GET request, so the method should be get().

2. Step 2: Match the method with the test client syntax

   Flask test client uses client.get(path) to send GET requests. Other methods like post() or request('PUT', ...) are for different HTTP verbs.

3. Final Answer:

   response = client.get('/') -> Option B

4. Quick Check:

   GET request uses client.get() [OK]

Hint: Use client.get() for GET requests in tests [OK]

Common Mistakes:

• Using post() instead of get() for GET requests
• Using client.fetch() which does not exist
• Confusing HTTP methods in test calls

3. Given this Flask test code:

with app.test_client() as client:
    response = client.get('/hello')
    print(response.status_code)
    print(response.data.decode())

If the '/hello' route returns 'Hello, World!' with status 200, what will be printed?

medium

A. 200
Hello, World!

B. 404
Not Found

C. 500
Internal Server Error

D. 200
b'Hello, World!'

Solution

1. Step 1: Understand the route response

   The route '/hello' returns the string 'Hello, World!' with HTTP status 200.

2. Step 2: Analyze the test output

   The response.status_code will be 200. The response.data is bytes, so decoding it with decode() converts it to the string 'Hello, World!'.

3. Final Answer:

   200 Hello, World! -> Option A

4. Quick Check:

   Status 200 and decoded response text [OK]

Hint: Decode response.data to get string content [OK]

Common Mistakes:

• Not decoding response.data (shows bytes)
• Expecting 404 or 500 status codes incorrectly
• Confusing status_code with response content

4. What is wrong with this Flask test code snippet?

client = app.test_client()
response = client.get('/missing')
assert response.status_code == 200

Assuming '/missing' route does not exist.

medium

A. The status code will be 404, so the assertion fails

B. The get method should be post for missing routes

C. The test client must be used inside a context manager

D. The response object does not have status_code attribute

Solution

1. Step 1: Check the route existence

   The route '/missing' does not exist, so Flask returns a 404 Not Found status.

2. Step 2: Evaluate the assertion

   The assertion expects status code 200, but the actual is 404, causing the test to fail.

3. Final Answer:

   The status code will be 404, so the assertion fails -> Option A

4. Quick Check:

   Missing route returns 404, assertion expects 200 [OK]

Hint: Check route exists before asserting status 200 [OK]

Common Mistakes:

• Assuming missing routes return 200
• Thinking get() must be post() for missing routes
• Believing status_code attribute is missing

5. You want to test a Flask route that returns JSON data {"success": true, "count": 5} with status 201. Which test code correctly verifies both the status and JSON content?

hard

A. response = client.get('/data')
assert response.status_code == 201
assert response.json() == {"success": True, "count": 5}

B. response = client.get('/data')
assert response.status_code == 200
assert response.json == {"success": True, "count": 5}

C. response = client.post('/data')
assert response.status_code == 200
assert response.get_json() == {"success": True, "count": 5}

D. response = client.get('/data')
assert response.status_code == 201
assert response.get_json() == {"success": True, "count": 5}

Solution

1. Step 1: Check HTTP method and status code

   The route returns status 201, so the test must assert response.status_code == 201. The method is GET as per the question.

2. Step 2: Verify JSON content correctly

   Flask test response uses get_json() to parse JSON data. Using response.json is incorrect in Flask.

3. Final Answer:

   response = client.get('/data') assert response.status_code == 201 assert response.get_json() == {"success": True, "count": 5} -> Option D

4. Quick Check:

   Use get_json() and check status 201 [OK]

Hint: Use get_json() to check JSON response content [OK]

Common Mistakes:

• Using response.json instead of get_json()
• Checking wrong status code (200 instead of 201)
• Using POST instead of GET method