Pylance + Pyrefly: VS Code’da Tip Denetleyici Seçimi
Microsoft, Python geliştiricileri için tip denetleme katmanını editör zekasından ayıran yeni bir açık standart duyurdu. Adı Type Server Protocol (TSP). Pylance bu protokolle birlikte, arkasında çalışan tip denetleyicisini değiştirilebilir bir bileşen olarak ele alıyor. İlk somut sonucu Meta ile yapılan iş birliği oldu; Pyrefly artık Pylance’in tanılama (diagnostics) kaynağı olarak VS Code içinde doğrudan seçilebiliyor. Copilot entegrasyonu, tamamlamalar ve ortam yönetimi gibi Pylance özelliklerinden vazgeçmeden tercih ettiğiniz tip denetleyicisini kullanabiliyorsunuz.
Type Server Protocol tam olarak neyi değiştiriyor?
TSP, editör entegrasyonlarının sektör genelindeki temeli olan Language Server Protocol (LSP)‘yi genişleten açık bir standart. Amaç, herhangi bir editörün veya aracın tip denetleyicilerini birinci sınıf arka uç olarak entegre edebilmesi.
Bugüne kadar Pylance ile Pyright birbirine sıkı sıkıya bağlıydı. TSP bu iki katman arasına net bir sınır çiziyor:
- Pylance, VS Code tarafındaki Python IDE zeka katmanı olarak konumlanıyor.
- Tip denetleyici, bu katmanın altında yer alan ve değiştirilebilir bir statik analiz bileşenine dönüşüyor.
Microsoft’un açıklamasına göre Pyright varsayılan olmaya devam ediyor, kullanıcıların büyük çoğunluğu için deneyimi o sağlıyor. Belirli bir denetleyiciyi tercih eden ya da kod tabanı başka bir denetleyiciyle daha iyi sonuç veren geliştiriciler içinse geçiş, VS Code durum çubuğundan yapılabilen basit bir işlem artık.
Hangi denetleyiciyi seçerseniz seçin, Pylance’in kod tamamlamaları, Quick Info bilgileri, ortam yönetimi ve en kritik olarak GitHub Copilot ile derin entegrasyonu yerinde kalıyor. Bu deneyimler tek bir tip denetleyicinin değil, Pylance’in üzerine inşa edilmiş durumda.
Meta iş birliği ve Pyrefly’ın getirdikleri
Microsoft, TSP’nin tasarımı ve uygulanması ile Pyrefly’ın protokolü eksiksiz desteklemesi için Meta ile ortak çalıştığını belirtiyor. Duyurudaki çerçeveye göre Python ekosistemi parçalanmaktan çok birlikte çalışabilirlikten kazançlı çıkıyor. Meta tarafında hızlı statik tip analizi ve AI/ML kütüphane desteği uzmanlığı var, Microsoft tarafında VS Code entegrasyon katmanı ve GitHub Copilot deneyimi; ikisini birbirine TSP bağlıyor.
Meta’nın Python tip sistemindeki geçmişi 2017’ye uzanıyor. Instagram dahil dünyanın en büyük Python kod tabanlarında ölçekli tip denetleme problemini çözme deneyimi, Pyrefly‘ın tasarım kararlarını şekillendirmiş. Duyuruya göre Pyrefly saniyede 1,8 milyon satır kod denetliyor, hem CI hem de IDE tarafında tutarlı bir deneyim verecek şekilde sıfırdan kurgulanmış.
Meta’nın ekosisteme katkıları arasında NumPy‘ı yaklaşık %90 tip tamlığına taşımak, pandas‘ın genel API tip kapsamını tamamlamak ve Python tip denetleyicileri için kamuya açık en kapsamlı performans karşılaştırmalarını yayımlamak sayılıyor.
Neden Pyrefly’ı doğrudan değil de Pylance üzerinden kullanmalı?
Duyuruda bu soru, “sorulması gereken doğru soru” olarak tanımlanıyor. Pyrefly’ın zaten yüksek performanslı bir VS Code eklentisi var, sürekli entegrasyon (CI) tarafında tip denetlemesi için de güçlü bir seçenek. Peki Pylance üzerinden kullanmanın farkı ne?
Microsoft’un cevabı, bağımsız bir tip denetleyici eklentisinin çoğaltamayacağı Copilot entegrasyonları üzerine kurulu:
- AI tamamlamaları için bağlam sağlama
- GitHub Copilot Chat’i besleyen akıllı kod anlama katmanı
- Python kod tabanları için MCP araçları
- Pylance’in yıllar içinde üretimde olgunlaştırdığı Python geliştirici araç seti
Pyright’ın Pylance’ten ayrıştırılması sorumlulukları netleştiriyor. Pylance zeka katmanını sağlıyor, ağır tip denetleme işini seçtiğiniz motora devrediyor. TSP üzerinden Pyrefly kullandığınızda motorda Pyrefly’ın analizi, üstte ise Pylance’in AI farkındalıklı katmanı çalışıyor.
Nasıl denenir: otomatik algılama ve ayarlar
Pyrefly ile TSP desteği için Pylance 2026.4.1 veya daha yeni bir sürüm gerekiyor.
Otomatik algılama
Bir çalışma alanı açtığınızda Pylance, Python ortamlarınızda Pyrefly kurulumu olup olmadığını kontrol ediyor. Sanal ortamınızda kurulu olması ya da pyrefly.toml dosyası veya pyproject.toml içindeki tool.pyrefly yapılandırmasıyla işaret edilmesi yeterli. Bu durumda şu bildirim görünüyor:
Pyrefly was found in your Python environment. Would you like to use it as your source of diagnostics in VS Code?
Switch to Pyrefly seçeneğine tıkladığınızda Pylance, Pyrefly’ı tanılama kaynağı olarak hemen etkinleştiriyor ve çalıştırılabilir dosyanın yolunu otomatik kaydediyor, elle yapılandırma gerekmiyor. Tercihi sonradan Ayarlar üzerinden geri almak ya da yeniden etkinleştirmek mümkün.
Ayarlar üzerinden elle geçiş
VS Code Ayarlar arayüzünde Python › Analysis: Diagnostics Source başlığı altındaki açılır listede üç seçenek bulunuyor:
| Seçenek | Açıklama |
|---|---|
| Pylance | Varsayılan; Pylance’in yerleşik analizini kullanır |
| Pylance + Pyright | Tanılamaları açıkça Pyright üzerinden yönlendirir |
| Pylance + Pyrefly | Tanılama motoru olarak Pyrefly’ı kullanır |
Pylance + Pyrefly seçildiğinde Pylance, sanal ortamlarınızda bir Pyrefly kurulumu arıyor, bulamazsa otomatik olarak indiriyor. Yanındaki Python › Analysis: Pyrefly Version ayarı belirli bir sürümü sabitlemenize, yerel bir çalıştırılabilir dosyaya işaret etmenize ya da boş bırakıp her zaman en güncel sürümü kullanmanıza olanak veriyor. Desteklenen en düşük sürüm 0.60.0.
Durum çubuğu
Etkinleştirdikten sonra durum çubuğunda, yorumlayıcı ve ortam bilgisinin yanında Diagnostics Source: Pylance + Pyrefly ifadesi görünüyor. Buraya tıklamak doğrudan Python › Analysis: Diagnostics Source ayarını açıyor.
Ekosistem açısından ne anlama geliyor?
TSP açık bir standart olarak konumlandırılıyor, tek bir ürüne özel bir entegrasyon olarak değil. Microsoft, bu standardın etrafında ekosistemin büyümesini ve ilerleyen dönemde Python geliştiricilerine daha fazla seçenek sunulmasını beklediğini belirtiyor. Protokolün teknik ayrıntıları Pylance deposunda yayımlanan belgede yer alıyor.
Tip denetleme yalnızca hata yakalamıyor, IntelliSense’in ve giderek yaygınlaşan ajan tabanlı iş akışlarının statik anlam temelini de oluşturuyor. Denetleyici seçimini editör zekasından ayırmak, bu yüzden uzun vadeli bir mimari tercih olarak okunabilir.
Kaynaklar ve İleri Okuma
- Pylance + Pyrefly: bring your preferred type checker to Visual Studio Code – Brett Cannon, Microsoft for Python Developers Blog
- Type Server Protocol belgeleri (microsoft/pylance-release)
- Pylance eklentisi – Visual Studio Marketplace
- Pyrefly resmi sitesi
- Visual Studio Code
- Python in Visual Studio Code – November 2025 Release
20+ yıl deneyimli Azure Solutions Architect. Microsoft sertifikalı bulut mimari ve DevOps danışmanı. Azure, yapay zekâ ve bulut teknolojileri üzerine Türkçe teknik içerikler üretiyor.
0 comments