tomoaki/hakorune
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
3ba96d9a03efd0a859a39588bf181691223457d6
hakorune/src/llvm_py
History
Selfhosting Dev 3ba96d9a03 🚀 feat: Multiple improvements for Nyash parser and LLVM backend 
Parser improvements:
- Added expression statement fallback in parse_statement() for flexible syntax
- Fixed ternary operator to use PeekExpr instead of If AST (better lowering)
- Added peek_token() check to avoid ?/?: operator conflicts

LLVM Python improvements:
- Added optional ESC_JSON_FIX environment flag for string concatenation
- Improved PHI generation with better default handling
- Enhanced substring tracking for esc_json pattern

Documentation updates:
- Updated language guide with peek expression examples
- Added box theory diagrams to Phase 15 planning
- Clarified peek vs when syntax differences

These changes enable cleaner parser implementation for self-hosting,
especially for handling digit conversion with peek expressions instead
of 19-line if-else chains.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-14 19:16:32 +09:00
..
instructions
🚀 feat: Multiple improvements for Nyash parser and LLVM backend
2025-09-14 19:16:32 +09:00
pyvm
🚀 feat: Multiple improvements for Nyash parser and LLVM backend
2025-09-14 19:16:32 +09:00
__init__.py
docs: update CURRENT_TASK with Box Theory PHI plan (defer/finalize) and MIR v0.5 type meta; add parity tooling and PyVM scaffolding
2025-09-14 04:51:33 +09:00
llvm_builder.py
🚀 feat: Multiple improvements for Nyash parser and LLVM backend
2025-09-14 19:16:32 +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
🔧 refactor(llvm-py): Fix resolver PHI handling and add trace improvements
2025-09-14 16:25:21 +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行

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