How exercism/python works
Project type and purpose
• This repo is not a web app or microservice but an open-source content and tooling platform (“Python Track”) for Exercism.
• It contains all the Markdown, JSON, Python code, templates, and scripts needed to define, generate, test, and maintain Python “concept” and “practice” exercises.
High-level file-structure analysis
• Top‐level directories:
• concepts/ – source for “concept” exercises (small focused learning modules)
• exercises/ – source for “practice” exercises, with subdirs for each problem, including metadata (.meta), docs, code & tests
• bin/ – Python scripts to generate tests, fetch or validate config, run exercise‐generation pipelines
• config/ – Jinja2 templates for generating README, instructions, test harnesses
• .github/workflows/ – CI workflows for exercise‐checks, linting, configlet, dependence updates
• docs/ – track‐level documentation and instructions for contributors
• docker-compose.yml – local development environment to spin up containers (test-runner, representer, analyzer)
• config.json – manifests which exercises are concept vs practice; ordering; dependencies
README insights
• Purpose: host all instructions, tests, code, and support files for Python exercises on Exercism
• Tooling: test-runner, representer, analyzer (track tooling), all run under Python 3.11.5
• CI: uses GitHub Actions to run “Exercises check” workflow, configlet, issue commenter, stale issues, etc.