Olang VS Code Extension

Olang dili için tam özellikli VS Code uzantısı — sözdizimi vurgulama, IntelliSense, tip kontrolü, kullanılmayan kod algılama, hover bilgisi, diagnostics, matematik fonksiyonları, snippet'ler ve "Run Olang File" komutu.

🚀 Özellikler

🧠 IntelliSense (Otomatik Tamamlama)

Anahtar kelimeler: if, else, for, while, func, return, break, continue
Veri tipleri: int, float, str, bool, array, arrayInt, arrayFloat, arrayStr, arrayBool, arrayJson
Yerleşik fonksiyonlar:
- I/O: print, input, inputInt, inputFloat
- Dizi: length, push, pop, range
- Tip dönüşüm: toInt, toFloat, toString, toBool
- Matematik: abs, sqrt, pow, sin, cos, tan, log, exp, floor, ceil, round, min, max, random, randint ve 12+ fonksiyon daha
- String: upper, lower, trim, replace, contains, startsWith, endsWith, indexOf, substring, repeat, split, join, isEmpty, count, capitalize, reverse
Kullanıcı tanımlı fonksiyonlar: Dosyadaki tüm fonksiyonlar otomatik algılanır
Değişkenler: Tanımlı değişkenler tip bilgisiyle birlikte önerilir

💡 Hover Bilgisi

Fonksiyonların üzerine gelin → parametre ve açıklama bilgisi görün
Değişkenlerin üzerine gelin → tip bilgisini görün
Anahtar kelimelerin üzerine gelin → açıklama görün

🔍 Diagnostics (Kod Analizi) - GELIŞMIŞ

Tip Kontrolü

❌ String'e sayı atama: str isim = 123; → Hata
❌ Int'e string atama: int yas = "yirmi"; → Hata
❌ Bool'a geçersiz değer: bool aktif = "evet"; → Hata
❌ Array tip uyuşmazlığı: arrayInt nums = ["a", "b"]; → Hata
❌ Tanımlanmamış fonksiyon: bilinmeyenFunc(); → Hata

Kullanılmayan Kod Algılama

💡 Kullanılmayan değişkenler → Gri/soluk görünür + uyarı
💡 Kullanılmayan fonksiyonlar → Gri/soluk görünür + uyarı
🎯 Kod temizliği için öneriler

Genel Kontroller

⚠️ Noktalı virgül eksikliği uyarıları
🔴 Gerçek zamanlı hata gösterimi

✨ Sözdizimi Vurgulama

Anahtar kelimeler: if, else, for, while, func, return, break, continue, in
Veri tipleri: int, float, str, bool, array, arrayInt, arrayFloat, arrayStr, arrayBool, arrayJson
Yerleşik fonksiyonlar:
- I/O: print, input, inputInt, inputFloat
- Dizi: length, push, pop, range
- Tip dönüşüm: toInt, toFloat, toString, toBool
- Matematik (27 fonksiyon): abs, sqrt, cbrt, pow, hypot, floor, ceil, round, trunc, sin, cos, tan, asin, acos, atan, atan2, sinh, cosh, tanh, exp, log, log10, log2, min, max, random, randint, fmod
- String (16 fonksiyon): upper, lower, capitalize, reverse, trim, replace, contains, startsWith, endsWith, indexOf, count, substring, repeat, split, join, isEmpty, isDigit, isAlpha
Operatörler: &&, ||, !, ==, !=, <=, >=, ++, --, +=, -=, *=, /=
Yorumlar: // satır yorumu, /* */ blok yorumu

📝 Snippet'ler (Kod Şablonları)

Temel Yapılar

print → Print statement
oint, ofloat, ostr, obool → Değişken tanımlamaları
oarray, oarrayint, oarraystr → Dizi tanımlamaları
oif, oifelse → If/else yapıları
owhile, ofor, oforin → Döngüler
ofunc, ofuncr → Fonksiyon tanımlamaları

Matematik Fonksiyonları

