Apidog CLI'ı Cline'da Nasıl Kullanılır

Cline; değişiklik planlayan, dosyaları düzenleyen, komutları çalıştıran, çıktıları okuyan ve sonraki adımına karar veren bir döngüyle çalışır. API testleriniz bu döngünün dışında kalıyorsa, bir GUI içinde manuel tıklama bekliyordur. Apidog CLI ile test senaryolarını doğrudan Cline'ın terminal döngüsüne ekleyebilirsiniz: komutu çalıştırır, çıkış kodunu okur ve test başarısızsa düzeltme yapar.

Apidog'u bugün deneyin

apidog-cli, Apidog'da oluşturduğunuz test senaryolarını terminalden çalıştıran npm paketidir. Cline bu komutu öğrendiğinde API testlerinizi birim testler gibi ele alabilir:

1. Kodu değiştirir.
2. apidog run komutunu çalıştırır.
3. Çıkış kodunu kontrol eder.
4. Sonuç başarısızsa raporu okuyup düzeltmeyi dener.

Henüz CLI'yi yüklemediyseniz önce kurulumu tamamlayın. Bir AI kodlama ajanı ile Apidog CLI nasıl kurulur makalesi npm kurulumu, kimlik doğrulama ve ilk çalıştırma adımlarını kapsar.

Bu rehber şu iki koşulu varsayar:

apidog --version

• Komut bir sürüm numarası döndürüyor.
• Makineniz apidog login ile Apidog hesabınıza bağlandı.

Cline nedir ve neden .clinerules/ kullanılır?

Cline; VS Code uzantısı olarak çalışan açık kaynaklı bir kodlama aracıdır. Depoyu okuyabilir, Plan modunda çözüm planlayabilir ve Act modunda dosya düzenleyip kabuk komutları çalıştırabilir. VS Code'da Cline panelinden farkları ve terminal çıktılarını görüyorsanız doğru ortamdasınız.

Cline nasıl kullanılır makalesi kurulum ve model seçimi temellerini açıklar.

Cline'ın proje kurallarını kalıcı olarak öğrenmesi için çalışma alanı kökünde .clinerules/ dizinini kullanın. Cline görev başlarken bu dizindeki .md ve .txt dosyalarını okur. Böylece tek seferlik sohbet talimatı yerine, sürüm kontrolünde saklanan ve ekip tarafından paylaşılabilen bir kural tanımlarsınız.

Detaylar için Cline kuralları referansına bakın.

Adım 1: Apidog kuralını ekleyin

Depo kökünde aşağıdaki dosyayı oluşturun:

.clinerules/apidog.md

Ardından bu içeriği ekleyin:

# Apidog ile API testi

- API'yi test etmek için curl veya özel betikler yerine Apidog CLI'yi çalıştırın.
- Komut: apidog run -t <senaryo_id> -e <ortam_id> -r cli
- Senaryo Kimliği ve Ortam Kimliği Apidog'un CI/CD sekmesinden gelir. Bu değerleri aynen kullanın.
- Çıkış kodu 0, her onaylamanın geçtiği anlamına gelir. Sıfır dışı bir değer bir hatayı ifade eder; çıkış kodu, özetiniz değil, doğruluk kaynağıdır.
- Makine zaten `apidog login` aracılığıyla kimliği doğrulanmıştır. Asla --access-token eklemeyin ve bu dosyaya asla bir jeton koymayın.
- Eğer bir bayrak bilinmiyorsa, `apidog run --help` komutunu çalıştırın ve oradaki tam bayrağı kullanın.

Bu dosyada senaryo ve ortam kimliklerini saklamak, Cline'ın her görevde doğru komutu kullanmasını sağlar. Sohbete yazılan bir kimlik görev sonunda kaybolabilir; .clinerules/apidog.md ise kodla birlikte sürüm kontrolünde kalır.

Adım 2: Gerçek apidog run komutunu kopyalayın

Tahmin edilen bir komut kullanmayın. Apidog'da test senaryonuzu açın, CI/CD sekmesine gidin ve oluşturulan komutu kopyalayın.

Örnek:

apidog run -t 8291 -e 42 -r cli

Burada:

• -t 8291: Test senaryosu kimliği
• -e 42: Ortam kimliği
• -r cli: Terminalde okunabilir test çıktısı

Bu değerleri .clinerules/apidog.md dosyanıza yerleştirin. Böylece Cline her seferinde aynı senaryoyu ve ortamı çalıştırır.

