Herkese merhaba .Bu yazımda Postman API otomasyonunda Newman entegrasyonu ve Html Reporter hakkında bilgiler vereceğim. Newman, Postman collection’larımızı Collection Runner üzerinden değil doğrudan komut satırı üzerinden koşmamızı ve test etmemizi sağlayan bir Npm (Node Package Manager) teknolojisidir.
Aşağıdaki adımları takip ederek Windows işletim sistemi için Newman entegrasyonunu tamamlayabilirsiniz.
- Postman Collection’ları Newman ile komut satırından çalıştırabilmemiz için öncelikle bilgisayarımıza node.js indirmemiz ve kurmamız gerekmektedir. https://nodejs.org/en/ sitesi üzerinden node.js indirip kurabilirsiniz.
- Node.js yükledikten sonra komut satırını (cmd) açınız. Newman’ı aşağıda yer alan komut ile kurunuz.
$ npm install –g newman
3. Artık komut satırı üzerinden testlerinizi koşmaya hazırsınız. Koşacağımız collection’ı export ederek komut satırından o dosyanın bulunduğu dizine gitmeliyiz. Ardından aşağıdaki konumu çalıştırarak collection’ı test edebiliriz.
newman run D:\work\test\TESTcollection.json
Ek olarak Newman’de hangi özellikleri kullanabileceğimizi görmek için newman run –h komutunu çalıştırabiliriz. Aşağıdaki ekran görüntüsünde kullanılabilecek özellikler ve açıklamaları bulunmaktadır.
Örneğin sık kullanabileceklerinizden ;
- n : collection’ı kaç kere koşacağımızı belirlediğimiz özelliktir.
- g : Collection’da kullanılan ve global dosyasında tanımlanan değişkenleri kullanmamıza olanak sağlar.
- e : Collection Runner’da olduğu gibi collection’da kullanılan ve environment dosyasında tanımlanan değişkenleri kullanmamıza olanak sağlar.
Collection’ı cmd ekranından run edip sonuçları cmd ekranında bu aşamaları uygulayarak rahatlıkla görüntüleyebilirsiniz.
Newman ile komut satırından koştuğumuz testleri HTML formatında rapor haline de getirebilmemiz mümkün.
Komut satırından aşağıdaki komutu çalıştırarak HTML reporter kurulumlarını tamamlayabilirsiniz.
npm install –g newman-reporter-html
npm install –g newman-reporter-htmlextra
Rapor tamamlandıktan sonra bilgisayarınızda yer alan newman klasörü içerisinde html raporunuzu görüntüleyebilirsiniz.
Bir request için Enviroments tanımlaması yapılabildiği gibi bir Collection da olan diğer request ‘ler içinde Enviroments tanımlaması yapılabilir. Bunun için Collection run edileceği zaman Enviroments no – enviroments yerine tanımlanan Enviroments ‘lardan seçilmelidir
Enviroments yapısı temel olarak requestlerde parametre olarak kullanılabilecek değişken adı = değişken şeklinde tanımlanan içeriklerdir .Requestler de genel olarak kullanılan değişkenler Enviroments de tanımlanarak güncelleme işlemlerinin tek bir yerden yapılmasına olanak sağlar. Testlerimizi Newman ile komut satırından koşarken Enviroments ‘leri kullanabilmek için koşacağımız collection’ı export ettiğimiz gibi enviroments ‘ de export etmeliyiz.
CMD ekranından çalıştırabilmek için yukarıda da belirttiğim gibi ;
e : Collection Runner’da olduğu gibi collection’da kullanılan ve environment dosyasında tanımlanan değişkenleri kullanmamıza olanak sağlar
newman run collection export dosya yolu – e collection export dosya yolu – r htmlextra
newman run “D:\work\test\TESTcollection.json” -e “D:\work\test\TESTcollection.json\environment.json” -r htmlextra
Umuyorum yararlı bir yazı olmuştur.
Bir sonraki yazımda görüşmek üzere..
Emine Aktürk
YAZILIM TEST MÜHENDİSLİĞİ 