testsAndMisc/python_pkg/sql_drills

sql_drills

MySQL 8 practice drills graded like an online judge: the query's output must match the expected text exactly. Engine: Docker image mysql:8.0.33 (pinned on purpose; do not bump). Needs Docker and your user in the docker group.

python3 -m python_pkg.sql_drills start               # container + wait (<60 s)
python3 -m python_pkg.sql_drills list                # ids and titles
python3 -m python_pkg.sql_drills show 01             # task, schema, output sample
python3 -m python_pkg.sql_drills check 01 my.sql     # grade my.sql (exit 0 = pass)
python3 -m python_pkg.sql_drills stop                # remove the container

Drills are addressed by full id (01_pivot_sum) or leading number (01).

Grading rules

Output is mysql -B -N style: no header, tab separators become single spaces, NULL prints as NULL, trailing whitespace is stripped per line. Nothing else is normalised: case, decimal places and row order are strict, so add the ORDER BY the task asks for. On mismatch you get an expected vs actual diff per line. A fresh database is built for every check.

Layout

• fixtures/<id>/ holds DOCS-task.md, schema.sql, expected.txt.
• Reference solutions live only in tests/solutions/; show and check never print them.
• tests/test_live.py runs every reference against the container (marker docker, skipped when the container is down).