Tirsvad-Udemy-100-days-of-code/018-turtle

T

Tirsvad a34bf6bbc2 Add draw_square and draw_dashed_line with tests

Challenge 1 draws four sides and turns right 90 degrees after each. Challenge 2 puts
the pen down for a dash and up for a gap and leaves it down at the end. Lengths and
counts come from constants.py; invalid values raise ValueError.

Task: MIL-002#3
Task: MIL-002#4
Task: MIL-002#5

2026-10-07 23:58:52 +08:00

.github/workflows

Add the continuous integration workflow

2026-10-07 23:58:40 +08:00

docs

Resolve pending commit links

2026-10-07 23:58:35 +08:00

framework @ ce1f9ddd3c

Add the framework submodule

2026-10-07 23:58:30 +08:00

src/turtle_challenges

Add draw_square and draw_dashed_line with tests

2026-10-07 23:58:52 +08:00

tests

Add draw_square and draw_dashed_line with tests

2026-10-07 23:58:52 +08:00

.gitignore

Add project configuration, .gitignore and the package skeleton

2026-10-07 23:58:37 +08:00

.gitmodules

Add the framework submodule

2026-10-07 23:58:30 +08:00

Doxyfile

Add the Doxygen configuration

2026-10-07 23:58:40 +08:00

LICENSE

Initial commit

2026-10-07 16:37:09 +02:00

pyproject.toml

Add project configuration, .gitignore and the package skeleton

2026-10-07 23:58:37 +08:00

README.md

Write the README from the agreed template

2026-10-07 23:58:41 +08:00

README.md

Turtle Challenges

Solutions to the five turtle graphics challenges of day 18 of Udemy's 100 Days of Code: The Complete Python Pro Bootcamp: draw a square, draw a dashed line, draw different shapes, generate a random walk and draw a spirograph. The code is small, readable and tested, keeps the function names of the assignment, and needs nothing beyond the Python standard library to run.

Requirements

Python 3.13 or later, with Tk (tkinter), which the turtle module draws with. The Windows and macOS installers include it; on Debian it is the python3-tk package.
git, to clone the repository.
No runtime dependencies. The development tools (pytest, ruff, mypy) are installed by the dev extra in the steps below.
Doxygen, only to build the source documentation.

Set up

The same four steps on every system: clone, create a local virtual environment named .venv, upgrade pip inside it, and install the project in editable mode with its development tools. The virtual environment keeps the project's packages apart from every other Python project on the machine; do not install them system-wide.

The Windows PowerShell steps are the ones the author has run. The Debian and macOS steps use the same Python commands but have not been verified.

Windows PowerShell

git clone https://github.com/Tirsvad-Udemy-100-days-of-code/018-turtle.git
cd 018-turtle
py -3.13 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

If PowerShell refuses to run Activate.ps1 because scripts are disabled, allow scripts for this window only and activate again:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned
.\.venv\Scripts\Activate.ps1

The prompt starts with (.venv) while the environment is active. Type deactivate to leave it. Activate it again in every new terminal before you run the project.

Linux Debian

sudo apt update
sudo apt install --yes git python3 python3-venv python3-tk
git clone https://github.com/Tirsvad-Udemy-100-days-of-code/018-turtle.git
cd 018-turtle
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

Check that python3 --version prints 3.13 or later. If the package manager offers an older Python, install 3.13 another way (for example with pyenv) before creating the environment.

MacOS

brew install git python@3.13 python-tk@3.13
git clone https://github.com/Tirsvad-Udemy-100-days-of-code/018-turtle.git
cd 018-turtle
python3.13 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

Run

There is no challenge to run yet: the challenges arrive with milestones 002 to 004. To check the set-up, run the tests described in the next section.

Run the tests

The tests never open a window. With the virtual environment active:

python -m pytest

The same checks as in continuous integration:

ruff check .
ruff format --check .
mypy

Continuous integration

.github/workflows/ci.yml runs on every push to main and on every pull request. It is read by both GitHub Actions and Gitea Actions. It sets up Python 3.13, upgrades pip, installs the project with its development tools, then runs ruff (lint and format check), mypy, pytest and the Doxygen build. No step opens a turtle window.

Build the source documentation

The source carries Doxygen comments, and the Doxyfile builds them, with this README as the main page. Install Doxygen first (winget install DimitriVanHeesch.Doxygen on Windows, sudo apt install doxygen on Debian, brew install doxygen on macOS), then run from the repository root:

doxygen Doxyfile

Open build/html/index.html in a browser. Any Doxygen warning fails the build, so every module, function and constant has to stay documented.

Project layout

.
├── .github/workflows/ci.yml   continuous integration
├── docs/                      project documents: business case, plan, milestones
├── src/turtle_challenges/     the package
│   └── constants.py           every constant of the project
├── tests/                     pytest tests
├── Doxyfile                   Doxygen configuration
├── pyproject.toml             project, tool and dependency configuration
└── LICENSE

The framework/ folder is a git submodule with the quality framework that the documents in docs/ follow. The project does not need it to run, test or build.

License

GNU Affero General Public License version 3. See the LICENSE file.