TrekBot is a tool to exercise the vintage computer game 'superstartrek'. It acts as a player, and plays repeated games to exercise all corners of the game.

TrekBasic Family

TrekBasic is part of the TrekBasic family of BASIC programming tools.

LOGO	Project	Description	Language	Interpreter	Compiler
	TrekBasic	Basic compiler and interpreter	Python	Yes	Yes
	TrekBasicJ	Basic compiler and interpreter	Java	Yes	Yes
	BasicRS	Basic compiler and interpreter	Rust	Yes	Yes
	BasicTestSuite	A test suite for Basic	BASIC	-	-
	TrekBot	A tool to exercise the superstartrek program	Rust	-	-

All versions, interpreted and compiled, are intended to by byte-by-byte compatible, but are not there yet - but they are close. TrekBot and BasicTestSuite are part of the plan to ensure full compatibility.

Running TrekBot

To run with coverage:

cargo run -- benchmark --program ../BasicRS/superstartrek.bas --games 5 --coverage-file coverage.json

Full command with more options

cargo run -- benchmark --program superstartrek.bas --display --max-turns 1000 --strategy random --interpreter basic-rs --basicrs-path /Users/tomhill/RustroverProjects/BasicRS/target/debug/basic_rs  --coverage-file coverage.json
# Generate reports

Code Coverage Report

These both generate a code coverage report. The code coverage report generator is part of the various basic implementions. You'll need to run it from the BASIC interpreter directory, and point to the coverage file generated by TrekBot.

In this case, BasicRS is next to TrekBot:

cd ../BasicRS
cargo run --bin basic_coverage -- ../TrekBot/coverage.json superstartrek.bas --verbose

cargo run --bin basic_coverage -- ../TrekBot/coverage.json superstartrek.bas --html coverage_report.html