GitHub – James-HoneyBadger/Time_Warp: 🚀

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.

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

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

• .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:

1. Parse Source – Language-specific parsing of source code
2. Generate C Code – Convert to optimized C with runtime libraries
3. Compile Executable – GCC compilation to native binary
4. 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

# 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')"

1. Create compiler class inheriting from BaseCompiler
2. Implement parse_source() and generate_c_code() methods
3. Add file extension mapping in compiler.py
4. Include runtime library functions
5. Add comprehensive tests

We welcome contributions! Please see our Contributing Guide.

• New Languages – Add support for additional educational languages
• Performance – Optimize compilation and runtime performance
• Platforms – Extend support to Windows/macOS executables
• Features – Enhanced language features and capabilities
• Documentation – Improve guides and examples

TimeWarp Compiler is open source software licensed under the MIT License. See LICENSE for details.

• PILOT: Inspired by the original educational programming language
• BASIC: Based on classic BASIC implementations
• Logo: Built on the turtle graphics paradigm
• GCC: For the excellent C compilation toolchain
• Python Community: For the robust packaging ecosystem

⏰ TimeWarp Compiler – Transform educational code into native executables.