d90216e9c4
## 主な変更点 ### 🎯 戦略の転換と明確化 - PyVMを開発ツールとして位置づけ（本番経路ではない） - EXE-first戦略を明確に優先（build_compiler_exe.sh実装済み） - Phase順序の整理: 15.2(LLVM)→15.3(コンパイラ)→15.4(VM) ### 🚀 セルフホスティング基盤の実装 - apps/selfhost-compiler/にNyashコンパイラMVP実装 - compiler.nyash: メインエントリー（位置引数対応） - boxes/: parser_box, emitter_box, debug_box分離 - tools/build_compiler_exe.sh: ネイティブEXEビルド＋dist配布 - Python MVPパーサーStage-2完成（local/if/loop/call/method/new） ### 📝 ドキュメント整備 - Phase 15 README/ROADMAP更新（Self-Hosting優先明記） - docs/guides/exe-first-wsl.md: WSLクイックスタート追加 - docs/private/papers/: 論文G～L、爆速事件簿41事例収録 ### 🔧 技術的改善 - JSON v0 Bridge: If/Loop PHI生成実装（ChatGPT協力） - PyVM/llvmliteパリティ検証スイート追加 - using/namespace機能（gated実装、Phase 15では非解決） ## 次のステップ 1. パーサー無限ループ修正（未実装関数の実装） 2. EXEビルドとセルフホスティング実証 3. c0→c1→c1'ブートストラップループ確立 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
68 lines
2.3 KiB
Markdown
68 lines
2.3 KiB
Markdown
# Nyash Style Guide (Phase 15)
|
||
|
||
Goals
|
||
- Keep Nyash sources readable and structured. Favor simple, predictable formatting compatible with reversible formatting (nyfmt PoC).
|
||
|
||
Formatting
|
||
- Indent with 2 spaces (no tabs).
|
||
- Braces: K&R style (opening brace on the same line).
|
||
- Max line length: 100 characters (soft limit).
|
||
- One statement per line. Use semicolons only when placing multiple statements on one physical line.
|
||
- Blank lines: separate top‑level `box` declarations with one blank line; no trailing blank lines at file end.
|
||
|
||
Statements and ASI
|
||
- Newline is the primary separator. See `reference/language/statements.md`.
|
||
- Do not insert semicolons before `else`.
|
||
- When breaking expressions across lines, break after an operator or keep the expression grouped.
|
||
|
||
using / include
|
||
- Place all `using` lines at the top of the file, before code.
|
||
- One `using` per line; no trailing semicolons.
|
||
- Sort `using` targets alphabetically; group namespaces before file paths.
|
||
- Prefer `as` aliases for readability. Aliases should be `PascalCase`.
|
||
- Keep `include` adjacent to `using` group, sorted and one per line.
|
||
|
||
Naming (conventions for Nyash code)
|
||
- Boxes (types): `PascalCase` (e.g., `ConsoleBox`, `PathBox`).
|
||
- Methods/functions: `lowerCamelCase` (e.g., `length`, `substring`, `lastIndexOf`).
|
||
- Local variables: concise `lowerCamelCase` (e.g., `i`, `sum`, `filePath`).
|
||
- Constants (if any): `UPPER_SNAKE_CASE`.
|
||
|
||
Structure
|
||
- Top‑to‑bottom: `using`/`include` → static/box declarations → helpers → `main`.
|
||
- Keep methods short and focused; prefer extracting helpers to maintain clarity.
|
||
- Prefer pure helpers where possible; isolate I/O in specific methods.
|
||
|
||
Examples
|
||
```nyash
|
||
using core.std as Std
|
||
using "apps/examples/string_p0.nyash" as Strings
|
||
|
||
static box Main {
|
||
escJson(s) { // lowerCamelCase for methods
|
||
local out = ""
|
||
local i = 0
|
||
local n = s.length()
|
||
loop(i < n) {
|
||
local ch = s.substring(i, i+1)
|
||
if ch == "\\" { out = out + "\\\\" }
|
||
else if ch == "\"" { out = out + "\\\"" }
|
||
else { out = out + ch }
|
||
i = i + 1
|
||
}
|
||
return out
|
||
}
|
||
|
||
main(args) {
|
||
local console = new ConsoleBox()
|
||
console.println("ok")
|
||
return 0
|
||
}
|
||
}
|
||
```
|
||
|
||
CI/Tooling
|
||
- Optional formatter PoC: see `docs/tools/nyfmt/NYFMT_POC_ROADMAP.md`.
|
||
- Keep smoke scripts small and fast; place them under `tools/`.
|
||
|