osqrt → Karekök (sqrt(value))
opow → Üs alma (pow(base, exp))
oabs → Mutlak değer (abs(value))
ofloor, oceil, oround → Yuvarlama fonksiyonları
osin, ocos, otan → Trigonometrik fonksiyonlar
olog, olog10, oexp → Logaritma ve üstel fonksiyonlar
orandom, orandint → Rastgele sayı üretimi
omin, omax → Min/max değer bulma
opythag → Pisagor teoremi (√(a²+b²))
orad → Derece → Radyan dönüşümü
oinput, oinputint → Kullanıcı girişi
ocomment → Bölüm yorumu

String Fonksiyonları

oupper → Büyük harfe çevirme (upper(s))
olower → Küçük harfe çevirme (lower(s))
otrim → Boşlukları temizleme (trim(s))
oreplace → String değiştirme (replace(s, old, new))
ocontains → String içinde arama (contains(s, sub))
osubstring → Alt string alma (substring(s, start, end))
osplit → String'i ayırma (split(s, delimiter))
ojoin → Dizi birleştirme (join(separator, array))
oreverse → String'i tersine çevirme (reverse(s))
ocapitalize → İlk harfi büyütme (capitalize(s))

🏃 Run Olang File Komutu

Command Palette (Ctrl+Shift+P) → Run Olang File
Aktif .olang dosyasını terminalden çalıştırır
Ayarlardan komut özelleştirilebilir: olang.runCommand

🎨 Dil Konfigürasyonu

Otomatik parantez/tırnak kapatma
Blok ve satır yorumu desteği
Akıllı girinti

📦 Kullanım

Uzantıyı Geliştirici Modunda Çalıştırma

Bu projeyi VS Code'da açın
F5 tuşuna basın (Extension Development Host açılır)
Yeni pencerede bir .olang dosyası açın
Sözdizimi vurgulama otomatik çalışacaktır
Ctrl+Shift+P → Run Olang File ile dosyayı çalıştırın

Ayarlar

settings.json dosyanıza ekleyebilirsiniz:

{
  "olang.runCommand": "olang run ${file}"
}

${file} yerine aktif dosyanın yolu konulur. Örneğin:

Windows: "C:\\olang\\olang.exe run ${file}"
Linux/Mac: "/usr/local/bin/olang run ${file}"

📚 Örnek Olang Kodu

// Basit bir Olang programı
print("=== Merhaba OLang! ===");

int yas = inputInt("Yaşınızı girin: ");
str isim = input("İsminizi girin: ");

if (yas >= 18) {
    print("Merhaba", isim, "- Yetişkinsiniz!");
} else {
    print("Merhaba", isim, "- Henüz çocuksunuz!");
}

// Diziler
arrayInt sayilar = [1, 2, 3, 4, 5];
for (int i = 0; i < length(sayilar); i++) {
    print("Sayı:", sayilar[i]);
}

// Fonksiyonlar
func topla(int a, int b) {
    return a + b;
}

int sonuc = topla(10, 20);
print("Toplam:", sonuc);

🔧 Geliştirme

Gereksinimler

Node.js (v14+)
VS Code (v1.60.0+)

Kurulum

cd olan-ext
# Bağımlılık yok, direkt F5 ile çalıştırabilirsiniz

Test

F5 ile Extension Development Host'u başlatın
Test dosyalarını examples/ klasöründen açın
Sözdizimi vurgulamasını ve snippet'leri test edin

📦 Yayımlama

# vsce kurulumu (ilk kez)
npm install -g @vscode/vsce

# Uzantıyı paketleme
vsce package

# Marketplace'e yükleme (publisher hesabı gerekli)
vsce publish

🎯 İleri Özellikler (Planlanan)

[ ] Language Server Protocol (LSP) entegrasyonu
- Kod tamamlama (IntelliSense)
- Hata kontrolü (diagnostics)
- Hover bilgileri
- Go to Definition
[ ] Hata ayıklama (Debug) desteği
[ ] Kod biçimlendirme (formatter)
[ ] Otomatik import/organize

📄 Lisans

MIT

🤝 Katkıda Bulunma

Pull request'ler memnuniyetle karşılanır!

Olang ile kodlamanın keyfini çıkarın! 🎉

Olang

hamer1818