Tirsvad-Udemy-100_days_of_code/009-the_secret_auction_program

Files

T

Tirsvad 8d13657773 docs: complete documentation for Milestone 4

- Rewrite README.md with overview, requirements, setup, run, tests
  sections
- Add docs/flowchart.md with Mermaid diagram and link to diagrams.net
  source
- Update docs/plan.md to mark Milestone 4 as complete

2026-10-04 14:21:13 +08:00

2.1 KiB

Raw Blame History

🚀 Secret Auction Program

A beginner-friendly Python program that runs a blind auction: bidders enter their name and bid one after another, the screen is cleared between bidders, and the highest bidder wins.

🧭 Overview

This is the Day 9 project of Udemy's 100 Days of Code: The Complete Python Pro Bootcamp. Each bidder enters a name and a bid, which are stored in a dictionary (name → bid). After each bidder the program asks whether there are more bidders and, if so, clears the screen so the next bidder cannot see earlier bids. When everyone has bid, the program announces the winner.

See the program flowchart and the plan and milestones.

📋 Requirements

Python 3.13 or newer
No runtime dependencies
pytest for the tests (installed by the dev extra)
Doxygen (optional, to generate the API documentation)

🛠️ Setup

Create and activate a local virtual environment, upgrade pip, then install the project with its development tools.

Windows (PowerShell):

python -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

Linux / macOS:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

▶️ Run

With the virtual environment active:

python -m secret_auction.main

or use the installed command:

secret-auction

🧪 Tests

python -m pytest

To generate the API documentation (output in docs/doxygen/):

doxygen Doxyfile

📄 License

Licensed under the GNU Affero General Public License v3.0 — see LICENSE.

2.1 KiB Raw Blame History