LSP Modülü

lsp modülü (src/atopile/lsp/ dizininde yer alır) atopile için Language Server Protocol'ü uygular. ato dosyaları için otomatik tamamlama, tanıma gitme ve tanılama (hata raporlama) gibi IDE özelliklerini sağlar.

Hızlı Başlangıç

Sunucuyu stdio üzerinde çalıştırın (editörlerin beklediği şey):

python -m atopile.lsp.lsp_server

İlgili Dosyalar

• Sunucu uygulaması: src/atopile/lsp/lsp_server.py
  • global LSP_SERVER (pygls LanguageServer) sahibi
  • doküman başına DocumentState tutar (graph/typegraph/build_result)
  • completion/hover/definition/diagnostics handler'larını uygular
• Yardımcı araçlar: src/atopile/lsp/lsp_utils.py
• İsteğe bağlı hata ayıklama yardımcısı: src/atopile/lsp/_debug_server.py

Bağımlılar (Çağrı Siteleri)

• VSCode Extension: Bu sunucu için belirtilen istemci.
• Compiler: LSP, kod yapısını anlamak için derleyiciyi (çoğunlukla kısmi veya hata-toleranslı modda) çağırır.

Nasıl Çalışılır / Geliştirilebilir / Test Edilir

Temel Kavramlar

• Kısmi Derleme: CLI build'in aksine, LSP kırık veya eksik kodu kilitlenmeden işleyebilmelidir.
• Gecikme Süresi: Özellikler hızlı olmalıdır (yazma için <50ms, tamamlama için <200ms).
• Doküman başına graph'lar: açık olan her dokümanın DocumentState içinde depolanmış izole bir GraphView + TypeGraph'ı vardır.
• Son başarılı build'i tut: sunucu, mevcut düzenleme hatalar içerse bile tamamlama/hover özelliklerini desteklemek için son başarılı BuildFileResult'ı tutar.

Geliştirme İş Akışı

1. src/atopile/lsp/lsp_server.py içindeki handler'ları/yardımcıları düzenleyin.
2. Tamamlama testlerini çalıştırın (hızlı döngü) ve GraphView temizleme yollarını doğrulayın.

Test Etme

• Entegrasyon stili testler: ato dev test --llm test/test_lsp_completion.py -q

En İyi Uygulamalar

• Sağlamlık: Sunucunun hiçbir zaman kilitlenmesine izin vermeyin. Handler'lardaki tüm istisnaları yakalayın ve günlüğe kaydedin.
• Debouncing: Her tuşa basışında pahalı işlemleri tetiklemeyin.

Temel Değişmezler (regresyon açısından kolay)

• Rebuild/reset yapılırken eski graph'ları her zaman yok edin (DocumentState.reset_graph çağrısı GraphView.destroy() yapar).
• Build'lerin başarılı olacağını varsaymayın; çoğu özellik aşağıdakilerle başa çıkmalıdır:
  • söz dizimi hataları (ANTLR)
  • kısmi typegraph'lar
  • linking/deferred execution'dan gelen istisnalar