Sean O'Connor a2442f53ea Add README, .gitignore, and clean up build artifacts
- Added comprehensive README with usage instructions
- Added .gitignore to prevent build artifacts from being committed
- Removed target/ directories and duplicate WASM files
- Cleaned up parser binaries and test files
2025-09-11 11:27:27 -04:00

tree-sitter-hack-assembly

A Tree-sitter grammar for Hack Assembly language as used in the nand2tetris course.

Supported File Types

  • .asm - Hack Assembly source files

Features

  • Syntax highlighting for A-instructions, C-instructions, and labels
  • Code navigation with outline support for symbols and jumps
  • Bracket matching for all syntax elements
  • Integration with Zed editor and other Tree-sitter compatible editors

Usage

This grammar is designed to work with the nand2tetris-zed extension for Zed editor, providing complete language support for the nand2tetris course.

Grammar Details

  • Language: Hack Assembly
  • Scope: source.hack_assembly
  • File Types: .asm
  • Node Types: a_instruction, c_instruction, label_declaration, symbol, constant

Development

Building

# Generate parser
tree-sitter generate

# Build parser
tree-sitter build

# Test grammar
tree-sitter test

Testing

# Run tests
tree-sitter test

# Parse a file
tree-sitter parse example.asm

License

MIT License - see LICENSE file for details.

Description
Tree-sitter grammar for Hack Assembly language (Nand2Tetris)
Readme 24 MiB
Languages
C 79.6%
C++ 11.6%
Rust 3.8%
JavaScript 2.3%
Scheme 2%
Other 0.7%