Nasıl Kullanılır? - BDD → Maestro Converter

🎯 Sistem Nasıl Çalışıyor?

BDD → Maestro Converter, Gauge BDD formatındaki test senaryolarınızı Maestro YAML formatına otomatik olarak dönüştüren bir araçtır. Groq AI teknolojisi kullanarak, test adımlarınızın anlamını anlayıp doğru Maestro komutlarına dönüştürür.

Neden AI Kullanıyoruz? Gauge step'leri çok farklı formatlarda yazılabiliyor. "Buton'a tıkla", "Buton elementine tıkla", "Buton butonuna bas" gibi farklı ifadeler aynı işi yapıyor. AI, bu farklılıkları anlayıp doğru Maestro komutuna dönüştürüyor.

📝 Gauge BDD Formatı

Gauge BDD formatı şu yapıda olmalıdır:

# Specification Başlığı (Opsiyonel)
Tags: smoke, regression (Opsiyonel)

## Senaryo Başlığı
* Test adımı 1
* Test adımı 2
* Test adımı 3
            

Format Kuralları:

Specification Başlığı: # ile başlar (tek #)
Tags: Tags: ile başlar, virgülle ayrılmış tag'ler
Senaryo Başlığı: ## ile başlar (çift #)
Test Adımları: * ile başlar

✅ Doğru Format Örneği:

# Login Testi
Tags: smoke, regression

## Kullanıcı Giriş Senaryosu
* Uygulamayı aç
* "EmailInput" alanına tıkla
* "test@email.com" metnini yaz
* "LoginButton" butonuna tıkla
                

🚀 Adım Adım Kullanım

1

Gauge Spec'inizi Hazırlayın

Gauge BDD formatında yazılmış test senaryonuzu hazırlayın. Eğer hazır bir spec'iniz yoksa, ana sayfadaki "Örnek Yükle" butonunu kullanarak örnek bir spec yükleyebilirsiniz.

2

Sol Panele Yapıştırın

Hazırladığınız Gauge spec'ini sol paneldeki textarea alanına yapıştırın. Uzun spec'ler için otomatik scroll özelliği vardır.

3

Dönüştür Butonuna Tıklayın

"Dönüştür" butonuna tıklayın veya ⌘ + Enter (Mac) / Ctrl + Enter (Windows) kısayolunu kullanın.

Dönüşüm işlemi birkaç saniye sürebilir. AI, her adımı analiz edip en uygun Maestro komutuna dönüştürüyor.

4

Maestro YAML'ı Alın

Sağ panelde dönüştürülmüş Maestro YAML'ı göreceksiniz. Syntax highlighting ile renklendirilmiş ve okunması kolay bir formatta.

5

Kopyalayın ve Kullanın

"Kopyala" butonuna tıklayarak Maestro YAML'ı panoya kopyalayın. Ardından Maestro test dosyanıza (.yaml) yapıştırıp kullanabilirsiniz.

💡 Desteklenen Gauge Adımları

AI, aşağıdaki türdeki Gauge adımlarını otomatik olarak dönüştürebilir:

Element İşlemleri

"ElementId" elementine tıkla → tapOn: id: "ElementId"
"ElementId" elementine çift tıkla → doubleTapOn: id: "ElementId"
"ElementId" elementine uzun bas → longPressOn: id: "ElementId"
"ElementId" alanına "metin" yaz → tapOn: id: "ElementId" + inputText: "metin"

Uygulama İşlemleri

Uygulamayı aç → launchApp
Klavyeyi kapat → hideKeyboard
X saniye bekle → waitForAnimationToEnd: timeout: X000

Scroll ve Swipe

Ekranı sola kaydır → swipe: direction: LEFT
Ekranı yukarı kaydır → swipe: direction: UP
Scroll yap → scroll

Bekleme İşlemleri

"ElementId" görünene kadar bekle → extendedWaitUntil: visible: id: "ElementId"
"ElementId" elementinin görülmesini bekle → extendedWaitUntil: visible: id: "ElementId"

AI, farklı ifade şekillerini anlayabilir. Örneğin "tıkla", "bas", "click" gibi farklı kelimeler aynı şekilde işlenir.

⚠️ Dikkat Edilmesi Gerekenler

Element ID'leri Tırnak İçinde Olmalı

Element ID'lerini tırnak içinde yazın: "EmailInput" ✅ Tırnak olmadan: EmailInput ❌

Çok Karmaşık Adımlar

Çok karmaşık veya belirsiz adımlar için AI "TODO" yorumu ekleyebilir. Bu durumda adımı manuel olarak düzenlemeniz gerekebilir.

appId Değiştirme

Dönüştürülen YAML'da appId: com.your.app.id varsayılan olarak gelir. Bunu kendi uygulamanızın package ID'si ile değiştirmeyi unutmayın!

🔧 Maestro YAML Formatı

Dönüştürülen Maestro YAML şu formatta olacaktır:

appId: com.your.app.id
tags:
  - smoke
  - regression
---
# Senaryo Başlığı

- launchApp
- tapOn:
    id: "EmailInput"
- inputText: "test@email.com"
- tapOn:
    id: "LoginButton"
            

Maestro Komutları:

launchApp - Uygulamayı başlat
tapOn - Element'e tıkla
doubleTapOn - Element'e çift tıkla
longPressOn - Element'e uzun bas
inputText - Metin gir
hideKeyboard - Klavyeyi kapat
swipe - Kaydırma işlemi
extendedWaitUntil - Element görünene kadar bekle

❓ Sık Sorulan Sorular

Dönüşüm ne kadar sürer?

Genellikle 2-5 saniye arasında. Adım sayısına ve AI'ın analiz süresine bağlı olarak değişebilir.

Hangi Gauge versiyonları destekleniyor?

Tüm Gauge BDD formatları desteklenir. Format standart Gauge spec formatına uygun olmalıdır.

AI her zaman doğru mu dönüştürür?

AI, %90+ doğruluk oranıyla çalışır. Ancak çok karmaşık veya belirsiz adımlar için manuel düzenleme gerekebilir.

Ücretsiz mi?

Evet, tamamen ücretsizdir. Kayıt veya giriş gerektirmez.

Verilerim saklanıyor mu?

Hayır, hiçbir veri saklanmaz. Tüm işlemler tarayıcınızda ve sunucuda geçici olarak yapılır.

🔗 Faydalı Linkler

Maestro Documentation - Maestro framework dokümantasyonu
Gauge Framework - Gauge BDD framework dokümantasyonu
Ana Sayfa - Converter'a geri dön

📖 Nasıl Kullanılır?