Skip to content

Python

The py repository implements the curriculum in Python.

Summary

Property Value
Repository dialectic-playground/py
Status Active: Project 00 implemented
File extension .py
Release line Python 3.14
Build / package tool uv
Curriculum Submodule pinned to v1.5.0
Brand accent #3572A5, glyph py; GitHub Linguist #3572A5

Language characteristics

Aspect Python
CLI classification Included
Image category First-Class
Access to OS primitives High (via sys/os/subprocess)
Entry-point mechanism Interpreter maps args to high-level sys.argv list

Toolchain

Environment Toolchain
Container python:3.14-slim-trixie (+ uv), pinned by digest in Containerfile, plus make and python3
Native CI astral-sh/setup-uv, then uv python install 3.14

make toolchain verifies both environments. It checks that every tool is on the release line above.

Project tooling

What each project's Makefile hooks run. Versions are the ones pinned in the repository (lockfile, Containerfile, or CI).

Purpose Tool
Unit tests pytest 9.1.1
Lint ruff 0.17.0 (ruff check, ruff format --check) and mypy 2.4.0 (--strict)
Format ruff format (ruff 0.17.0)
Dependencies One uv project per project (pyproject.toml + committed uv.lock, dev dependency group), installed with uv sync --locked
Build output (BIN_DIR) .venv/bin/ (.venv/Scripts/ on Windows): the console script that uv generates
Install Creates a virtual environment under $(LIBDIR)/py/<project>/ and writes a #!/bin/sh launcher to $(BINDIR)

Implemented projects

A project is implemented once it is listed in IMPLEMENTED in the repository's root Makefile. CI then builds, lints, and tests it in the container and natively on Linux, macOS, and Windows.

# Project Status
00 hello-world Implemented
01 echo Not started
02 cat Not started
03 head-tail Not started
04 wc Not started
05 grep-lite Not started
06 find-lite Not started
07 diff-lite Not started
08 env-run Not started
09 kv-store Not started
10 sys-monitor Not started
11 kinder Not started
12 convert Not started
13 taxes Not started
14 taxes-file Not started
15 stats Not started
16 bargraph Not started
17 stream-filters Not started
18 primes Not started
19 calendar Not started
20 bargraph-grade Not started
21 resistor Not started
22 dice Not started
23 recursion Not started
24 tromino Not started
25 max Not started
26 cars Not started
27 line-wrap Not started
28 cars-modular Not started
29 strlen Not started
30 matmult Not started
31 phone Not started
32 percolation Not started
33 reverse Not started
34 parallel-sort Not started
35 sort-bench Not started
36 page Not started
37 calc Not started
38 sched Not started
39 size Not started
40 relative-file Not started
41 films Not started
42 sales-report Not started
43 linked-list Not started
44 line-editor Not started
45 queue-stack Not started
46 infix Not started
47 bfs Not started
48 astar Not started
49 assert-sort Not started
50 fault-recovery Not started
51 koch Not started
52 spacecraft Not started

Notes

  • uv generates a #! console script on Linux and macOS and a native dp-*.exe launcher on Windows, so BIN_DIR works with the black-box runner on every OS without a hand-written launcher.

See also