Simple Todo App with FastAPI and SQLite

A minimalist Todo API application built with FastAPI and SQLite for managing todo items.

Features

• Create, read, update, and delete todo items
• SQLite database with SQLAlchemy ORM
• Alembic migrations for database versioning
• Health check endpoint for monitoring
• OpenAPI documentation

Prerequisites

• Python 3.8+
• pip (Python package installer)

Installation

1. Clone the repository:

git clone https://github.com/yourusername/simpletodoapp.git
cd simpletodoapp

2. Install dependencies:

pip install -r requirements.txt

3. Prepare the database directory:

mkdir -p /app/storage/db

4. Run database migrations:

alembic upgrade head

Running the Application

Start the application with Uvicorn:

uvicorn main:app --reload

The API will be available at http://localhost:8000

API Documentation

Once the application is running, you can access:

• Interactive API documentation: http://localhost:8000/docs
• Alternative API documentation: http://localhost:8000/redoc

API Endpoints

• GET /todos - Get all todos
• POST /todos - Create a new todo
• GET /todos/{todo_id} - Get a specific todo
• PATCH /todos/{todo_id} - Update a todo
• DELETE /todos/{todo_id} - Delete a todo
• GET /health - Check application health

Example Todo JSON

{
  "title": "Buy groceries",
  "description": "Milk, eggs, bread, and cheese",
  "completed": false
}