Skip to content

README.md

Latest commit

 

History

History
36 lines (25 loc) · 1.36 KB

README.md

File metadata and controls

36 lines (25 loc) · 1.36 KB

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.