204 lines
7.3 KiB
Markdown
204 lines
7.3 KiB
Markdown
# Phase 20 Python Integration - INDEX
|
||
|
||
## 📋 全体概要
|
||
|
||
**Phase 20: Python-Hakorune統合** - PythonのAST/木構造をHakoruneに落とし、Python-Hakorune間の相互運用を実現するフェーズです。
|
||
|
||
**出典**: 旧Phase 10.5（Phase 10.1系）の内容を整理・再編成
|
||
|
||
## 🗂️ フォルダ構成
|
||
|
||
```
|
||
phase-20-python-integration/
|
||
├── README.md # ⭐ メインドキュメント
|
||
├── INDEX.md # このファイル
|
||
│
|
||
├── 📁 planning/ # 計画・設計
|
||
│ ├── README.md
|
||
│ ├── integrated-plan.md # ChatGPT5統合計画
|
||
│ ├── python-parser-plan-summary.md # パーサー計画サマリー
|
||
│ ├── python-parser-box-design.md # パーサーBox設計
|
||
│ └── expert-feedback.md # AI専門家フィードバック
|
||
│
|
||
├── 📁 parser-integration/ # パーサー統合
|
||
│ ├── README.md
|
||
│ ├── implementation-plan.md # 実装計画
|
||
│ └── builtin-box-flow.md # ビルトインBox実装フロー
|
||
│
|
||
├── 📁 core-implementation/ # コア実装
|
||
│ ├── README.md
|
||
│ └── implementation-roadmap.md # 実装ロードマップ
|
||
│
|
||
├── 📁 transpiler/ # トランスパイラー
|
||
│ ├── README.md
|
||
│ └── python-to-hakorune-spec.md # Python→Hakorune変換仕様
|
||
│
|
||
├── 📁 design/ # 設計ドキュメント
|
||
│ ├── README.md
|
||
│ ├── abi-design.md # ABI設計
|
||
│ ├── native-build-consolidation.md # ネイティブビルド
|
||
│ └── handle-first-plugininvoke-plan.md # Handle-First設計
|
||
│
|
||
├── 📁 testing/ # テスト計画
|
||
│ └── README.md
|
||
│
|
||
└── 📁 documentation/ # ドキュメント計画
|
||
└── README.md
|
||
```
|
||
|
||
## 🎯 クイックナビゲーション
|
||
|
||
### 🚀 初めての方へ
|
||
1. [メインREADME](README.md) - 全体概要を理解
|
||
2. **[強化版アーキテクチャv2](design/enhanced-architecture-v2.md)** - ChatGPT Pro最新設計（推奨）
|
||
3. [マイルストーン](planning/milestones.md) - M0〜M6実装計画
|
||
4. [Planning README](planning/README.md) - 計画の詳細を確認
|
||
5. [統合計画](planning/integrated-plan.md) - ChatGPT5による詳細計画
|
||
|
||
### 🏗️ 設計を知りたい
|
||
- **[強化版アーキテクチャv2](design/enhanced-architecture-v2.md)** ⭐ ChatGPT Pro最新設計（2025-10-02）
|
||
- [ABI設計](design/abi-design.md) - Python-Hakorune間のABI
|
||
- [Handle-First設計](design/handle-first-plugininvoke-plan.md) - プラグイン呼び出し設計
|
||
- [ネイティブビルド](design/native-build-consolidation.md) - AOT/EXE生成
|
||
- [メタ設定例](design/meta-config-examples.md) - hako.toml設定リファレンス
|
||
- [リスクと対策](design/risks-and-mitigations.md) - 既知のリスクと対策
|
||
|
||
### 💻 実装を見たい
|
||
- [パーサー実装計画](parser-integration/implementation-plan.md) - PythonパーサーBox
|
||
- [コア実装ロードマップ](core-implementation/implementation-roadmap.md) - PyRuntimeBox/PyObjectBox
|
||
- [トランスパイラー仕様](transpiler/python-to-hakorune-spec.md) - Python→Hakorune変換
|
||
|
||
### 🧪 テストについて
|
||
- [テスト計画](testing/README.md) - テスト戦略とチェックリスト
|
||
|
||
### 📚 ドキュメントについて
|
||
- [ドキュメント計画](documentation/README.md) - ドキュメント構成
|
||
|
||
## 📊 実装ステータス
|
||
|
||
| カテゴリ | コンポーネント | ステータス |
|
||
|---------|--------------|----------|
|
||
| **計画** | 設計・計画書 | ✅ 完了 |
|
||
| **計画** | 強化版アーキテクチャv2 | ✅ 完了（2025-10-02）|
|
||
| **計画** | マイルストーン（M0-M6） | ✅ 完了（2025-10-02）|
|
||
| **設計** | ABI設計 | ✅ 完了 |
|
||
| **設計** | Handle-First | ✅ 完了 |
|
||
| **設計** | ネイティブビルド | ✅ 完了 |
|
||
| **設計** | メタ設定例 | ✅ 完了（2025-10-02）|
|
||
| **設計** | リスク管理 | ✅ 完了（2025-10-02）|
|
||
| **実装** | PyRuntimeBox | 📅 未実装（M0予定）|
|
||
| **実装** | PyObjectBox | 📅 未実装（M0予定）|
|
||
| **実装** | PythonパーサーBox | 📅 未実装（M4予定）|
|
||
| **実装** | トランスパイラー | 📅 未実装 |
|
||
| **テスト** | ユニットテスト | 📅 未実装 |
|
||
| **テスト** | 統合テスト | 📅 未実装 |
|
||
| **ドキュメント** | ユーザーガイド | 📅 未実装 |
|
||
| **ドキュメント** | APIリファレンス | 📅 未実装 |
|
||
|
||
## 🎯 主要コンポーネント
|
||
|
||
### 1. PyRuntimeBox
|
||
**目的**: Python実行環境の提供
|
||
|
||
```hakorune
|
||
box PyRuntimeBox {
|
||
eval(code: StringBox) -> PyObjectBox
|
||
import(name: StringBox) -> PyObjectBox
|
||
}
|
||
```
|
||
|
||
### 2. PyObjectBox
|
||
**目的**: Pythonオブジェクトの管理
|
||
|
||
```hakorune
|
||
box PyObjectBox {
|
||
getattr(name: StringBox) -> PyObjectBox
|
||
setattr(name: StringBox, value: PyObjectBox)
|
||
call(args: ArrayBox) -> PyObjectBox
|
||
to_string() -> StringBox
|
||
to_int() -> IntegerBox
|
||
}
|
||
```
|
||
|
||
### 3. PythonパーサーBox
|
||
**目的**: Python AST → Hakorune MIR変換
|
||
|
||
```hakorune
|
||
box PythonParserBox {
|
||
parse(code: StringBox) -> ASTBox
|
||
to_hakorune_ast(ast: ASTBox) -> HakoruneASTBox
|
||
to_mir(ast: ASTBox) -> MIRBox
|
||
}
|
||
```
|
||
|
||
### 4. トランスパイラー
|
||
**目的**: Python構文 → Hakorune構文変換
|
||
|
||
```hakorune
|
||
box PythonTranspiler {
|
||
transpile(python_code: StringBox) -> StringBox
|
||
}
|
||
```
|
||
|
||
## ⚠️ 現在のステータス
|
||
|
||
**保留中** - Phase 15（Hakoruneセルフホスティング）完了後に着手予定
|
||
|
||
### 保留理由
|
||
1. **優先度**: まずHakorune自身の基盤を固める
|
||
2. **依存関係**: セルフホスティング実現が先決
|
||
3. **リソース**: 段階的に実装する方が安全
|
||
|
||
### 再開条件
|
||
- ✅ Phase 15完了（Rust VM + LLVM 2本柱体制確立）
|
||
- ✅ セルフホスティング実現
|
||
- ✅ プラグインシステム安定化
|
||
|
||
## 🔗 関連Phase
|
||
|
||
### 前提Phase
|
||
- [Phase 15 - セルフホスティング](../phase-15/) - 現在進行中
|
||
- [Phase 12 - TypeBox統合](../phase-12/) - 完了
|
||
|
||
### 後続Phase（予定）
|
||
- Phase 21 - 箱データベース
|
||
- Phase 22+ - 未定
|
||
|
||
## 📚 元資料
|
||
|
||
このPhase 20は以下の旧資料を整理・統合したものです：
|
||
|
||
- **元の場所**: `docs/archive/phases/phase-10.5/phase-10.5/`
|
||
- **旧Phase名**: Phase 10.5（Phase 10.1系を再編成）
|
||
- **作成時期**: 2025年8月頃
|
||
- **主要貢献者**: ChatGPT5, Gemini, Codex
|
||
|
||
## 🎯 将来の展望
|
||
|
||
### 短期目標（Phase 15後）
|
||
1. PyRuntimeBox基本実装
|
||
2. PyObjectBox基本実装
|
||
3. 基本的なPython呼び出し動作
|
||
|
||
### 中期目標
|
||
1. PythonパーサーBox実装
|
||
2. Python AST → Hakorune MIR変換
|
||
3. トランスパイラー実装
|
||
|
||
### 長期目標
|
||
1. Python-Hakoruneシームレス統合
|
||
2. Pythonライブラリの完全活用
|
||
3. ハイブリッド開発の実現
|
||
|
||
## 📞 お問い合わせ
|
||
|
||
- **メインドキュメント**: [README.md](README.md)
|
||
- **マスタープラン**: [00_MASTER_ROADMAP.md](../00_MASTER_ROADMAP.md)
|
||
- **現在のフェーズ**: [Phase 15](../phase-15/)
|
||
|
||
---
|
||
|
||
**最終更新**: 2025-10-02
|
||
**整理者**: Claude Code
|
||
**ステータス**: 計画済み・実装待ち
|