Tüm seçenekler için apidog run komut referansını inceleyin.

Adım 3: Cline ile testi çalıştırın

Yeni bir Cline görevi başlatın. Cline başlangıçta .clinerules/ dosyalarını yükler.

Cline'a doğrudan şu görevi verebilirsiniz:

Apidog test senaryosunu çalıştır ve bana sonucu söyle.

API davranışını değiştiren bir kod düzenlemesinden sonra da aynı komutu çalıştırmasını isteyebilirsiniz.

Cline şu akışı izlemelidir:

kod değişikliği
→ apidog run
→ terminal çıktısı
→ çıkış kodu
→ gerekirse düzeltme

Cline'ın komutu otomatik çalıştırıp çalıştırmaması, onay ayarlarınıza bağlıdır. Güvenli komutlar için otomatik onay açıksa apidog run doğrudan çalışabilir. Aksi durumda Cline onay ister.

-r cli raporlayıcısı her isteği, onaylamayı ve genel özeti terminal çıktısında gösterir.

Adım 4: Başarısız test raporunu kullanın

Bir test başarısız olduğunda, -r cli çıktısı Cline'ın hata nedenini okumasına yardımcı olur. Çıktıda genellikle şunlar bulunur:

• İstek bilgisi
• Başarısız onaylama
• Beklenen değer
• Gerçek değer
• Durum kodu veya eksik alan bilgisi

Örneğin, Cline yanlış bir durum kodu veya eksik response alanı görürse ilgili işleyiciyi güncelleyip testi yeniden çalıştırabilir.

Tarayıcıda açılabilen bir rapor da üretmek için HTML raporlayıcıyı ekleyin:

apidog run -t 8291 -e 42 -r cli,html

html raporlayıcısı kendi kendine yeten raporu ./apidog-reports dizinine yazar. cli raporlayıcısını da koruyun; Cline sonraki adımına karar vermek için terminal çıktısına ihtiyaç duyar.

JUnit dahil raporlayıcılar ve bayraklar için şu kaynakları kullanın:

• Tam Apidog CLI kılavuzu
• Apidog CLI test raporları kılavuzu

Cline'ın düzenleme-test-düzeltme döngüsüne API testini ekleyin

Örneğin Cline'ın ödeme yanıtı üreten bir işleyiciyi düzenlediğini düşünün. .clinerules/apidog.md içindeki talimat sayesinde akış şu şekilde olur:

1. İşleyicide değişiklik yapar.
2. Apidog senaryosunu hazırlık ortamında çalıştırır.
3. Çıkış kodunu kontrol eder.
4. Test yeşilse göreve devam eder.
5. Test kırmızıysa başarısız onaylamayı inceler.
6. Düzeltmeyi uygular ve testi tekrar çalıştırır.

Bu yaklaşım, API testini manuel bir kontrol olmaktan çıkarıp kod değişikliği döngüsünün bir parçası yapar.

Daha geniş kullanım kalıpları için şu rehberlere bakın:

• API testi için AI aracılarının nasıl kullanılacağı
• Apidog AI test koşumu

Cline'ın gerçekten CLI'yi çalıştırdığını doğrulayın

Bir aracının “testler geçti” özeti tek başına yeterli değildir. Üç kontrol uygulayın.

1. Komutun çalıştığını doğrulayın

Cline görev görünümünde çalıştırdığı komutları ve satır içi çıktıları gösterir. Şunu görmeniz gerekir:

apidog run ...

Komut görünmüyorsa Cline testi gerçekten çalıştırmamış olabilir. Ham terminal çıktısını göstermesini isteyin.

2. Çıkış kodunu sorun

Cline'a şu soruyu yöneltin:

Bu apidog çalıştırma komutunun çıkış kodu neydi?

apidog run davranışı nettir:

• 0: Tüm onaylamalar geçti.
• Sıfır dışı değer: En az bir hata oluştu.

Cline “testler geçti” dese bile çıkış kodu sıfır değilse, başarısız kabul edin. Doğruluk kaynağı çıkış kodudur.

3. Doğru senaryo ve ortamın kullanıldığını kontrol edin

senaryo bulunamadı hatası alırsanız Cline yanlış kimlik kullanmış olabilir. Şu değerleri karşılaştırın:

