ReadingList

A web application for maintaining an ordered list of books to read.

Intent

ReadingList is a small web application for readers who want to maintain a personal, ordered list of books to read. A reader can add a book with its title and author, review books in insertion order, and remove books when they are no longer needed.

What It Does

Allow a reader to submit a non-empty title and author and have the book stored in the reading list.

Allow a reader to remove a selected book from the reading list.

Validate book submissions at the submission boundary before persistence.

Show every stored book in the same order in which it was added.

Provide automated tests for adding books, preserving insertion order, removing books, and rejecting empty titles or authors. The root-level bin/test.sh launcher is POSIX-compatible and runs the complete suite from the application root.

Presents the reader-facing form, ordered book list, empty state, validation feedback, and removal controls.

Setup and Running

Before first run:

• Copy .env.example to .env and fill in local values before starting.
• Confirm the repository has the expected remote with git remote -v; add origin if the startup guard requires it.
• Run git status --short and commit or intentionally stash local changes before deployment-oriented runs.

Install dependencies:

uv sync

Start the application:

python run.py

Verification

bash bin/test.sh

Next Steps

• Complete the first-run checks above.
• Start the application with python run.py.
• Run bash bin/test.sh before making release or deployment changes.