how use command line integration with newman postman
Научете се да изпълнявате колекции на пощальони с помощта на Newman:
В този урок ще видим как можем да интегрираме или изпълним колекции на Postman чрез командния ред, използвайки Newman, който е инструмент за интегриране на команден ред за Postman.
Newman е безплатен инструмент с отворен код. Той предоставя мощни възможности за стартиране на колекциите на Postman, използвайки супер полезни възможности на Postman като тестове, твърдения, скриптове за предварителна заявка и т.н. и стартиране на колекцията чрез командния ред.
=> Проверете тук, за да видите A-Z на уроци за обучение на пощальона тук.
Какво ще научите:
Какво е Нюман?
Newman е бегач от командния ред за колекции на Postman. С други думи, позволява на потребителя да стартира съществуваща колекция на Postman чрез командния ред.
Той очаква или консумира JSON версията на колекцията, която може да бъде получена чрез просто експортиране на колекцията във формат на колекция JSON или URL адреса на колекцията, който не е нищо друго освен същия JSON, който е получен при експортирането на колекцията.
Ето видео урок:
Инсталиране на Newman
Newman е модул NodeJS и по този начин зависи от системата с инсталиран възел. За да проверите дали възелът е инсталиран или не, просто проверете версията на възела в системата, като използвате командата по-долу.
$ node -v v10.15.3
Ако командата връща малко изход, както по-горе, това означава, че възелът е инсталиран и е добре да продължим с инсталацията на Newman. Ако не, можете да инсталирате възел, като се обърнете към инструкциите за инсталиране тук
След като инсталацията на възела е успешна, можете просто да инсталирате Newman като всеки друг възел, като използвате командата по-долу.
npm install -g newman
Тук ‘-g’ означава глобална инсталация, което означава, че пакетът Newman ще бъде достъпен от всяка папка / местоположение във файловата система. За извършване на локална инсталация можете да премахнете флага ‘-g’ от горното, където пакетът Newman ще бъде достъпен само от инсталираното местоположение или папка.
За да проверите успешната инсталация на Newman, можете просто да проверите версията му, като използвате командата по-долу.
newman -v 4.5.1
Изпълнение на колекции с помощта на Newman
За да стартирате колекции с помощта на Newman, трябва да имате някоя от двете.
- Колекцията във формат JSON.
- URL на хостваната колекция.
Командата, използвана за стартиране на колекцията Postman с помощта на Newman, е:
Въпроси и отговори за тестове за автоматизация на селен
newman run {{collectionJsonPath}} OR newman run {{collectionUrl}}
Нека опитаме да пуснем колекция от проби с помощта на Postman.
- Отидете в приложението Postman, използвайте всяка съществуваща колекция Postman и го експортирайте в JSON формуляра. (Ще създадем нова колекция с 3 заявки, т.е. регистриране на потребител, потребител за влизане и получаване на потребител чрез формуляра за крайни точки на API тук ).
- Сега експортирайте колекцията във формат JSON.
- След като се получи JSON на колекцията, отворете командния ред и стартирайте колекцията, като използвате командата Newman run (да предположим, че колекцията е експортирана с име - Postman_Newman_IntegrationCollection .json) и потребителят е прегледал директорията за експортиране на колекции, тогава колекцията може да бъде изпълнена просто с помощта на командата по-долу.
newman run Postman_Newman_IntegrationCollection.json
След като се изпълни горната команда, се извежда следният изход.
Интеграция на Нюман с променливи на околната среда
Сега нека видим по-напредналите обичаи на Нюман. За колекция, която не разчита на променливи на околната среда, колекцията може просто да бъде изпълнена с помощта на командата Newman run. Но за колекции, използващи променливите на средата, трябва да предоставим и променливата на средата JSON, заедно с колекцията JSON.
Пример: Ще използваме същата колекция и ще използваме променлива на средата за крайната точка на GET User, т.е.за заявка с крайна точка .
Ще използваме userId от колекцията променлива на околната среда. Така получената заявка ще стане https://reqres.in/api/users/{{userId}}
След като веднъж е създаден файлът на средата, го експортирайте като JSON, като използвате стъпките по-долу.
- Създайте среда с една променлива с име userId и стойността трябва да бъде зададена на „4“.
- Сега кликнете върху бутона Настройки, за да отворите прозореца „Управление на средите“.
- Щракнете върху иконата ‘Изтегляне’ върху създадената среда, за да изтеглите средата като JSON файл (запишете файла с име като ‘testEnv.json).
Нека експортираме колекцията отново с променената заявка и опитайте да стартирате същата колекция заедно с файла на околната среда с командата по-долу:
newman run Postman_Newman_IntegrationCollection.json -e testEnv.json
След като се изпълни горната команда, изходът остава същият като директното изпълнение на събирането, като единствената промяна е заявката ‘GET User’ сега извлича стойността от JSON файла на средата.
Резултати от твърдение с помощта на Нюман
Тъй като исканията на пощальона могат да съдържат и твърдения, сега ще разгледаме как се показват резултатите от утвърждаването, когато колекциите на пощальона се изпълняват чрез Newman.
Бегачът на колекция Newman е в пълен паритет с колектора на Postman Collection и изпълнител на заявки. За заявки, които имат твърдения, твърденията се оценяват като и когато изпълнението на заявката завърши и обобщението на изпълнението на заявлението се показва в резюмето на теста в края на тестовото изпълнение.
За горната колекция добавихме твърдение на ниво колекция, за да проверим кода на състоянието на отговора да бъде 200, т.е.за всяка заявка, която е част от колекцията, трябва да има това твърдение.
Така че, ако тази колекция е имала 3 заявки, това означава, че трябва да има общо 3 твърдения, които е трябвало да бъдат изпълнени.
Моля, обърнете се към скрийншота по-долу за подчертани резултати от изпълнението и резултати от твърдения.
Генериране на отчети с помощта на Newman
Досега знаем, че Newman може да стартира колекции на Postman чрез командния ред и да генерира някои тестови дневници и резюме на изпълнението на теста. Но какво ще кажете за форматираните отчети, които могат да се споделят или публикуват на някакъв сървър?
Е, Нюман има подкрепа и за това. Налични са някои персонализирани модулни възли за генериране на отчети за изпълнение на теста на Newman. Ще разгледаме пример, използвайки a newman-html-reporter .
Този репортер отново е възелен модул и трябва да бъде инсталиран отделно с помощта на командата по-долу.
npm install -g newman-reporter-html
След като горният модул бъде инсталиран, това може да се използва заедно с командата за изпълнение на Newman.
newman run Postman_Newman_IntegrationCollection.json -e testEnv.json -r html
Флагът ‘-r’ указва репортера, който ще се използва с изпълнението на колекцията Newman.
С тази опция той използва модула или пакетите Newman-reporter-html и създава HTML базиран отчет за изпълнението на теста.
Обърнете се към една такава екранна снимка на HTML отчета, показан по-долу:
Интеграция с CI Tools
Тъй като Newman има възможностите да се изпълнява като команден ред, той намалява много зависимост от всякакви предпоставки под формата на конзола или приложение, т.е. единствената зависимост, която Newman има, е възел (който обикновено се предлага като изпълнение среда във всички машини на CI като роби на Дженкинс или възли на Травис).
Това позволява колекциите на Postman да се изпълняват като част от самия конвейер за изграждане чрез командния ред на Newman.
Тъй като Newman има възможности за изпращане на резултати и във формат Html, това е наистина полезно и удобно и по време на самото изпълнение на конвейера, резултатите от HTML могат да бъдат изпратени на сървър или могат да бъдат изпратени чрез имейл до желаните потребители и т.н. възможностите са безкрайни, тъй като зависимостите са минимални.
За подробен пример за изпълнение на интеграция с Jenkins, моля, вижте този пример от официалния блог на Postman тук .
Още опции с Нюман
Каквото и да сме обхванали, е подмножество от функционалността, предоставена от Newman. За пълни подробности за командите и превключвателите, които Newman поддържа, просто отворете помощ за командния ред за Newman, като използвате командата по-долу.
newman run -h
Ето изхода на горната команда, с подробности за всички ключове и техните значения.
Съществуват и други информационни ресурси за справка за API на Newman. Моля вижте тук за официалната документация.
Заключение
В този урок разгледахме интеграцията на командния ред на Postman, наречена Newman, която позволява стартиране на колекции на Postman чрез интерфейс на командния ред.
Това е просто пакет от възли и всеки команден ред, който има възел, инсталиран заедно с Newman, трябва да може да стартира колекцията Postman и да генерира добре изглеждащи отчети за изпълнението на колекцията.
Интеграцията на командния ред също е от голяма помощ за интегрирането на тестове за събиране, базирани на Postman, с инструменти на CI като Jenkins, Travis и др. колекция.
=> Посетете тук за ексклузивната поредица за обучение на пощальон.
Препоръчително четене
- Изрежете командата в Unix с примери
- Синтаксис на командата Unix Cat, Опции с примери
- Ls Command в Unix с примери
- Как и кога да използвам скриптове за предварителна заявка за пощальон и публикуване на заявки за заявки?
- Команда Grep в Unix с прости примери
- Аргументи на командния ред в C ++
- Команда за сортиране на Unix със синтаксис, опции и примери
- Аргументи на командния ред в скрипта на Unix Shell с пример