The Gymnasium

Welcome to The Gymnasium! This is the place to solve programming exercises and get immediate, test-driven feedback.

Getting Started

1. Fork this repository.
2. Clone your fork OR use the Online Development mode.
3. Solve the exercises in the exercises/ directory.
4. Run tests locally or online to verify your solutions.
5. Push your changes and create a Pull Request to the main repository to see your score on the leaderboard!

Online Development

You can solve exercises directly in your browser without installing anything:

1. On your fork's GitHub page, press the . key on your keyboard.
2. This will open a web-based VS Code environment (github.dev).
3. Navigate to an exercise (e.g., exercises/hello_world/solution.py).
4. Implement your solution.
5. Use the Source Control tab in the sidebar to commit and push your changes.
6. To run the self-tests, open a terminal in the browser (if available) or simply rely on the Pull Request feedback.

Local Development

To run tests locally, you need Python 3.12+. Navigate to an exercise folder and run:

python solution.py

Structure

• exercises/: Contains the exercise folders. Each folder has a README.md with instructions and a solution.py stub.
• docs/: Documentation site files.
• scripts/: Internal infrastructure scripts.