An open API service indexing awesome lists of open source software.

https://github.com/matcom/gym

Coding gym for MatCom students
https://github.com/matcom/gym

Last synced: 2 months ago
JSON representation

Coding gym for MatCom students

Awesome Lists containing this project

README

          

# 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](#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:

```bash
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.