İçeriğe geç
zeev1.0.0-rc.1

Derleyici faz modeli

Depodaki docs/derleyici-faz-modeli.md belgesinden Zee ile üretildi.

Bu belge ADR-015'in uygulama rehberidir. Dosya/modül sahipliği için derleyici faz sınırları, checker içi kurallar için checker katmanları birlikte okunur.

Bugün çalışan hat

Faz türüTaşıdığı gerçekSonraki tek geçerli adım
KaynakMetniUTF-8 zee kaynak metnisozcukle()
TokenAkisikonumlu lexer tokenlarıayristir(...) veya kurtarmalı parser
AyristirilmisAsthoist/çözüm görmemiş, her ifadesi kesin kaynak zarflı Cumle ağacıbirim/paket çözümü + hoist
BaglanmamisProgramcümle, işlem, yapı ve test koleksiyonuchecker denetle() geçişi
BaglanmisProgramchecker kanıtlı AST + zorunlu typed HIRHIR tüketen interpreter veya bilinçli eski-API adaptörü
text
source ──lexer──> tokens ──parser──> parsed AST ──hoist──> unbound program
                                                           │
                                      constraint discovery + final checker
                                                           ▼
                                                    bound program ──> runtime

K-121'de yerel çağrı çıkarımı, BaglanmamisProgram içindeki AST'nin bir kopyasında çalışan ve yalnız işlem imzası önbilgisi üreten checker-içi keşif adımıdır; yeni bir public faz türü değildir. Tanı, semantic bağ ve typed HIR üretmez. Asıl checker aynı bağlanmamış programı nihai imzalarla doğrular ve tek geçerli BaglanmisProgramı üretir.

Kullanım

Yeni uçtan uca kod kaynagi_fazli_derle veya yükleyicili/kökenli eşini kullanır. Yürütme yorumlayici::calistir_baglanmis ya da calistir_baglanmis_io ile yapılır. kaynagi_derle ve raw Program alan runtime fonksiyonları yalnız v0 embedding uyumluluğudur; yeni iç kod bunlara dayanmaz.

BaglanmisProgram::program() immutable görünüm verir. into_program() faz bilgisini bilinçli silen sınırdır; checker öncesi çağrılamaz.

Kurtarmalı TokenAkisi::ayristir_kurtarmali, K-113/ADR-024 uyarınca hatalı cümlede satır sonuna ve yalnız ona ait dengeli girinti gövdesinin sonuna senkronlanır. Sağlam kardeşler kendi bloklarında kalır. Dönen kısmi AyristirilmisAst yalnız çoklu tanı içindir; tanılar varken bağlanmış veya yürütülebilir faz sayılmaz. Ayrıntı parser kurtarma rehberindedir.

K-103/K-104/K-108/K-126 sonrası HIR hattı

BaglanmisProgram artık ADR-016'daki HirProgramı zorunlu taşır. Her denetlenmiş ifade HirDugumId, açık HirIfadeTuru, zorunlu HirKaynakAraligi ve varsa semantic ID bağına sahiptir; kaynak AST tanı ve v0 uyumluluğu için salt-okunur korunur. Hedef hat şöyledir:

text
Parsed AST → Resolution sonucu → Typed HIR → Execution/Lowering

K-104 ile standart runtime ve dene değişken/işlem/yapı kararını yalnız bu HIR bağından alır; B-019 kapanmıştır. K-108 her semantic HIR düğümüne kesin token aralığı veya dürüst satır zarfı koyup B-020'yi kapattı. K-126 bütün parser AST yaprak ve bileşiklerini ayrı kesin AstKaynakAraligi zarflarına aldı; başarılı checker bunları kayıpsız HIR Kesin aralığına dönüştürür. K-112/K-126 parser çıkışında semantic alanların boş ve kaynak zarfının tam, checker çıkışında AST↔HIR eşlemesinin aralık dahil tekil olduğunu debug/test aşamasında otomatik doğrular. İhlal faz+yapısal yol taşıyan C000'dir. Ayrıntı typed HIR rehberinde ve invariant rehberindedir.

Kanıt ve büyüme kuralı

  • faz_modeli_testi.rs parsed/bound farkını ve eski API uyumluluğunu sınar.
  • invariant_testi.rs parsed AST saflığını, zorunlu kesin kaynak zarfını, bağlı AST/HIR tamlığını ve imkânsız sentetik biçimlerin reddini sınar.
  • parser_kurtarma_testi.rs hatalı iç cümleden sonra kardeş/blok sahipliğini, derinlik geri alımını ve tanı bütçesini sınar.
  • faz.rs compile-fail örneği yanlış geçişin derlenmediğini kanıtlar.
  • mimari_sinir_testi.rs standart hattın faz türlerini gerçekten kullandığını ve modül bütçesini korur.
  • Yeni compiler aşaması çıplak tuple/type alias ile gizlenmez; veri türü, geçiş sahibi, hata biçimi ve hangi önceki fazı tükettiği aynı ADR/rehber değişikliğinde yazılır.
  • Checker-içi keşif kopyası bağlanmış faz sayılmaz ve dışarı sızmaz; HIR sahipliği yalnız nihai doğrulama geçişindedir.
  • Yeni AST/HIR varyantı, invariant ziyaretçisinde alt düğümleri ve beklenen semantic bağı tanımlanmadan tamamlanmış sayılmaz.

Kaynak: docs/derleyici-faz-modeli.md · Bütün belgeler