Yıllardır, Postman koleksiyonlarını masaüstü uygulaması dışında çalıştırmak tek bir araç anlamına geliyordu: Newman. Ardından Postman kendi resmi komut satırı aracını, Postman CLI'ı yayınladı ve şimdi kabaca aynı şeyi yapmanın iki yolu var. Her ikisi de GUI olmadan koleksiyonları çalıştırır, her ikisi de CI/CD işlem hatlarına uyar ve her ikisi de aynı test komut dosyalarını yürütür. Peki neden iki araç ve işlem hattınızda hangisi olmalı?
Kısa versiyonu: Newman, ilk günlerden beri topluluk standardı olan açık kaynaklı, hesap gerektirmeyen çalıştırıcıdır. Postman CLI ise çalıştırmaları Postman bulutuna bağlayan ve sonuçları oraya raporlayan daha yeni, hesaba bağlı bir araçtır. Doğru seçim, sonuçların Postman'ın platformunda depolanmasını isteyip istemediğinize veya yalnızca bir koleksiyon dosyasına ihtiyaç duyan bir çalıştırıcıyı tercih edip etmediğinize bağlıdır. Bu makale, karar verebilmeniz için onları dürüstçe karşılaştırıyor.
Newman Nedir
Newman, Postman'ın orijinal komut satırı koleksiyon çalıştırıcısıdır. Açık kaynaklıdır, bir npm paketi olarak dağıtılır ve tamamen ücretsizdir. Postman'dan dışa aktarılan koleksiyon dosyalarını çalıştırır, her isteği ve her pm.test doğrulamasını yürütür ve sonucu çıkış kodu aracılığıyla bildirir.
Newman'ın tanımlayıcı özelliği bağımsızlıktır. Bir Postman hesabı, bir API anahtarı veya Postman'ın sunucularına bir ağ bağlantısı gerektirmez. Ona bir JSON koleksiyon dosyası verirsiniz ve o çalışır. Bu da onu kısıtlı ortamlarda tahmin edilebilir ve hakkında mantık yürütülmesi kolay hale getirir.
npm install -g newman
newman run checkout-api.postman_collection.json \
--environment staging.postman_environment.json
Newman aynı zamanda hafif ve genişletilebilirdir. CLI ve JUnit raporlayıcıları ile birlikte gelir ve topluluk, zengin HTML çıktısı için newman-reporter-htmlextra gibi ek raporlayıcıları sürdürür. Bir Node.js paketi olduğu için, bir komut dosyasından programatik olarak da çağırabilirsiniz. Newman ve Postman arasındaki fark hakkındaki rehberimiz, masaüstü uygulamasıyla nasıl ilişkili olduğunu açıklar.
Postman CLI Nedir
Postman CLI, Postman'ın geliştirdiği ve şimdi önerdiği resmi komut satırı aracıdır. Bir npm paketi değil, bir betik ile kurduğunuz tek bir yürütülebilir dosyadır ve bir API anahtarı aracılığıyla Postman hesabınıza bağlıdır.
# install (example for macOS/Linux)
curl -o- "https://dl-cli.pstmn.io/install/osx_64.sh" | sh
# authenticate, then run
postman login --with-api-key YOUR_API_KEY
postman collection run checkout-api
Temel fark bulut bağlantısıdır. Bir koleksiyonu Postman CLI ile çalıştırdığınızda, koleksiyonu doğrudan Postman çalışma alanınızdan kimlik bazında çekebilir ve çalıştırma sonuçlarını Postman platformuna geri gönderir; bu sonuçlar çalışma alanı geçmişinde ve kontrol panellerinde görünür. En büyük satış noktası API yönetişimi ve güvenlik kontrolleridir: Postman CLI, bir işlem hattı sırasında API tanımlarınıza karşı linting (statik analiz) yapabilir, şema ve kural ihlallerini derlemenin bir parçası olarak ortaya çıkarabilir.
Dolayısıyla Postman CLI, saf bir koleksiyon çalıştırıcısından çok, Postman platformu için bir işlem hattı aracısıdır. Ekibiniz Postman'ın bulutunda çalışıyorsa ve çalıştırma geçmişini ve yönetişimi orada merkezileştirmek istiyorsa, bu entegrasyon onu seçmek için bir nedendir.
Karşılaştırmalı Analiz
| Yön | Postman CLI | Newman |
|---|---|---|
| Kaynak | Kapalı kaynak, resmi Postman aracı | Açık kaynak |
| Kurulum | Kurulum betiği, tek yürütülebilir dosya | npm paketi |
| Postman hesabı | Gerekli (API anahtarı ile giriş) | Gerekli değil |
| Koleksiyon kaynağı | Postman bulutundan kimlikle veya yerel dosyadan çeker | Yerel JSON dosyası |
| Çalıştırma sonuçları | Postman platformuna geri raporlanır | Terminal çıktısı ve raporlayıcı dosyaları |
| API yönetişimi/linting | Dahili | Dahil değil |
| Raporlayıcılar | Sınırlı, sonuçlar Postman'da bulunur | CLI, JUnit, ayrıca topluluk HTML raporlayıcıları |
| Çevrimdışı kullanım | Sınırlı, bulut etrafında tasarlandı | Dosya yerel olduğunda tamamen çevrimdışı |
| Olgunluk | Daha yeni | Köklü topluluk standardı |
| Maliyet | Ücretsiz, ancak Postman planının limitlerine bağlı | Ücretsiz, hesap gerektirmez |
Belirleyici eksen Postman bulutudur. Postman CLI, sonuçları ve yönetişimi Postman platformuna beslemek için tasarlanmıştır. Newman ise bir dosyayı çalıştırmak ve yerel olarak raporlamak için tasarlanmıştır, Postman'ın sunucularına herhangi bir bağımlılığı yoktur.
CI/CD'ye Nasıl Uyum Sağlarlar
Her iki araç da Jenkins, GitHub Actions, GitLab CI ve CircleCI dahil olmak üzere herhangi bir CI sağlayıcısında çalışır. Mekanikleri farklılık gösterir.
Newman ile, koleksiyon ve ortam JSON dosyalarını deponuza işlersiniz, Newman'ı işe kurar, çalıştırır ve sıfır olmayan çıkış kodunun bir test hatasında derlemeyi başarısız etmesine izin verirsiniz. Her şey depoda ve işlem hattında kendi kendine yeterlidir. CI/CD'de API testlerini otomatikleştirme ve GitHub Actions ile API test otomasyonu hakkındaki rehberlerimiz bu modeli göstermektedir.
Postman CLI ile, bir Postman API anahtarını CI sağlayıcısında bir sır olarak saklar, kimlik doğrulaması yapar ve koleksiyonu kimliğine göre çalıştırırsınız. Koleksiyon depodan ziyade Postman bulutundan çekilir ve sonuçlar çalışma alanına geri gönderilir. Bu, doğruluk kaynağını Postman'da tutar; bazı ekipler bunu tercih ederken, diğerleri kısıtlayıcı bulur.
Pratik bir fark: Newman, koleksiyon JSON'u depoda yer aldığı için testleri kodunuzla birlikte sürümde tutar. Postman CLI ise kimliğe göre çektiği için testleri Postman'ın platformunda sürümde tutar. Seçim yapmadan önce ekibinizin hangi doğruluk kaynağını istediğine karar verin.
Yönetişim Açısı
İki aracı en net şekilde ayıran tek özellik API yönetişimidir. Postman CLI, Postman çalışma alanınızda depolanan bir API tanımına karşı postman api lint tarzı bir kontrol çalıştırabilir, adlandırma, güvenlik, şema bütünlüğü ve tutarlılık kurallarına göre değerlendirir. Bu kontrol bir işlem hattı içinde çalıştığında, bir kuralı ihlal eden bir tanım, değişiklik birleşmeden önce derlemenin başarısız olmasına neden olur.
Newman'ın bir eşdeğeri yoktur. Koleksiyonları çalıştırır ve test sonuçlarını raporlar; işinin sınırı budur. Kuruluşunuz API tasarım standartlarını otomatik olarak uygulamaya özen gösteriyorsa, bu yetenek yalnızca Postman CLI'da bulunur ve onu seçmek için gerçek bir nedendir. İşlem hattında tasarım kurallarını uygulamazsanız, bu özellik anlamsız hale gelir ve Newman'ın sadeliği kazanır.
Bu konuda dürüst olmak gerekir çünkü karşılaştırmayı yeniden çerçeveler. Postman CLI sadece “Newman'ın yenisi” değildir. O, farklı türde bir araçtır: Postman platformu için bir koleksiyon çalıştırıcısı içeren bir işlem hattı aracısı. Newman ise sadece ve yalnızca bir koleksiyon çalıştırıcısıdır. Bu şekilde gördüğünüzde, seçim özelliklerden çok, testlerinizi Postman platformuna bağlamak isteyip istemediğinize bağlı hale gelir.
Geçiş Hususları
Newman'ı zaten kullanan ekipler bazen Postman CLI'a geçmeleri gerekip gerekmediğini sorar. Bunun için nadiren güçlü bir neden vardır. Newman hala bakımı yapılıyor, hala ücretsiz ve her CI sağlayıcısında hala çalışıyor. Geçiş yapmak, bir API anahtarını CI sırrı olarak eklemek, koleksiyonların kaynaklanma şeklini değiştirmek ve Postman'ın bulutuna bağımlılığı kabul etmek anlamına gelir. Özellikle merkezi çalıştırma geçmişi veya yönetişim denetimleri istemiyorsanız, geçiş maliyeti getirisinden daha fazladır.
Yeni başlayan ekipler daha ilginç bir seçimle karşı karşıyadır. Ekip, Postman'ı birincil aracı olarak benimsiyorsa ve bir plan için ödeme yapıyorsa, Postman CLI her şeyi tek bir ekosistemde tutar ve doğal bir tercihtir. Ekip esneklik, depo sürümündeki testler ve tek bir satıcının bulutundan bağımsızlık istiyorsa, Newman veya tamamen Postman dışı bir araç daha mantıklı olacaktır. Evrensel olarak doğru bir cevap yoktur; yalnızca ekibinizin zaten nasıl çalıştığına uygun bir cevap vardır.
Hangisini Seçmelisiniz
Hesap bağımlılığı olmayan bir çalıştırıcı istiyorsanız, testlerinizi deponuzda sürümlemek istiyorsanız, topluluk raporlayıcıları aracılığıyla zengin HTML raporlamasına ihtiyacınız varsa veya Postman'ın bulutuna çağrı yapılmasına izin verilmeyen kısıtlı ortamlarda çalışıyorsanız Newman'ı seçin. Newman'ın bağımsızlığı ve olgunluğu, çoğu işlem hattı için güvenli bir varsayılan yapar.
Ekibiniz Postman platformu içinde çalışıyorsa, çalıştırma geçmişini ve kontrol panellerini orada merkezileştirmek istiyorsanız veya işlem hattında API yönetişimi ve tanım linting sizin için değerliyse Postman CLI'ı seçin. Sıkı bulut entegrasyonu, Postman merkezli ekipler için gerçek bir avantajdır.
Bu kararı tartıyorsanız, Postman ekosistemine hiç bağlı olmak isteyip istemediğinizi sormaya değer. Diğer yaklaşımlar için, Newman olmadan CI'da Postman koleksiyonlarını çalıştırma rehberimize ve Postman olmadan API testi konulu daha geniş bakışımıza göz atın.
Tek araç alternatifi: Apidog
Hem Postman CLI hem de Newman, testlerinizi Postman'da yazdığınızı varsayar. Apidog bu ayrımı ortadan kaldırır. API'ları tasarlar, isteklerde hata ayıklaması yapar ve görsel onaylarla otomatik test senaryoları oluşturursunuz, ardından bu senaryoları CI/CD'de yerleşik komut satırı çalıştırıcısıyla çalıştırırsınız. Herhangi bir dışa aktarma adımı veya ayrı bir çalıştırıcı paketi yoktur, çünkü test tanımları ve yürütme motoru aynı üründür.
Apidog ayrıca API tasarımı, sahte sunucular ve performans testlerini de kapsar, böylece bir ekip araçları birleştirmeden tüm API yaşam döngüsünü kapsayabilir. Apidog'u indirebilir ve işlem hatları için CLI çalıştırıcısı dahil test özelliklerini ücretsiz kullanabilirsiniz.
Sıkça Sorulan Sorular
Postman CLI, Newman'ın yerini mi alıyor?
Postman, Postman CLI'ı resmi olarak önerilen komut satırı aracı olarak konumlandırsa da, Newman hala bakımı yapılan ve yaygın olarak kullanılan bir araçtır. Hesap gerektirmeyen, depo sürümündeki bir çalıştırıcı istediğinizde Newman daha iyi bir seçim olmaya devam etmektedir. Her ikisi de bir süre daha birlikte var olacağından, acil bir geçiş ihtiyacı yoktur.
Postman CLI Postman hesabı gerektiriyor mu?
Evet. Postman CLI, bir Postman API anahtarı ile kimlik doğrulaması yapar ve çalıştırmaları Postman çalışma alanınıza geri bağlamak için tasarlanmıştır. Newman ise aksine hesap gerektirmez ve tamamen yerel bir koleksiyon dosyasından çalışır.
Hangi araç daha iyi raporlar sunar?
Newman, topluluk raporlayıcıları aracılığıyla daha esnek raporlama olanağına sahiptir, özellikle ayrıntılı HTML çıktısı için newman-reporter-htmlextra ve CI panoları için JUnit XML. Postman CLI, sonuçları doğrudan Postman platformuna raporlar; bu, ekibiniz orada çalışıyorsa kullanışlıdır ancak bağımsız rapor dosyaları için daha az esneklik sunar.
Postman CLI yerel bir koleksiyon dosyasını çalıştırabilir mi?
Postman CLI, yerel dosyalardan koleksiyonları çalıştırabilir, ancak koleksiyonları Postman bulutundan kimlik bazında çekmek ve sonuçları geri raporlamak üzerine kurulmuştur. Yerel bir JSON dosyasını, bulut katılımı olmaksızın doğruluk kaynağı olarak kabul eden bir araç istiyorsanız, Newman bu modele daha doğal bir şekilde uyar.
CI'da hangisi daha hızlıdır?
Saf koleksiyon yürütmesi için fark küçüktür ve koleksiyon boyutuna ve ağ koşullarına bağlıdır. Newman daha küçük bir ayak izine sahiptir ve bulut gidiş-dönüşleri yoktur. Postman CLI, kimlik doğrulama ve sonuçları platforma senkronize etme ek yükü getirir. Çoğu işlem hattı için, ham hız yerine iş akışına uygunluğa göre seçim yapın.