nand2tetris-rust

A Rust implementation of the Hack assembler, VM parser, and compiler for the nand2tetris course.

Project Structure

This repository will be organized into separate packages for each part:

• assembler: Hack assembly language to machine code
• vm: VM code parser and translator
• compiler: High-level language compiler

Features

• Assembles Hack assembly language (.asm) files
• Parses and processes VM code (.vm files)
• Will include a compiler for higher-level language support
• Command-line interface

Usage

Build the project:

cargo build --release

Run the assembler:

cargo run --release -- <input.asm> [output.hack]

• <input.asm>: Path to the Hack assembly file
• [output.hack]: Optional output file path (defaults to input filename with .hack extension)

Example

cargo run --release -- examples/Add.asm

Requirements

• Rust (https://rust-lang.org)

License

MIT