Apidog CLI vs Hoppscotch CLI: CI/CD İçin En Uygun Araç Hangisi

Hem Apidog CLI hem de Hoppscotch CLI, API testlerini bir terminalden çalıştırır ve her ikisi de bir CI/CD hattına uyar. Ancak farklı yerlerden geliyorlar. Hoppscotch açık kaynaklı bir API ekosistemidir ve CLI'ı odaklanmış bir koleksiyon çalıştırıcısıdır. Apidog hepsi bir arada bir API platformudur ve CLI'ı, daha büyük bir tasarım-test-mock-doküman iş akışının terminal giriş noktasıdır.

Düğme

Hızlı karar

Açık kaynak ve kendi kendine barındırmanın en önemli olduğu durumlarda, zaten Hoppscotch kullanıyorsanız ve bir JUnit raporu raporlama ihtiyaçlarınızı karşılıyorsa **Hoppscotch CLI'ı seçin**.
CLI, HTML ve JSON raporları, CSV ve JSON üzerinden veri odaklı çalıştırmalar, bulutta barındırılan raporlar ve CLI'ın arkasında entegre bir platform istiyorsanız **Apidog CLI'ı seçin**.

Karşılaştırma

	Apidog CLI	Hoppscotch CLI
Kurulum	Apidog runner / `apidog` CLI	`npm i -g @hoppscotch/cli` (Node v22+)
Çalıştırdığı	Test senaryoları ve koleksiyonları	Hoppscotch koleksiyonları
Kaynak	Apidog projesi veya OpenAPI içe aktarımı	Koleksiyon JSON dosyası veya örnek kimliği
Veri odaklı	`-d` CSV ve JSON	`--iteration-data` CSV + `--iteration-count`
Raporlayıcılar	CLI, HTML, JSON + bulut yükleme	JUnit XML
Betik oluşturma	Ön/son işlemciler, iddialar	Ön istek + `pw.test()` / `pw.expect()`
Şartname denetimi	Bağımsız linter yok (içe aktarımda doğrular)	Yok (çalıştırıcıdır)
Kod olarak kaynaklar	Uç noktalar, şemalar, dallar, birleştirme istekleri	Yok
Açık kaynak	Yok (ücretsiz katman)	Evet, kendi kendine barındırılabilir
Daha geniş platform	Tek bir uygulamada tasarım, mock, dokümanlar, test	Hoppscotch ekosisteminin bir parçası

Kurulum ve çalışma zamanı

Hoppscotch CLI, npm'den yüklenir ve Node.js v22 veya daha yenisine ihtiyaç duyar (Node 20 kullanıcıları CLI v0.26.0'da kalır):

npm i -g @hoppscotch/cli
hopp test ./collection.json -e ./staging.env.json

Apidog CLI, Apidog çalıştırıcısı aracılığıyla gelir ve bir oturum açma veya erişim belirteci ile kimlik doğrulaması yapar, ardından senaryoları kimliğe göre çalıştırır:

apidog run -t <scenario-id> -e <env-id> --access-token <token>

Her iki kurulum da ağır değildir. Tek sorun, eski CI imajlarında sorun çıkaran Hoppscotch'un katı Node v22 gereksinimidir. Sıfırdan başlıyorsanız Apidog CLI kurulum rehberi çalıştırıcı kurulumunu kapsar.

Her birinin çalıştırdığı

Hoppscotch CLI bir Hoppscotch koleksiyonunu çalıştırır. Ya yerel bir koleksiyon JSON dosyası iletirsiniz ya da bir belirteç (token) ile bir Hoppscotch örneğinden kimliğe göre bir tane çekersiniz:

hopp test <collection-id> --token <access_token> --server https://hoppscotch.your-company.com

Her istek için ön istek betiğini çalıştırır, isteği gönderir ve pw.test() ile pw.expect() ile test betiğini değerlendirir. Başarısız bir iddia (assertion), sıfır olmayan bir çıkış kodu üretir.

Apidog CLI, Apidog projenizde oluşturulmuş test senaryolarını çalıştırır; bunlar adımları zincirleyebilir, değişkenleri paylaşabilir ve yanıtlar arasında iddialarda bulunabilir. CLI platformun bir parçası olduğu için, uygulamada tasarladığınız ve hata ayıkladığınız senaryoları CI'da çalıştırırsınız; ayrı bir dışa aktarma adımı yoktur. Senaryo modeli için Apidog CLI tam rehberine ve uygulamalı çalıştırma için komut satırından REST API testine bakın.

Veri odaklı test

Her iki araç da bir veri kümesi üzerinde bir testi yineler; bu, çoğu ekibin önemsediği özelliktir.

Hoppscotch, CSV yineleme verilerini ve bir sayıyı kullanır:

hopp test ./collection.json --iteration-data ./users.csv --iteration-count 5

Apidog, -d ile CSV ve JSON veri kümelerini kabul eder:

apidog run -t <scenario-id> -d ./users.csv -r cli,html

Pratik fark, format esnekliğidir. Hoppscotch CSV okurken; Apidog CSV ve JSON okur; bu, fikstürleriniz iç içe olduğunda veya zaten JSON olarak bulunduğunda önemlidir. Apidog CLI veri odaklı test rehberi, CSV ve JSON modellerini yan yana gösterir.

Raporlama

Bu en net ayrımdır. Hoppscotch CLI, JUnit XML yazar:

hopp test ./collection.json --reporter-junit ./report.xml

JUnit yaygın olarak desteklenir, bu nedenle çoğu CI sistemi sonuçları doğal olarak görüntüler. Ancak CLI'ın ürettiği tek yapılandırılmış format budur.

Apidog CLI, CLI, HTML ve JSON raporları yayınlar ve barındırılan, paylaşılabilir bir bağlantı için sonuçları buluta yükleyebilir:

apidog run -t <scenario-id> -r cli,html,json
apidog run -t <scenario-id> --upload-report

Bir PR gözden geçireni için kendi kendine yeten bir HTML yapıtı veya bir Slack kanalına bırakmak üzere barındırılan bir rapor URL'si istiyorsanız, Apidog daha fazla formatı kapsar. Apidog CLI test raporları rehberi her birini ayrıntılı olarak açıklar. CI panonuzda JUnit'ten başka bir şeye ihtiyacınız yoksa, Hoppscotch gayet iyidir.

Açık kaynak ve kendi kendine barındırma

Burada Hoppscotch kendi şartlarıyla kazanır. Tüm ekosistem açık kaynaklı ve kendi kendine barındırılabilir, böylece arka ucu kendiniz çalıştırabilir ve istek verilerini herhangi bir satıcı bulutundan uzak tutabilirsiniz. Katı veri ikamet kuralları olan veya açık kaynaklı araçları tercih eden ekipler için bu, onu seçmek için gerçek, savunulabilir bir nedendir. Hoppscotch alternatifleri özeti ve Postman vs Hoppscotch daha geniş ekosistemi kapsar.

Apidog açık kaynaklı değildir. Ücretsiz bir katmanı vardır ve iddiası 'daha açık' değil; 'daha entegre' olmaktır.

Test çalıştırmanın ötesinde

Burası, Apidog CLI'ın sadece bir çalıştırıcı olmaktan çıktığı yerdir. API kaynaklarını kod olarak yönetir: OpenAPI'yi içe aktarır ve terminalden uç noktalar, şemalar, ortamlar, dallar ve birleştirme istekleriyle çalışır. Bu, CLI'ı tek seferlik bir test komutu olmaktan ziyade Git tarzı bir iş akışının bir parçası yapar.

Aynı zamanda tam bir platformun terminal yüzüdür. Aynı proje API tasarımını, mock sunucularını, dokümantasyonu ve testleri yönlendirir. Hoppscotch CLI, tasarımsal olarak yalnızca koleksiyonları çalıştırır ve başka bir şey yapmaz; tasarım, mock ve dokümanları başka yerlerden getirirsiniz.

Dürüstlük notu: Apidog CLI'da bağımsız bir OpenAPI linter veya stil rehberi komutu yoktur. Spesifikasyonları içe aktarırken doğrular, ancak özel bir linter'ın yaptığı gibi denetlemez. Terminal spesifikasyon denetimi katı bir gereksinimse, bu çalıştırıcıların hiçbiri sizin linter'ınız değildir; Redocly CLI veya Spectral gibi bir araçtır. Apidog CLI vs Newman bölümünde çalıştırıcı takaslarını karşılaştırın.

Kimi neyi seçmeli

**Tek başına geliştirici veya açık kaynak öncelikli ekip, zaten Hoppscotch kullanıyor:** Hoppscotch CLI. Ücretsiz, kendi kendine barındırılabilir, JUnit ile CI'a entegre, tamam.
**Tasarım, mock, dokümanlar ve test için tek bir platform isteyen,** CSV/JSON üzerinden veri odaklı çalıştırmalar ve HTML/JSON/bulut raporları olan bir ekip: Apidog CLI. Denemek için Apidog'u indirin ve mevcut bir koleksiyonu içe aktarın.
**Sadece CI'da hızlı bir koleksiyon çalıştırmasına ihtiyacı olan ve başka bir gereksinimi olmayan:** her ikisi de işe yarar; koleksiyonlarınızın zaten hangi uygulamada bulunduğuna göre seçin.

Sıkça Sorulan Sorular

**Her ikisi de veri odaklı testi destekliyor mu?** Evet. Hoppscotch --iteration-data (CSV) ile --iteration-count kullanır; Apidog -d ile CSV veya JSON kullanır.
**Hangisinin raporları daha iyi?** Hoppscotch JUnit XML yazar. Apidog CLI, HTML ve JSON yazar, ayrıca barındırılan bulut raporları sunar. JUnit'ten fazlasına ihtiyacınız varsa, Apidog daha fazla formatı kapsar.
**Hoppscotch CLI ücretsiz ve açık kaynaklı mı?** Evet ve kendi kendine barındırılabilir. Resmi belgeler ve GitHub deposu ayrıntıları içerir. Apidog'un ücretsiz bir katmanı vardır ancak açık kaynaklı değildir.
**Hoppscotch koleksiyonlarımı Apidog'a taşıyabilir miyim?** Evet. Koleksiyonu dışa aktarın ve içe aktarın, ardından apidog run ile çalıştırın. Geçiş rehberi komut eşlemesini kapsar.

Her iki çalıştırıcı da temel işi iyi yapar. Açık kaynak ve kendi kendine barındırma için Hoppscotch CLI'ı seçin; daha zengin veri odaklı çalıştırmalar ve raporlarla entegre bir API platformunun bir parçası olmasını istediğinizde Apidog'u seçin.