wave_02.md

Wave 2: Using Query Params

Goal

Our task list API allows users to create tasks and get a list of all tasks. Our users will find it useful to be able to sort through these tasks by title! Our goal is to implement a basic sorting feature for our tasks.

Requirements

The following are required routes for wave 2. Feel free to implement the routes in any order within this wave.

Use the tests in tests/test_wave_02.py to guide your implementation.

• You may feel that there are missing tests and missing edge cases considered in this wave. This is intentional.
  • You have fulfilled wave 2 requirements if all of the wave 2 tests pass.
  • You are free to add additional features, as long as the wave 2 tests still pass. However, we recommend that you consider the future waves, first.
• Some tests use a fixture named three_tasks that is defined in tests/conftest.py. This fixture saves three different tasks with three different titles to the test database.

Tips

• Pay attention to the exact shape of the expected JSON. Double-check nested data structures and the names of the keys for any misspellings.

Sorting Tasks: By Title, Ascending

As a client, I want to be able to make a GET request to /tasks?sort=asc when there is more than one saved task, and get an array of tasks sorted by title. The titles should be in ascending order, where a task with the title "A" is sorted before a task with the title "B."

I want to get this response:

200 OK

[
  {
    "id": 1,
    "title": "A",
    "description": "Example Task Description 1",
    "is_complete": false
  },
  {
    "id": 2,
    "title": "B",
    "description": "Example Task Description 2",
    "is_complete": false
  }
]

Sorting Tasks: By Title, Descending

As a client, I want to be able to make a GET request to /tasks?sort=desc when there is more than one saved task, and get an array of tasks sorted by title. The titles should be in descending order, where a task with the title "B" is sorted before a task with the title "A."

I want to get this response:

200 OK

[
  {
    "id": 2,
    "title": "B",
    "description": "Example Task Description 2",
    "is_complete": false
  },
  {
    "id": 1,
    "title": "A",
    "description": "Example Task Description 1",
    "is_complete": false
  }
]