hakorune/docs/development/roadmap/phases/phase-10.7/quickstart-property-revolution.md

Phase 10.7 × Property System 革命 - 今すぐ始めるクイックスタート

🎯 Property System革命により実現可能になったPython→Nyash実行

2025-09-18のProperty System革命により、Python transpilationが飛躍的に実現可能に！

🚀 最短実装ルート（3週間で実用レベル）

Week 1: 基本プロパティ認識

# プラグイン作成
cd plugins/
cargo new nyash-python-parser-plugin --lib

# 最小依存関係
echo '[dependencies]
pyo3 = { version = "0.22", features = ["auto-initialize"] }
nyash-plugin-sdk = { path = "../../crates/plugin-sdk" }' >> Cargo.toml

Week 2-3: Property System活用コンパイラ

// src/lib.rs - 最小実装例
use pyo3::prelude::*;

#[pyclass]
pub struct PythonCompilerBox {
    property_classifier: PropertyClassifier,
}

#[pymethods]
impl PythonCompilerBox {
    #[new]
    pub fn new() -> Self {
        Self {
            property_classifier: PropertyClassifier::new(),
        }
    }
    
    pub fn compile_simple(&self, python_code: &str) -> PyResult<String> {
        let ast = self.parse_python(python_code)?;
        let classified = self.property_classifier.classify(ast);
        let nyash_code = self.generate_nyash_with_properties(classified);
        Ok(nyash_code)
    }
}

struct PropertyClassifier;

impl PropertyClassifier {
    fn new() -> Self { Self }
    
    fn classify(&self, ast: PythonAst) -> ClassifiedAst {
        // Phase 1: 基本パターンのみ
        // @property → computed
        // @cached_property → once
        // __init__代入 → stored
        todo!("実装")
    }
}

🧪 MVP テストケース

入力Python

# test_simple.py
class Counter:
    def __init__(self):
        self.value = 0
    
    @property
    def doubled(self):
        return self.value * 2
    
    @functools.cached_property  
    def expensive_result(self):
        return sum(range(1000))

期待されるNyash出力

box Counter {
    value: IntegerBox                                    // stored
    doubled: IntegerBox { me.value * 2 }                // computed  
    once expensive_result: IntegerBox { sum_range(1000) }  // once
    
    birth() {
        me.value = 0
    }
}

実行テスト

# transpilation
nyash --pyc test_simple.py -o test_simple.ny

# ネイティブコンパイル
nyash --compile-native test_simple.ny -o test_app

# 実行（CPython依存なし！）
./test_app

📊 段階的成功指標

Phase 1 (1週間後)

• ✅ @property, @cached_property認識
• ✅ 基本クラス → box変換
• ✅ 1つのサンプルPythonファイルが動作

Phase 2 (2週間後)

• ✅ 継承、メソッド呼び出し対応
• ✅ 10個のサンプルファイル成功
• ✅ 性能測定（CPythonとの比較）

Phase 3 (3週間後)

• ✅ エラーハンドリング、例外処理
• ✅ 実用的なPythonライブラリ部分対応
• ✅ AOT配布可能なサンプルアプリ

🌟 創造的可能性

ハイブリッド開発

# Python側で開発・デバッグ
@nyash.optimize  # デコレータで高速化指定
def heavy_computation(data):
    return complex_algorithm(data)

# 本番はNyash AOTで配布

リアルタイムtranspilation IDE

• 左: Pythonコード編集
• 右: リアルタイムNyash生成表示
• 下: 性能比較グラフ

教育効果

• Pythonユーザーが自然にNyashを学習
• Property Systemの概念理解促進

🎯 今日から始められるアクション

1. プラグイン skelton作成 (30分)
2. pyo3でPython AST取得 (2時間)
3. @property検出ロジック (半日)
4. 最初のbox変換 (1日)
5. テスト実行 (30分)

Property System革命により、この夢が現実になりました！🚀