Rust veri kaynağı, Kuika platformunda özel fonksiyonlar ve iş mantıkları geliştirmenizi sağlayan entegrasyon yöntemlerinden biridir. Rust kullanarak uygulamanız içerisinde özel işlemler tanımlayabilir, parametre alan fonksiyonlar oluşturabilir ve bu fonksiyonları uygulama akışlarında kullanabilirsiniz.

Rust veri kaynağı sayesinde hazır aksiyonların dışında kalan ihtiyaçlar için özel kod yazabilir, veri işleme süreçlerini özelleştirebilir ve tekrar kullanılabilir fonksiyonlar oluşturabilirsiniz.

Rust ile Uygulamanıza Veri Kaynağı Bağlantısı Ekleyin

1. Kuika platformuna giriş yapın ve Apps ekranından çalışacağınız projeyi açın.
2. Üst menüden Datasources modülünü açın.
3. Açılan Datasources ekranında mevcut veri kaynaklarınızı Recently modified ve Data sources sekmeleri altında görüntüleyebilir, Search by name alanı ile arama yapabilirsiniz.
4. Ekranın üst kısmındaki kartlardan Create a Function kartına tıklayın. Bu kart C#, TypeScript, Python, Java, Go ve Rust ile özel fonksiyon oluşturmanızı sağlar.
5. Açılan Development listesinden Rust (Custom Rust functions) seçeneğini belirleyin. Listede gezinmek için ↑/↓ tuşlarını, seçim yapmak için Enter tuşunu da kullanabilirsiniz.

6. Name alanına veri kaynağınız için bir isim girin (örn. userguiderust).
7. CREATE butonuna tıklayarak işlemi tamamlayın. İşlemden vazgeçmek için CANCEL butonunu, dil seçimine geri dönmek için < Rust bağlantısını kullanabilirsiniz.

Not: Sol paneldeki Sources başlığının yanında yer alan + ikonu ile de yeni veri kaynağı ekleme işlemini başlatabilirsiniz.

Rust Editör Ekranının Anatomisi

A. Üst Menü

• Geri Butonu (←): Datasources ekranına geri dönmenizi sağlar.
• Veri Kaynağı Adı: Oluşturduğunuz Rust veri kaynağının adı (örn. userguiderust) Rust ikonu ile birlikte görüntülenir. Yanındaki açılır ok ile veri kaynakları arasında geçiş yapabilir, kalem ikonu ile adı düzenleyebilirsiniz.
• CREATE Butonu: Hazırladığınız Rust veri kaynağını kaydetmek için kullanılır.

B. Editör Araç Çubuğu

• Geri Al / Yinele: Yapılan değişiklikleri geri almanızı veya tekrar uygulamanızı sağlar.
• Kopyala / Yapıştır: Kodu kopyalamak ve editöre yapıştırmak için kullanılır.
• Kodu Düzenle (Tidy Up): Sihirli değnek ikonu ile yazılmış kodu düzenleyebilir, hizalayabilir ve okunabilir hale getirebilirsiniz.
• Satır Kaydırma (Word Wrap): Uzun satırların editör genişliğine göre alt satıra kaydırılmasını açıp kapatır.
• Yazı Boyutu (− 12 +): Editördeki yazı boyutunu küçültüp büyütmenizi sağlar; yanındaki ikon ile varsayılan boyuta dönebilirsiniz.
• External Libraries (BETA): Rust kodunuzda kullanmak üzere harici crate'ler (bağımlılıklar) eklemenizi sağlayan paneli açar. Şu anda BETA etiketiyle sunulmaktadır. Yanındaki yeşil onay ikonu, kodunuzun geçerli olduğunu gösterir.

C. Rust Editor

Kod yazma alanıdır. Tüm özel fonksiyonlar burada tanımlanır.

Varsayılan örnek yapı:

pub fn greet(name: String) -> String {
  format!("Hello, {}", name)
}

Bu yapı aşağıdakileri gösterir:

• Fonksiyonlar pub fn anahtar kelimeleriyle tanımlanır (dışarıdan erişilebilir/public olarak işaretlenir).
• Parametre alabilir.
• Parametre tipi belirlenebilir (örn. String).
• Dönüş tipi -> işareti ile tanımlanabilir (örn. String).
• Fonksiyon gövdesinde formatlı metin oluşturmak için format! makrosu kullanılabilir.