• Apidog CI/CD sekmesindeki oluşturulmuş komut
• .clinerules/apidog.md içindeki -t değeri
• .clinerules/apidog.md içindeki -e değeri

Kimlikleri tahmin etmeyin; Apidog'un oluşturduğu komuttaki değerleri kullanın.

İsteğe bağlı: Apidog MCP sunucusunu bağlayın

.clinerules/ içinden apidog run çalıştırmak çoğu kullanım senaryosu için yeterlidir. Ancak Cline'ın API belirtiminizi kod yazarken de okuyabilmesini istiyorsanız Apidog MCP sunucusunu ekleyebilirsiniz.

Cline, Model Bağlam Protokolü (MCP) desteği sunar. VS Code uzantısında:

1. Cline panelindeki MCP Sunucuları simgesini açın.
2. Yapılandır seçeneğine tıklayın.
3. cline_mcp_settings.json dosyasını açın.
4. Sunucunuzu mcpServers nesnesi altına ekleyin.

Alternatif olarak Cline içindeki MCP Pazar Yeri üzerinden sunucu yükleyebilirsiniz. Ayrıntılar için Cline MCP dokümantasyonuna bakın.

Apidog MCP sunucusu, API belirtimlerinizi MCP üzerinden sunar. Böylece:

• CLI testleri çalıştırır.
• MCP, Cline'a API şemasını sağlar.

Cline etkileşimli bir uzantıdır; yerleşik başsız test çalıştırıcısı değildir. CI pipeline içinde Cline olmadan test çalıştırmak için şu kaynakları kullanın:

• GitHub Actions'da Apidog CLI
• Apidog CLI CI/CD pipeline kılavuzu

Yaygın sorunlar ve çözümleri

Cline kurallar dosyasını yok sayıyor

Cline genel bir komut çalıştırıyorsa veya hiç komut çalıştırmıyorsa dosya yüklenmiyor olabilir.

Şunları kontrol edin:

• Klasör adı tam olarak .clinerules olmalı.
• Klasör depo veya çalışma alanı kökünde bulunmalı.
• İçindeki dosya .md ya da .txt uzantılı olmalı.
• Yeni bir Cline görevi başlatılmalı.

Yeni görev, kuralların yeniden yüklenmesini sağlar.

Cline --access-token eklemeye çalışıyor

Makine zaten apidog login ile kimliği doğrulanmışsa --access-token kullanmayın. Gerçek erişim jetonlarını hiçbir zaman .clinerules/ dosyasına koymayın.

Gerekirse kuralı daha açık hale getirin:

- Asla `--access-token` kullanmayın.
- Kimlik doğrulama için yalnızca mevcut `apidog login` oturumunu kullanın.

Kimlik doğrulama ayrıntıları için Apidog CLI kimlik doğrulama kılavuzuna bakın.

Cline geçersiz bir bayrak kullanıyor

unknown option veya benzeri bir hata, Cline'ın yüklü sürümünüzde olmayan bir bayrağı tahmin ettiğini gösterir.

Şu komutu çalıştırın:

apidog run --help

Ardından yalnızca bu çıktıda listelenen bayrakları kullanın.

Cline başarısız testi başarılı olarak özetliyor

Özet metni ile çıkış kodu çelişiyorsa çıkış kodunu esas alın:

0         → başarılı
0 dışı    → başarısız

Bu kural hem .clinerules/apidog.md dosyanızda hem de manuel doğrulama sürecinizde bulunmalıdır.

Sonuç

Kurulum üç adımdan oluşur:

1. Kurulum kılavuzunu izleyerek apidog-cli paketini yükleyin.
2. .clinerules/apidog.md dosyasına gerçek apidog run komutunu ekleyin.
3. Cline'ın her çalıştırmada komutu, terminal çıktısını ve çıkış kodunu kontrol ettiğini doğrulayın.

Böylece API testleri GUI'de manuel tıklama beklemez. Cline bir uç noktayı değiştirdiğinde aynı düzenleme-test-düzeltme döngüsünde Apidog senaryosunu çalıştırabilir ve sorunları kod gönderilmeden önce yakalayabilir.

Apidog içinde senaryolarınızı görsel olarak oluşturmaya devam edin; ardından oluşturulan apidog run komutunu .clinerules/apidog.md dosyasına ekleyin. Apidog'u indirin, bir senaryo oluşturun ve Cline'ın sonraki değişiklikte testi nasıl çalıştırdığını izleyin.