Metadata-Version: 2.4
Name: pio-robo
Version: 0.2.0
Summary: A simple grid-based robot programming environment for teaching Python functions-first.
Author: Edward Withers
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: Education
Classifier: Topic :: Education
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: student
Requires-Dist: pytest<10,>=8; extra == "student"
Provides-Extra: dev
Requires-Dist: pytest<10,>=8; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Dynamic: license-file

# 🤖 Robo – Classroom Programming Environment

A simple Python-based learning environment for teaching programming functions-first through grid-based robot challenges.

## Setup

### Install from PyPI

```bash
pip install robo
```

### Development install

```bash
git clone <repo>
cd robo
pip install -e .
```

## Run a world

From a student project folder:

```bash
python -m robo world1.0
```

Student solution files live in:

```text
exercises/
  world1_0.py
```

## Check progress

```bash
python -m robo summary
```

## Run tests

From the project root:

```bash
python -m pytest
```

Run tests when you:

- add new worlds
- change commands
- change runner/display behaviour

## Contribute

1. Create or edit code.
2. Run the test suite.
3. Check that student worlds still run.
4. Open a pull request.

See the `docs/` folder for pupil-facing command guides and teacher/developer notes.
