Tirsvad
3c99040b96
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
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.