Cline bir döngüdür: bir değişiklik planlar, dosyaları düzenler, komutları çalıştırır, çıktıyı okur ve sonra ne yapacağına karar verir. Peki neden API testleriniz bu döngüde değil? Apidog'da bir GUI'nin arkasında oturuyorlar, birilerinin tıklamayı hatırlamasını bekliyorlar. Aracınız onlara asla dokunmuyor.
Çözüm, tek bir yapılandırma bloğudur. Apidog CLI, Apidog'da oluşturduğunuz test senaryolarını doğrudan bir terminalden çalıştıran bir npm paketi olan apidog-cli'dir. CLI yüklendikten ve Cline bunun var olduğunu öğrendikten sonra, aracınız bir Apidog senaryosunu birim testlerinizi çalıştırdığı gibi çalıştırır: komutu ateşler, çıkış kodunu okur, kırmızı gelirse kodu düzeltir.
Henüz CLI'yi yüklemediyseniz, önce bunu yapın. Bir AI kodlama ajanı ile Apidog CLI nasıl kurulur makalesi, npm kurulumunu, kimlik doğrulamayı ve Cline'ın yazdığı ilk çalıştırmayı adım adım anlatır. Bu makale, apidog --version'ın bir sayı yazdığını ve Apidog hesabınızın kimliğinin doğrulandığını varsayar.
Hangi Cline'dan bahsediliyor
Cline, bir VS Code uzantısı olarak çalışan açık kaynaklı otonom kodlama aracıdır (bir JetBrains yapısı ve bir CLI de bulunmaktadır). Deponuzu okur, Plan modunda plan yapar, ardından Act moduna geçerek dosyaları düzenler ve kabuk komutlarını çalıştırır, otomatik onay ayarlarınıza göre onay ister. Barındırılan bir sohbet robotu değildir; model, kod tabanınıza karşı kendi makinenizde çalışır. VS Code'da Cline panelini açık tutuyorsanız ve çalışırken farkları ve terminal çıktısını gösteriyorsa, doğru yerdesiniz demektir. Cline nasıl kullanılır makalesi, kurulumunun ve bir model seçmenin temellerini kapsar.
Bu ayrım önemlidir çünkü Cline'ın proje kurallarını öğrenmek için kendi yolu vardır ve bu mekanizma, tek seferlik bir "testlerimi çalıştır" komutunu Cline'ın kendiliğinden ulaşacağı bir şeye dönüştürür. Bu mekanizma .clinerules/ dizinidir.
Adım 1: Kuralı bir sohbet hatırlatıcısı olarak değil, .clinerules'e ekleyin
Cline, bir göreve başlamadan önce çalışma alanı kökünüzdeki bir .clinerules/ dizininden proje kurallarını yükler. Bu klasörün içindeki her .md ve .txt dosyasını okur ve bunları oturum boyunca taşıdığı talimat setinde birleştirir. Tercih ederseniz tek bir .clinerules dosyası da kullanabilirsiniz, ancak kurallarınız büyüdükçe dizin daha iyi ölçeklenir. Bu, Cline kuralları referansında belgelenmiştir.
Depo kökünüzde .clinerules/apidog.md gibi bir dosya oluşturun ve içine şu kısa bloğu 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.
CLI'yi sohbette belirtmek yerine .clinerules/ içine yazmanızın nedeni budur. Bir Cline mesajına yazılan bir senaryo kimliği, görev sona erdiğinde kaybolur. .clinerules/apidog.md içindeki bir kimlik ise, depoyu kontrol eden her ekip üyesi ve bundan sonraki her Cline görevi için oradadır. Dosya sürüm kontrolünde olduğu için kural kodla birlikte seyahat eder.
Adım 2: Komutu Apidog'dan alın
Tahmin edilen bir komut değil, gerçek apidog run komutuna ihtiyacınız var. Test senaryosunu Apidog'da açın, CI/CD sekmesine gidin ve oluşturulan komutu kopyalayın. Şuna benzer:
apidog run -t 8291 -e 42 -r cli
-t değeri test senaryo kimliğinizdir ve -e ortam kimliğidir. Bunlar, .clinerules/apidog.md'ye ait olan kesin değerlerdir. Cline'ın her zaman doğru kimliklere sahip olması için bunları kural bloğuna yapıştırın. Tam bayrak seti için apidog run komut referansına bakın.
Adım 3: Cline'ın testi çalıştırmasını sağlayın
Kural yerleştirildikten sonra Cline panelinde bir görev başlatın. Cline başladığında .clinerules/ dosyasını yükler, bu yüzden CLI'nin orada olduğunu zaten bilir. API'nizi etkileyen bir değişiklik yapın veya sadece kontrolü çalıştırmasını isteyin:
Apidog test senaryosunu çalıştır ve bana sonucu söyle.
Cline adımı planlar, ardından kurallarınızdan apidog run komutunu vermek için Act moduna geçer. İlk ne kadar soru sorduğu onay ayarlarınıza bağlıdır. Cline her komutu değerlendirir ve onu güvenli veya onay gerektiren olarak işaretler; bir hazırlık ortamına karşı salt okunur bir test senaryosu, güvenli olarak kabul ettiği türden bir komuttur. Otomatik onay ayarlarınız güvenli komutların yürütülmesine izin veriyorsa, apidog run bir uyarı olmadan çalışır. Aksi takdirde, Cline duraklar ve sorar; onaylayın ve gelecekteki senaryoları kendiliğinden çalıştırmasını istiyorsanız "execute-safe-commands" için otomatik onayı açın. -r cli raporlayıcısı, terminalde adım adım bir sonuç ve bir özet yazdırır, burada her isteği ve onaylamayı gerçekleşirken izleyebilirsiniz.
Adım 4: Raporu Cline içinde okuyun
Bir çalıştırma başarısız olduğunda, rapor cevabı içerir. -r cli ile Cline, terminal çıktı panelinde okunabilir bir döküm alır: her istek, her onaylama ve hangisinin başarısız olduğu, beklenen ve gerçek değerlerle birlikte. Başarısız olan onaylama, tam alanı veya durum kodunu belirtir; bu genellikle Cline'ın bir sonraki geçişinde düzeltmeyi bulması için yeterlidir.
Bir tarayıcıda açabileceğiniz veya bir ekip arkadaşınıza verebileceğiniz bir rapor için HTML raporlayıcıyı ekleyin:
apidog run -t 8291 -e 42 -r cli,html
html raporlayıcısı, ./apidog-reports dizinine kendi kendine yeten bir dosya yazar. Listede cli'yi tutun ki Cline, bir sonraki adımına karar vermek için okuduğu satır içi çıktıyı hala alabilsin. JUnit formatındaki CI gösterge panellerinin ayrıştırması dahil her bayrak ve raporlayıcı için tam Apidog CLI kılavuzuna ve Apidog CLI test raporları kılavuzuna bakın.
Cline kendi döngüsünde test yapıyor
Karşılığı, siz sormayı bıraktığınızda ve .clinerules/ ona söylediği için Cline'ın senaryoyu kendiliğinden çalıştırmasıdır.
Cline'ın bir ödeme yanıtı oluşturan bir işleyiciyi düzenlediğini hayal edin. Döngüsü değişir: kodu düzenler, sonra zafer ilan etmek yerine Apidog senaryonuzu hazırlık ortamına karşı çalıştırır, çıkış kodunu okur ve buna göre hareket eder. Yeşilse ilerler. Kırmızıysa raporu açar, hangi onaylamanın başarısız olduğunu (durum kodu, eksik alan, yanlış değer) okur, bir düzeltme dener ve tekrar çalıştırır. API testi, Cline'ın birim testlerinizi zaten çalıştırdığı aynı düzenleme-test-düzeltme döngüsünün bir parçası haline gelir. Tek bir talimat yazdınız ve Cline komutu zaten nasıl çalıştığına dahil etti.
Bu, herhangi bir aracı iş akışını güvenli hale getiren delege et-doğrula modelidir. Cline komutu çalıştırır ve sonucu okur; siz Apidog'da senaryoları görsel olarak yazmaya devam edersiniz ve aracının çıkış kodlarını dürüstçe okuduğunu kontrol edersiniz. Daha geniş kalıp için, API testi için AI aracılarının nasıl kullanılacağına ve Apidog AI test koşumuna bakın.
Cline'ın gerçekten CLI'yi çalıştırdığını doğrulayın
Aracılar kazanmadıkları başarıyı rapor eder ve Cline da bir istisna değildir. Sorunları ne sıklıkla yakaladıklarına göre üç kontrol.
İlk olarak, komutun hiç çalışıp çalışmadığını onaylayın. Cline, görev görünümünde çalıştırdığı komutları ve bunların satır içi çıktılarını gösterir. Tam anlamıyla apidog run ... satırını ve altında bir sonucu arayın. Cline testleri çalıştırdığını söylüyor ancak komutu görmüyorsanız, hiç yapmadığı bir şeyi özetlemiştir. Tekrar çalıştırmasını ve ham çıktıyı göstermesini isteyin.
İkincisi, önemli olan çıkış kodunu onaylayın:
Bu apidog çalıştırma komutunun çıkış kodu neydi?
apidog run, her onaylama geçtiğinde 0 ve herhangi bir şey başarısız olduğunda sıfır olmayan bir değerle çıkar. Bu tek davranış, Cline'ın veya bir pipeline'ın çalıştırmayı temiz bir geçit olarak ele almasını sağlar. Cline'ın metni "testler geçti" dediğinde ancak çıkış kodu sıfır değilse, çıkış kodu doğrudur.
Üçüncüsü, gerçek senaryoyu kullandığını onaylayın. Eğer bir çalıştırma "senaryo bulunamadı" hatasıyla başarısız olursa, Cline bir kimlik uydurmuş veya yanlış hatırlamış olabilir. -t ve -e değerlerini .clinerules/apidog.md ve Apidog'un CI/CD sekmesinde oluşturduğu komutla tekrar kontrol edin. Kurallar dosyasındaki kimlikler gerçektir.
İsteğe Bağlı: Apidog MCP sunucusunu bağlayın
.clinerules/'den apidog run çalıştırmak, ihtiyacınız olan çoğu şeyi kapsar. Bir yol daha ileri gider.
Cline, Model Bağlam Protokolü için birinci sınıf desteğe sahiptir. VS Code uzantısında, Cline panelindeki MCP Sunucuları simgesine tıklayın, Yapılandır'ı açın ve cline_mcp_settings.json dosyasını açmak için MCP Sunucularını Yapılandır'a tıklayın; sunucunuzu mcpServers nesnesinin altına ekleyin. Ayrıca Cline içinde MCP Pazar Yeri'ne göz atarak JSON'u elle düzenlemeden sunucuları yükleyebilirsiniz, bu durum Cline MCP dokümantasyonunda açıklanmıştır. Apidog MCP sunucusu, API belirtimlerinizi MCP üzerinden ifşa eder, böylece Cline kod yazarken, sadece sonradan değil, şemanızı okuyabilir. CLI testleri çalıştırır; MCP, aracıya belirtimi besler.
Cline etkileşimli bir uzantıdır, bu nedenle bir başsız çalıştırıcının sağlayacağı şekilde içine yerleşik etkileşimli olmayan bir test modu yoktur. Bir pipeline'da Cline olmadan apidog run çalıştırmak için, GitHub Actions'da Apidog CLI sırları, raporlayıcıları ve çıkış kodu denetimini kapsar ve Apidog CLI CI/CD pipeline kılavuzu daha geniş kurulumu kapsar.
Cline yanlış yaptığında
Kurulum sırasında birkaç hata sıkça ortaya çıkar.
Kurallar dosyasını yok sayar. Cline genel bir komut çalıştırırsa veya hiç çalıştırmazsa, kural yüklenmiyor olabilir. Klasörün tam olarak .clinerules olarak adlandırıldığını ve çalışma alanı kökünüzde bulunduğunu, içindeki dosyanın .md veya .txt ile bittiğini onaylayın. Yeni bir görev başlatmak, Cline'ı kuralları yeniden yüklemeye zorlar.
Yine de bir erişim jetonu iletir. Cline --access-token eklemeye çalışırsa, genel örneklerden tahmin yürütüyordur. Makine apidog login aracılığıyla kimliği doğrulanmış olduğundan, kural zaten bunu yapmamasını söyler. Bu satırı pekiştirin ve asla gerçek bir jetonu .clinerules/ içine koymayın. Kimlik doğrulamanın aslında nasıl çalıştığını öğrenmek için Apidog CLI kimlik doğrulama kılavuzuna bakın.
Bir bayrak uydurur. "Bilinmeyen seçenek" hatası, Cline'ın sürümünüzde olmayan bir bayrağı tahmin ettiği anlamına gelir. apidog run --help komutunu çalıştırmasını söyleyin ve oradaki tam bayrağı kopyalayın, bu her zaman yüklü sürümünüz için doğrudur.
Başarısız bir çalıştırmada geçtiğini rapor eder. En maliyetli olanıdır ve çıkış kodu kuralının hem .clinerules/ dosyanızda hem de doğrulama adımınızda olmasının nedenidir. Özet ve çıkış kodu uyuşmadığında, çıkış kodu kazanır.
Günlük bir ajandan test edilmiş bir döngüye
Kurulum budur. Kurulum kılavuzunu takip ederek apidog-cli'yi bir kez yükleyin, deponuzun .clinerules/ dizinine kısa bir Apidog kuralı ekleyin ve Cline, API testlerinizi nasıl çalıştıracağını ve kodu düzenlemek için zaten kullandığı aynı döngünün içinde sonucu nasıl okuyacağını bilecektir. Bozuk bir uç nokta, Cline değişiklik üzerinde çalışırken yakalanır, gönderildikten sonra değil.
Bir GUI'nin arkasındaki bir test, bir insan tıkladığında çalışır; tek satırlık bir komut ise Cline ne zaman karar verirse o zaman çalışır. Apidog'da senaryoları görsel olarak oluşturmaya devam edersiniz ve aracınız siz izlemezken onları çalıştırır. Apidog'u indirin, bir senaryo oluşturun, apidog run komutunu .clinerules/apidog.md içine bırakın ve Cline'ın bir sonraki değişiklikte onu nasıl alıp kullandığını izleyin.