Skip to content

matcom/hulk

Repository files navigation

HULK (Havana University Language for Kompilers)

Release Pipeline License: CC BY-SA 4.0 Python 3.13+ Rust 2021 Docs: GitHub Pages

HULK is a didactic, type-safe, object-oriented, and incremental programming language designed for teaching compiler construction at the university level.

Project Architecture

The project follows a literate programming approach, where the implementation is embedded within the documentation itself.

  • Frontend (HULK): Implemented in Python 3.13+, focusing on lexing, parsing, and semantic analysis.
  • Backend (Banner IR): A stack-based virtual machine implemented in Rust for high performance and safety.
  • Literate Engine: Uses illiterate to tangle code from Quarto (.qmd) files in pages/ into the src/ directory.

Getting Started

To set up the development environment, ensure you have the following installed:

  • Python 3.13+ (and uv)
  • Rust (and cargo)
  • Quarto
  • Node.js (for VS Code extension development)

Run the full build and test suite:

make all

Documentation

License

HULK is licensed under CC BY-SA 4.0.

Packages

 
 
 

Contributors