Gofra

A Stack-based compiled programming language

Project is made for FUN and educational purposes! Don`t expect anything cool from it and just try/contribute

Overview

Gofra is a concatenative (stack-based) programming language that compiles to native code. Programs are written using Reverse Polish notation, where operations follow their operands (e.g 2 + 2 is 2 2 +).

Quick start

Here's a simple "Hello, World!" example:

include "std.gof"

func void main
    "Hello, World!\n" print
end

Features

• Low-level - Write unsafe, low-level code with direct memory access
• Native Compilation - Generates optimized native assembly code
• Type Safety - Validates stack usage and type correctness at compile time
• C FFI - Seamless integration with C libraries (including libc)

Platform support

Gofra currently supports native compilation (no cross-compilation yet). You must compile on the same platform as your target:

• x86_64 (Linux)
• AArch64 macOS (Darwin)

Prerequirements

Before installing Gofra, ensure you have the following tools available system-wide:

• Python >3.12.x
• GNU/Mach-O Linker (ld) - For linking compiled objects
• Assembler (as) - Typically included with Clang LLVM compiler

Installation

For full installation steps, please visit Installation page

Gofra is distributed as single Python-based toolchain. To install:

(Step 1): Install toolchain

pip install gofra

(Step 2): Verify Installation

gofra --help