basic-computer-games/HOW_TO_RUN_THE_GAMES.md

How to run the games

The games in this repository have been translated into a number of different languages. How to run them depends on the target language.

csharp

dotnet command-line

The best cross-platform method for running the csharp examples is with the dotnet command-line tool. This can be downloaded for MacOS, Windows and Linux from dotnet.microsoft.com.

From there, the program can be run by

1. Opening a terminal window
2. Navigating to the corresponding directory
3. Starting with dotnet run

Visual Studio

Alternatively, for non-dotnet compatible translations, you will need Visual Studio which can be used to both open the project and run the example.

1. Open the corresponding .csproj or .sln file
2. Click Run from within the Visual Studio IDE

java

The Java translations can be run via the command line or from an IDE such as Eclipse or IntelJ

To run from the command line, you will need a Java SDK (eg. Oracle JDK or Open JDK).

1. Navigate to the corresponding directory.
2. Compile the program with javac:
   • eg. **```python javac ```** AceyDuceyGame.java
3. Run the compiled program with java:
   • eg. java AceyDuceyGame

or if you are using JDK11 or later you can now execute a self contained java file that has a main method directly with java <filename>.java.

javascript

There are two ways of javascript implementations:

browser

The html examples can be run from within your web browser. Simply open the corresponding .html file from your web browser.

node.js

Some games are implemented as a node.js script. In this case there is no *.html file in the folder.

1. install node.js for your system.
2. change directory to the root of this repository (e.g. cd basic-computer-games).
3. from a terminal call the script you want to run (e.g. node 78_Sine_Wave/javascript/sinewave.mjs).

Hint: Normally javascript files have a *.js extension. We are using *.mjs to let node know , that we are using ES modules instead of CommonJS.

kotlin

Kotlin programs are compiled with the Kotlin compiler, and run with the java runtime, just like java programs. In addition to the java runtime you will need the kotlinc compiler, which can be installed using these instructions.

1. Navigate to the corresponding directory.
2. Compile the program with kotlinc:
   • eg. kotlinc AceyDuceyGame.kt -include-runtime -d AceyDuceyGame.jar
3. Run the compiled program with java:
   • eg. java -jar AceyDuceyGame.jar

pascal

The pascal examples can be run using Free Pascal. Additionally, .lsi project files can be opened with the Lazarus Project IDE.

The pascal examples include both _simple (single-file) and_o**bject-oriented (in the /object-pascaldirectories) examples.

1. You can compile the program from the command line with the fpc command.
   • eg. fpc amazing.pas
2. The output is an executable file that can be run directly.

perl

The perl translations can be run using a perl interpreter (a copy can be downloaded from perl.org) if not already installed.

1. From the command-line, navigate to the corresponding directory.
2. Invoke with the perl command.
   • eg. perl aceyducey.pl

python

The python translations can be run from the command line by using the py interpreter. If not already installed, a copy can be downloaded from python.org for Windows, MacOS and Linux.

1. From the command-line, navigate to the corresponding directory.
2. Invoke with the py or python interpreter (depending on your python version).
   • eg. py acey_ducey_oo.py
   • eg. python aceyducey.py

Note { "MD013": false } Some translations include multiple versions for python, such as acey ducey which features versions for Python 2 (aceyducey.py) and Python 3 (acey_ducey.py) as well as an extra object-oriented version (acey_ducey_oo.py).

You can manage and use different versions of python with pip.

ruby

If you don't already have a ruby interpreter, you can download it from the ruby project site.

1. From the command-line, navigate to the corresponding directory.
2. Invoke with the ruby tool.
   • eg. ruby aceyducey.rb

vbnet

Follow the same steps as for the csharp translations. This can be run with dotnet or Visual Studio.

rust

If you don't already have Rust on your computer, you can follow the instruction on Rust Book

1. From the command-line, navigate to the corresponding directory.
2. Run the following command.
   • cargo run