Flask Task Manager Development by Dariush SamariFlask Task Manager Development by Dariush Samari

Flask Task Manager Development

Dariush Samari

Completed work

Software Engineer

Website CSS

Web Developer

Bootstrap

Flask

SQLite

Computer Software

Flask Task Manager

A combined Flask API and built‑in web UI for creating, reading, updating, and deleting to‑do tasks.

Features

REST API for tasks (/tasks): create, list, view, update, delete.

Web UI served at /: add, edit, complete, and remove tasks with a modern Bootstrap design.

Single origin—no CORS required: back end and front end run together.

SQLite persistence in tasks.db, auto‑initialized on first launch.

Tech Stack

Python 3.x

Flask (2.2.2)

SQLAlchemy (2.0.x)

SQLite

Bootstrap 5 + Bootstrap Icons (front‑end)

Project Structure

.
├── app.py             # Entry point: configures Flask, serves static UI, registers routes
├── database.py        # DB engine, session setup & init_db()
├── models.py          # SQLAlchemy Task model
├── routes.py          # Blueprint: API endpoints (GET/POST/PUT/DELETE /tasks)
├── services.py        # TaskService: business logic & ORM calls
├── static/            # Front‑end assets
│   └── index.html     # Single‑page UI, interacts with API
├── requirements.txt   # Python dependencies
└── test_routes.py     # Pytest suite for API endpoints

Note: tasks.db is created automatically via init_db() when you start the app.

Prerequisites

Git (for cloning & updates)

Ubuntu/Debian: sudo apt-get update && sudo apt-get install git

macOS (Homebrew): brew install git

Windows: Download Git

Python 3.8+

Setup & Git Commands

# Clone the repo (first time)
git clone https://github.com/binarynectar/task-manager.git
cd task-manager

# Pull latest changes
git pull origin main

# (Optional) Virtual environment
python3 -m venv venv
source venv/bin/activate

# Install Python dependencies
pip install -r requirements.txt

Running Locally

python app.py

Opens server on http://127.0.0.1:5000/

API at /tasks

UI at / (renders static/index.html)

Web UI Usage

Navigate to http://127.0.0.1:5000/ in your browser.

Add a new task via the input field and + button.

Toggle a task’s completion with the checkbox.

Edit a task title with the ✏️ Edit button.

Remove a task with the 🗑️ Delete button.

API Endpoints

All endpoints accept and return JSON.

| Method | Endpoint      | Description                                      | Request Body                                                           | Response                                 |
| ------ | ------------- | ------------------------------------------------ | ---------------------------------------------------------------------- | ---------------------------------------- |
| GET    | `/tasks`      | List all tasks                                   | *None*                                                                 | `[{id, title, deadline, completed}, …]`  |
| GET    | `/tasks/<id>` | Retrieve a single task                           | *None*                                                                 | `{id, title, deadline, completed}`       |
| POST   | `/tasks`      | Create a new task                                | `{"title": string, "deadline"?: "YYYY-MM-DD"}`                         | `{id, title, deadline, completed}` (201) |
| PUT    | `/tasks/<id>` | Update title, deadline, and/or completion status | `{"title"?: string, "deadline"?: "YYYY-MM-DD", "completed"?: boolean}` | `{id, title, deadline, completed}`       |
| DELETE | `/tasks/<id>` | Delete a task                                    | *None*                                                                 | *Empty body* (204)                       |

Example cURL

# Create with deadline
echo '{"title":"Buy milk","deadline":"2025-07-31"}' \
  | curl -X POST http://127.0.0.1:5000/tasks \
         -H "Content-Type: application/json" \
         -d @-

# Create without deadline
echo '{"title":"Walk dog"}' \
  | curl -X POST http://127.0.0.1:5000/tasks \
         -H "Content-Type: application/json" \
         -d @-

# Update title & deadline
echo '{"title":"Pay bills","deadline":"2025-08-05"}' \
  | curl -X PUT http://127.0.0.1:5000/tasks/1 \
         -H "Content-Type: application/json" \
         -d @-

# Mark complete
echo '{"completed":true}' \
  | curl -X PUT http://127.0.0.1:5000/tasks/1 \
         -H "Content-Type: application/json" \
         -d @-

# Delete task
curl -X DELETE http://127.0.0.1:5000/tasks/1