Time Warp IDE – Complete Environment for Old-School Coding

1 month ago 2

Compile Educational Programming Languages to Native Executables

TimeWarp Compiler is a command-line tool that compiles educational programming languages (PILOT, BASIC, Logo) to native Linux executables. Transform your educational code into standalone programs that run without interpreters.

🎯 Multi-Language Compilation

Compile 3 educational programming languages to native executables:

PILOT - Educational language with turtle graphics (1960s)
BASIC - Classic line-numbered programming (1960s)
Logo - Educational turtle graphics language (1960s)

GCC Compilation - Generate optimized C code and compile to native executables
Cross-Platform - Linux executables (easily extensible to other platforms)
No Runtime Dependencies - Standalone binaries that run anywhere

Comprehensive examples demonstrating language features:

BASIC: Hello world, arrays, functions, loops
Logo: Shapes, complex drawings, fractals
PILOT: Math quizzes, interactive adventures

Option 1: PyPI (Recommended)

git clone https://github.com/James-HoneyBadger/Time_Warp.git cd Time_Warp pip install -e .

Python: 3.9 or higher
GCC: GNU C Compiler (build dependency)
OS: Linux (executables), macOS/Windows (compilation)

# Compile a BASIC program timewarp-compiler hello.bas -o hello # Compile a Logo program timewarp-compiler drawing.logo -o logo_app # Compile a PILOT program timewarp-compiler quiz.pilot -o math_quiz

timewarp-compiler [OPTIONS] INPUT_FILE Options: -o, --output OUTPUT Output executable name (default: same as input) --list-languages List supported languages and exit --version Show version information -h, --help Show help message

Supported File Extensions

.bas - BASIC programs
.logo - Logo programs
.pilot - PILOT programs

10 PRINT "HELLO WORLD BASIC PROGRAM" 20 PRINT "This demonstrates basic BASIC features" 30 LET ANSWER = 21 * 2 40 PRINT "The answer is: "; ANSWER 50 INPUT "Enter your name"; NAME$ 60 PRINT "Hello, "; NAME$ 70 PRINT "Counting from 1 to 5:" 80 FOR I = 1 TO 5 90 PRINT I 100 NEXT I 110 PRINT "Done!" 120 END

10 DIM SCORES(10) 20 FOR I = 1 TO 10 30 SCORES(I) = I * 10 40 NEXT I 50 PRINT "Scores:" 60 FOR I = 1 TO 10 70 PRINT "Score"; I; ": "; SCORES(I) 80 NEXT I 90 END

TO SQUARE :SIZE REPEAT 4 [FORWARD :SIZE RIGHT 90] END TO TRIANGLE :SIZE REPEAT 3 [FORWARD :SIZE RIGHT 120] END TO CIRCLE :RADIUS REPEAT 36 [FORWARD (2 * 3.14159 * :RADIUS / 36) RIGHT 10] END SQUARE 100 TRIANGLE 80 CIRCLE 50

TO TREE :SIZE IF :SIZE < 5 [STOP] FORWARD :SIZE RIGHT 25 TREE :SIZE * 0.7 LEFT 50 TREE :SIZE * 0.7 RIGHT 25 BACK :SIZE END TREE 100

R: PILOT Math Quiz R: Test your arithmetic skills *START T: Welcome to the Math Quiz! T: Answer the following questions: T: What is 5 + 3? A: Your answer C: #CORRECT = 8 J: (#ANS = #CORRECT) *CORRECT T: Sorry, 5 + 3 = 8 J: *NEXT *CORRECT T: Correct! 5 + 3 = 8 *NEXT T: What is 10 - 4? A: Your answer C: #CORRECT = 6 J: (#ANS = #CORRECT) *CORRECT2 T: Sorry, 10 - 4 = 6 J: *END *CORRECT2 T: Excellent! 10 - 4 = 6 *END T: Quiz complete! E:

R: Choose Your Own Adventure *BEGIN T: You find yourself in a dark forest. T: Do you go LEFT or RIGHT? A: Your choice (LEFT/RIGHT) J: (*ANS = LEFT) *LEFT_PATH J: (*ANS = RIGHT) *RIGHT_PATH T: Please choose LEFT or RIGHT J: *BEGIN *LEFT_PATH T: You find a treasure chest! T: Congratulations! E: *RIGHT_PATH T: You encounter a dragon! T: Game Over! E:

Parse Source - Language-specific parsing of source code
Generate C Code - Convert to optimized C with runtime libraries
Compile Executable - GCC compilation to native binary
Standalone Binary - No external dependencies required

BaseCompiler - Abstract framework for language implementations
BasicCompiler - Line-numbered BASIC with arrays and functions
LogoCompiler - Turtle graphics with procedures and recursion
PilotCompiler - Educational language with branching and variables

Each language includes optimized C runtime libraries for:

String manipulation and I/O
Mathematical operations
Turtle graphics rendering (PPM format)
Variable management and scope

Compiler Usage Guide

# Clone repository git clone https://github.com/James-HoneyBadger/Time_Warp.git cd Time_Warp # Install in development mode pip install -e . # Run tests python -m pytest # Build package python -m build

# Test all compilers python -m pytest tests/ # Test specific language python -c "from timewarp_ide.compiler import compile_file; compile_file('samples/basic/hello.bas', 'test_output')"