Söz v0.1.0 Public Alpha

Soz v0.1.0 Public Alpha

Soz'un ilk Public Alpha sürümü; Türkçe düşünmeye uygun ASCII anahtar kelimeler kullanan Rust tabanlı interpreter'ı, komut satırı aracını, Windows x64 portable paketini ve temel VS Code dil desteğini birlikte sunar.

Alpha uyarısı: Bu sürüm öğrenme, deneme ve geri bildirim içindir. Söz dizimi ve çalışma zamanı davranışı sonraki alpha sürümlerinde geriye dönük uyumsuz biçimde değişebilir. Üretim kullanımı için kararlılık garantisi verilmez.

Temel özellikler

• Rust ile yazılmış lexer, parser, AST ve tree-walk interpreter
• soz <dosya.soz>, soz run, soz check ve soz version CLI akışları
• Sayı, string, boolean, boş değer, liste ve fonksiyon değerleri
• Atama; aritmetik, karşılaştırma ve mantıksal operatörler
• eger / yoksa / degilse koşulları
• iken ve tekrar ... icinde ... döngüleri
• islev / don ile kullanıcı tanımlı fonksiyonlar
• yaz() ve aralik() yerleşik fonksiyonları
• Türkçe, satır ve sütun bilgili hata mesajları
• Örnek programlar, testler ve kullanıcı belgeleri
• .soz dosya tanıma, syntax renklendirme, dil yapılandırması ve snippet sağlayan VS Code uzantısı

Release asset'leri ve SHA-256

Taslak GitHub Release'e aşağıdaki üç gerçek dosya yüklenmelidir. Adlar büyük/küçük harf dahil aynen korunmalıdır.

Asset adı	Yerel frozen kaynak	Boyut	SHA-256
soz-0.1.0-windows-x64.zip	dist/soz-0.1.0-windows-x64.zip	515.956 bayt	7109bfe83186f86bb96850dbd733c73f41c53209ea5b1cd6303302eed679ce0e
soz-language-support-0.1.0.vsix	dist/soz-0.1.0-windows-x64/vscode/soz-language-support-0.1.0.vsix	5.679 bayt	20908d07754e9731188865a53c9d7449af6d77a776ac8b0862464f00403e8213
SHA256SUMS.txt	dist/SHA256SUMS.txt	219 bayt	Uygulanmaz; checksum manifesti kendisini listelemez.

SHA256SUMS.txt, frozen ZIP ile ZIP içindeki VSIX'in yukarıdaki iki gerçek özetini içerir. VSIX ayrıca ayrı release asset'i olarak yüklendiğinde dosyanın baytları ve SHA-256 değeri değişmemelidir.

Windows portable kullanım

1. soz-0.1.0-windows-x64.zip ile SHA256SUMS.txt dosyalarını aynı klasöre indirin.

2. PowerShell'de ZIP özetini doğrulayın:

   Get-FileHash .\soz-0.1.0-windows-x64.zip -Algorithm SHA256
   Get-Content .\SHA256SUMS.txt

3. Değerler eşleşiyorsa ZIP'i çıkarın ve paket klasöründe çalıştırın:

   .\soz.exe version
   .\soz.exe .\examples\merhaba.soz
   .\soz.exe check .\examples\kosul.soz

Hazır paket son kullanıcı için Rust, Cargo, Python, pip, Node.js veya internet bağlantısı gerektirmez.

Kullanıcı hesabına kurulum

ZIP'ten çıkan klasörde:

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

Kurulum yalnızca mevcut kullanıcının PATH değerini günceller. Kurulum tamamlandıktan sonra yeni bir terminal açın:

soz version
soz main.soz

Kaldırma:

powershell -NoProfile -ExecutionPolicy Bypass -File .\uninstall.ps1

Özel bir -InstallDir kullandıysanız kaldırırken aynı yolu belirtin. Ayrıntılar Windows kurulum kılavuzunda bulunur.

VS Code uzantısını kurma

VSIX'i ayrı asset olarak indirdiyseniz VS Code'da Extensions görünümünün ... menüsünden Install from VSIX... seçeneğini kullanın. ZIP içindeki kopya vscode\soz-language-support-0.1.0.vsix yolundadır. code komutu etkinse:

code --install-extension .\vscode\soz-language-support-0.1.0.vsix --force

Uzantı yalnızca dil tanıma, syntax highlighting, dil yapılandırması ve snippet desteği verir; language server veya debugger içermez. Bu sürüm için VS Code Marketplace yayını yapılmamıştır.

Bilinen sınırlamalar ve güvenlik uyarısı

• Resmi hazır paket yalnızca Windows x64 hedefidir.
• soz.exe, install.ps1, uninstall.ps1 ve VSIX dijital olarak imzalanmamıştır.
• Windows SmartScreen, PowerShell yürütme ilkesi veya kurumsal güvenlik yazılımı ilk çalıştırmada uyarı gösterebilir. Güvenlik politikasını genel olarak gevşetmeyin; önce checksum'u doğrulayın ve kurumsal ortamda sistem yöneticinizin politikasını izleyin.
• Söz dizimi Public Alpha boyunca değişebilir; v0.1.0 programlarının sonraki alpha sürümlerinde değişmeden çalışacağı garanti edilmez.
• Class, modül/import sistemi, paket yöneticisi, async/await, native compiler, debugger ve full Language Server yoktur.
• Otomatik güncelleme, dosya ilişkilendirme, code signing ve Marketplace yayını yoktur.

Hata bildirme

Repo public olduktan sonra hataları GitHub Issues içindeki Bug report formuyla bildirin. Mümkünse soz version çıktısını, küçük bir yeniden üretim örneğini, beklenen ve gerçek davranışı ekleyin. Issue içine token, API anahtarı, parola, özel kaynak kod veya kişisel veri koymayın.

Kurulum ve dağıtım ayrıntıları için README, Windows dağıtım belgesi ve Public Alpha kabul belgesi kullanılmalıdır.