tomoaki/hakorune
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
ef44801fa698dcf9176cf039eabac9ce4b8f727d
hakorune/src/llvm_py
History
Selfhosting Dev ef44801fa6 ✨ Python LLVM backend implementation (experimental) 
- Created llvmlite-based LLVM backend in src/llvm_py/
- Implemented all MIR14 instructions (const, binop, jump, branch, ret, compare, phi, call, boxcall, externcall, typeop, newbox, safepoint, barrier)
- Experimental LoopForm support
- ~2000 lines of clean Python code vs complex Rust/inkwell
- Useful for PHI/SSA validation and rapid prototyping
- Added documentation to CLAUDE.md

This was created while waiting for ChatGPT's investigation of BuilderCursor issues.
2025-09-12 20:55:13 +09:00
..
instructions
✨ Python LLVM backend implementation (experimental)
2025-09-12 20:55:13 +09:00
llvm_builder.py
✨ Python LLVM backend implementation (experimental)
2025-09-12 20:55:13 +09:00
mir_reader.py
✨ Python LLVM backend implementation (experimental)
2025-09-12 20:55:13 +09:00
README.md
llvm: unify lowering via Resolver and Cursor; remove non-sealed PHI wiring; apply Resolver to extern/call/boxcall/arrays/maps/mem; add llvmlite harness docs; add LLVM layer overview; add LoopForm preheader
2025-09-12 20:40:48 +09:00
resolver.py
llvm: unify lowering via Resolver and Cursor; remove non-sealed PHI wiring; apply Resolver to extern/call/boxcall/arrays/maps/mem; add llvmlite harness docs; add LLVM layer overview; add LoopForm preheader
2025-09-12 20:40:48 +09:00
test_boxcall.json
✨ Python LLVM backend implementation (experimental)
2025-09-12 20:55:13 +09:00
test_minimal.json
✨ Python LLVM backend implementation (experimental)
2025-09-12 20:55:13 +09:00
test_simple.py
llvm: unify lowering via Resolver and Cursor; remove non-sealed PHI wiring; apply Resolver to extern/call/boxcall/arrays/maps/mem; add llvmlite harness docs; add LLVM layer overview; add LoopForm preheader
2025-09-12 20:40:48 +09:00

README.md

LLVM Python Backend (Experimental)

📝 概要

Rust/inkwellの複雑性を回避し、llvmliteを使ってシンプルに実装する実験的バックエンド。 ChatGPTが設計したdocs/LLVM_LAYER_OVERVIEW.mdの設計原則に従う。

🎯 目的

  1. 検証ハーネス - PHI/SSA構造の高速検証
  2. プロトタイプ - 新機能の迅速な試作
  3. 教育的価値 - シンプルで理解しやすい実装
  4. バックアップ - Rustが詰まった時の代替案

📂 構造

llvm_py/
├── README.md          # このファイル
├── mir_reader.py      # MIR JSON読み込み
├── llvm_builder.py    # メインのLLVM IR生成
├── resolver.py        # Resolver API（Python版）
├── types.py          # 型変換ユーティリティ
└── test_simple.py    # 基本テスト

🚀 使い方

# MIR JSONからオブジェクトファイル生成
python src/llvm_py/llvm_builder.py input.mir.json -o output.o

# 環境変数で切り替え（将来）
NYASH_LLVM_USE_HARNESS=1 ./target/release/nyash program.nyash

📋 設計原則（LLVM_LAYER_OVERVIEWに準拠）

  1. Resolver-only reads - 直接vmapアクセス禁止
  2. Localize at block start - BB先頭でPHI生成
  3. Sealed SSA - snapshot経由の配線
  4. BuilderCursor相当 - 挿入位置の厳格管理

🎨 実装状況

  • 基本構造（MIR読み込み）
  • Core-14命令の実装
  • Resolver API
  • LoopForm対応
  • テストスイート

📊 予想行数

  • 全体: 800-1000行
  • コア実装: 300-400行

「簡単最高」の精神を体現！