FastAPI Task Management

This is a simple app to demonstrate a simple task management API.

Tasks are run using FastAPI Background Tasks as async functions. The "task" is a sleep for 10 seconds.

The following endpoints are provided:

• /docs - the SwaggerUI for this App. Also usable to try out the service.

• /start: starts a new task, returns something like:

  {"task_id":"4d15b40a748341358a6024437ef7de4c"}

  The task is started in a Background Task and listens also on a redis queue specific for this task to await potential cancellation.

• /status/{task_id}: returns the status of the given task which is either unknown, started, finished or cancelled.

• /cancel/{task_id}: cancel a task when it is started, no-op if status is otherwise. This sends a message via Redis to a task specific queue.

Development

To set up everything:

pip install -r requirements.txt

To start redis:

docker run --name my-redis -p 6379:6379 --rm redis

To start the app:

uvicorn app.main:app --reload

Which now listens on 127.0.0.1:8000