D. Kuika AI Paneli

Ekranın sağ tarafında yer alan yapay zekâ asistanıdır. Type here... alanına ihtiyacınızı yazarak Rust aksiyonlarınız için kod önerisi alabilir, örneklerden yararlanabilirsiniz.

E. Test Console

Ekranın alt kısmında yer alan, yazdığınız fonksiyonları test etmek için kullanılan alandır. Sağındaki ok ile açılıp kapatılabilir.

Bu bölümde:

• Fonksiyon listesi görüntülenir.
• Parametre giriş alanları oluşur.
• Sonuç çıktısı görüntülenebilir.

Rust Veri Kaynağı Ayarlarını Yapılandırma

Manuel Kod Yazma

Kodlarınızı doğrudan editör üzerinden manuel olarak yazabilirsiniz.

Örnek:

pub fn to_upper_case(text: String) -> String {
  text.to_uppercase()
}

Kuika AI ile Kod Oluşturma

Sağ paneldeki Kuika AI alanına açıklama yazarak otomatik kod oluşturabilirsiniz.

Örnek komut:

Girilen metni büyük harfe çeviren fonksiyon oluştur.

External Libraries Kullanımı (BETA)

Araç çubuğundaki External Libraries butonuna tıklayarak standart Rust kütüphanesinin (std) dışında ek crate'leri projenize dahil edebilirsiniz. Açılan panel iki sekmeden oluşur; paneli sağ üstteki X ile kapatabilirsiniz. Bu özellik şu an BETA aşamasındadır.

Installed sekmesi: Veri kaynağınıza eklenmiş kütüphaneleri listeler. Search installed libraries alanı ile eklenmiş kütüphaneler arasında arama yapabilirsiniz. Henüz kütüphane eklenmediyse "No modules yet" mesajı ve Add module butonu görüntülenir; bu buton sizi Add sekmesine yönlendirir.

Add sekmesi: Yeni crate eklemek için kullanılır. Crate'ler crates.io üzerinden getirilir.

1. Giriş alanına crate adını yazın. İsterseniz @ ile sürüm belirtebilirsiniz (örn. uuid@1.6.0).
2. Add butonuna tıklayın.
3. Sık kullanılan crate'leri Popular modules altındaki serde, uuid, regex ve chrono kısayollarıyla hızlıca seçebilirsiniz.

Parametre Tanımlama

Fonksiyonlarınıza parametre ekleyebilirsiniz.

Örnek:

pub fn sum(value1: f64, value2: f64) -> f64 {
  value1 + value2
}

Bu fonksiyon iki sayı alır ve toplamını döndürür.

Dönüş Tipi Belirleme

Fonksiyon imzasının sonunda -> işareti ile dönecek veri tipi tanımlanmalıdır. Örnek tipler: String, i32 / i64, f64, bool, Vec<T> (dizi/liste), Option<T>.

Test Console ile Fonksiyon Test Etme

Kodunuzu yazdıktan sonra alt bölümdeki Test Console alanını açarak kullanabilirsiniz.

1. Test etmek istediğiniz fonksiyonu seçin.
2. Parametre alanlarına örnek veri girin.
3. Fonksiyonu çalıştırın.
4. Dönen sonucu kontrol edin.

Örnek:

pub fn hello(name: String) -> String {
  format!("Hello {}", name)
}

Parametre: Kuika
Beklenen çıktı: Hello Kuika

CREATE ile Veri Kaynağını Kaydetme

Kodunuzu tamamladıktan ve test ettikten sonra sağ üstteki CREATE butonuna tıklayarak Rust veri kaynağını kaydedebilirsiniz. Kaydedilen veri kaynağı uygulama içerisinde kullanılabilir hale gelir.

Beklenen Çıktı / Sonuç

Bu adımlar tamamlandığında:

• Rust veri kaynağı Sources listesine eklenir.
• Tanımlanan fonksiyonlar sistemde kullanılabilir hale gelir.
• Özel iş kuralları kod ile yönetilebilir.
• Tekrar kullanılabilir fonksiyon yapısı oluşturulur.