Tirsvad-Udemy-100_days_of_code/011-black-jack

Files

T

Tirsvad 3c99040b96 Add Blackjack game: rules, card rendering, game loop and tests

Implement the playable console game for gateway MIL-002.

- rules.py: deal_card, calculate_score (blackjack = 0, aces drop 11 ->
  1)
  and compare with an Outcome enum; no console I/O
- display.py: hand rendering as plain-text rank plus suit emoji (keycap
  emoji rendered as boxes in common terminals), score formatting and
  outcome messages
- art.py: course logo shown at the start of every game
- game.py: play_game (hit/stand, dealer draws below 17), play (restart
  loop, console clear, logo) and ask_yes_no with re-prompt; read, write
  and draw are injected so games can be scripted
- __main__.py: python -m blackjack entry point, exits cleanly on
  Ctrl+C/Ctrl+D
- constants.py: card ranks and suits, prompts and messages
- tests: 32 new unit and scripted end-to-end tests (35 in total)
- README: run instructions for python -m blackjack

Closes #7
Closes #8
Closes #9
Closes #10
Closes #11
Closes #12
Closes #13
Closes #14

Task: MIL-002#1
Task: MIL-002#2
Task: MIL-002#3
Task: MIL-002#4
Task: MIL-002#5
Task: MIL-002#6
Task: MIL-002#7
Task: MIL-002#8

2026-10-04 22:04:40 +08:00

2.0 KiB

Raw Blame History

Blackjack

A console Blackjack game against a computer dealer, played with emoji cards. It is the day 11 capstone of Udemy's 100 Days of Code: The Complete Python Pro Bootcamp, built with a plan-first process (milestones and issues in docs/).

House rules

The deck is unlimited; cards are not removed when drawn. No jokers.
Jack, Queen and King count 10. An ace counts 11 or 1.
A two-card hand of ace + 10 is a blackjack.
The computer is the dealer and draws while its score is below 17.

Requirements

Python 3.13 or newer
No runtime dependencies
Optional: Doxygen to build the source documentation
A terminal with UTF-8 and emoji support (for example Windows Terminal)

Setup

Create and activate a local virtual environment, upgrade pip, then install the project in editable mode with the 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 and macOS:

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

Leave the environment with deactivate.

Run

Start the game from the activated virtual environment:

python -m blackjack

Test

python -m unittest discover -s tests

pytest also runs the same tests (python -m pytest).

Lint and type check

ruff check .
ruff format --check .
mypy src

Documentation

Generate the source documentation (Doxygen comments in src/) into docs/doxygen/:

doxygen Doxyfile

Planning documents (business case, stakeholder analysis, project plan and milestones) are in docs/.

Project layout

src/blackjack/   game package (constants.py, ...)
tests/           unit tests
docs/            planning documents and generated Doxygen output
pyproject.toml   project configuration
Doxyfile         Doxygen configuration

License

See LICENSE.

2.0 KiB Raw Blame History