1. Kurulum ve Hızlı Başlangıç
Yukinary, geliştiricileri karmaşık derleyici toolchain'leriyle uğraştırmaz. Windows ve Linux için tek tıkla çalışan kurulum paketleri sunar.
Windows Turnkey Kurulumu
1. GitHub Releases sayfasından yukinary-setup-windows-x86_64.zip dosyasını indirin ve dışa aktarın.
2. Klasör içindeki setup.cmd dosyasına çift tıklayın.
3. Kurulum %USERPROFILE%\.yukinary\bin dizinine tüm binary'leri yerleştirir ve PATH ortam değişkenini otomatik yapılandırır.
Linux & macOS 1-Line Kurulumu
curl -fsSL https://raw.githubusercontent.com/ykncode/yukinary/main/setup.sh | bash
source ~/.bashrc
Doğrulama ve İlk Test
ykn --version
# Output: Yukinary v1.0.0 (x86_64-windows-pe32+ / elf64)
ykn --yardim
# Lists all subcommands, flags, and usage examples.
2. CLI Komut Referansı
ykn komut satırı arayüzü, geliştirme döngüsünün tüm ihtiyaçlarını karşılar:
| Komut |
Açıklama |
Örnek Kullanım |
ykn derle [dosya] |
Kaynak kodu doğrudan PE32+ (.exe) veya ELF64 ikili dosyasına derler. |
ykn derle ana.ykn -o program.exe |
ykn calistir [dosya] |
Kodu derler ve bellekte anında çalıştırır. |
ykn calistir test.ykn |
ykn convert [dosya] |
Python veya C kodlarını otomatik olarak Yukinary sözdizimine dönüştürür. |
ykn convert script.py --into-file script.ykn |
ykn --self-heal [dosya] |
Kod üzerindeki sözdizimsel hataları otomatik onarır ve güvenlik denetimi yapar. |
ykn --self-heal bozuk.ykn |
ykn --lsp |
VS Code ve diğer editörler için dahili Language Server Protocol sunucusunu başlatır. |
ykn --lsp |
3. Hiyerarşik #config Orkestratörü
Yukinary'de derleme ayarlarını terminal bayraklarına yazmak zorunda kalmazsınız. Kaynak dosyasının başına koyacağınız #config bloğu, projenin derleme hedefini, optimizasyon seviyesini ve yapay zeka parametrelerini taşınabilir kılar:
# config {
# hedef: "pe32",
# optimize: 2,
# llm: "bitnet",
# llm_model: "models/bitnet-b1.58-2B-4T/ggml-model-i2_s.gguf",
# bellek_guvenligi: "kati"
# }
isv ana() -> tamsayi {
ekrana_yaz("Bu dosya kendi derleme parametrelerini tasir!\n".ptr);
dondu 0;
}
4. Hafıza Zabıtası & Güvenlik Modeli
Yukinary, çöp toplayıcı (Garbage Collector) içermez. Bunun yerine derleme zamanı Hafıza Zabıtası (Safety Gate) çalışır:
- Use-After-Free (UAF) Koruması: Serbest bırakılan işaretçilerin yeniden okunması derleme anında tespit edilir ve engellenir.
- Dizi ve Bellek Sınır Kontrolü: Statik aralık çıkarımıyla sınır aşımı (buffer overflow) riskleri elenir.
- X-Ray Sandbox Gate: Yetkisiz sistem çağrıları sandbox seviyesinde kısıtlanabilir.
5. İşletim Sistemi Geliştirme (YknOS Mimarisi)
Yukinary ile bir işletim sistemi çekirdeği yazılabilir mi? Kesinlikle evet.
Çünkü Yukinary'nin hiçbir C çalışma zamanı (libc, msvcrt) bağımlılığı yoktur. Çıktı olarak ürettiği makine kodu doğrudan BIOS / UEFI bootloader tarafından 0x100000 adresine yüklenip icra edilebilir. std/os altında yer alan kesme yönetimi, sanal bellek (paging) ve VGA/Seri port sürücüleri YknOS'un yapı taşlarını oluşturur.
6. Kendi Dilini Ekle (Multi-Lingual Community Guide)
Yukinary topluluğu, dili dünyanın tüm dillerine açmayı taahhüt eder. Kendi ana dilinizi eklemek için 3 basit adım yeterlidir:
- tools/keyword_registry.json dosyasına dil kodunuzu (örn: "es") ve anahtar kelime eşlemelerini ekleyin.
- src/lexer.ykn içerisindeki anahtar kelime arama tablosuna kelimelerinizi tanımlayın.
- ykn derle src/main.ykn komutuyla derleyiciyi yeniden derleyin ve GitHub üzerinden Pull Request gönderin!
7. Teknik Garantiler ve Lisans
Yukinary, endüstri standardı MIT ve Apache-2.0 çift lisansı ile korunmaktadır. Hem ticari projelerde hem de açık kaynaklı girişimlerde özgürce kullanılabilir.
Deterministik Derleme Garantisi: Aynı kaynak kod, aynı mimaride derlendiğinde her zaman bayt seviyesinde 100% birebir aynı (bit-identical) ikili dosyayı üretir.
