ROSE Project

This project is a game that has been developed to assist in teaching kids python. The students need to code the behavior of a car to achieve the best score.

Here is a video of a race (running code from students): (Click on the screenshot to play the video)

In this game, two race cars compete to achieve the most points. The race car must recognize the race track, the obstacles, and the bonus areas; then calculate the best path where the pitfalls are avoided and all the bonus points are collected. The cars move autonomously on the screen within the race track game with no interference from the students. No joystick or mouse shall be used.

In order to control the car movements, the students needs to implement a 'driver'. This code controls the car and will decide what the next action of the car will be.

For each type of obstacles there is a different action and different points assigned.

See examples/README.md for an explanation on how to write a driver module.

GitHub pages

Refer to our GitHub pages for the course materials and additional resources: https://redhat-israel.github.io/ROSE/

Talks and presentations

• Read an interview with Miki Kenneth on People and Computers
• Read Fred Rolland and Ori Rabin's presentation at Open Source Summit Europe 2017
• Read Fred Rolland and Ori Rabin's presentation at August Penguin 2017
• Watch Fred Rolland and Ori Rabin's talk at PyCon Israel 2017
• Read an article by Laura Novich on opensource.com

Requirements

First we need to get pipenv installed. The best way is to install it for your user:

pip install --user pipenv

Now we can use pipenv to install the rest of the dependencies, and create a virtual environment:

pipenv install

You can also install packages from your distribution, but they may be too old.

Running the server

Open a pipenv shell that you'll use for the following commands:

pipenv --python /usr/local/bin/python3.7 shell

Start the server on some machine:

./rose-server

For running the same track for all drivers (instead or random) start the server using:

./rose-server -t same

Open a browser at http://<server-address>:8880 to view and control the game.

Running a driver

Open a pipenv shell that you'll use for the following commands:

pipenv --python /usr/local/bin/python3.7 shell

Start up the client, using your driver file:

./rose-client mydriver.py

The server address can be specified that way (Replace '10.20.30.44' with your server address):

./rose-client -s 10.20.30.44 mydriver.py

For driver modules, see the examples directory.

You can run the game with just 1 driver! To let 2 drivers compete, repeat these commands in 2 terminals.

Command line interface

You can control the game from the command line using the rose-admin tool.

To start a race, use the rose-admin tool on any machine:

./rose-admin <server-address> start

To stop a race, use the rose-admin tool on any machine:

./rose-admin <server-address> stop

To modify the game rate, you can use the "set-rate" command. The following command would change game rate to 10 frames per second:

./rose-admin <server-address> set-rate 10

Creating a tarball

python setup.py sdist

Developing

Should you want to contribute to the project, please read the Code of Conduct.

To install development requirements:

pipenv install --dev

To open a shell for development, use:

pipenv --python /usr/local/bin/python3.7 shell

Before submitting patches, please run the tests:

flake8
pytest

Creating coverage report in html format:

pytest --cov-report html
xdg-open htmlcov/index.html