Meni

Kako uporabiti integracijo ukazne vrstice z Newmanom v poštarju?

  • Glavni
  • Drugo
  • Kako uporabiti integracijo ukazne vrstice z Newmanom v poštarju?

how use command line integration with newman postman

Preizkusite Naš Instrument Za Odpravo Težav

Naučite se izvajati zbirke poštarjev z uporabo Newmana:

V tej vadnici bomo videli, kako lahko integriramo ali izvajamo zbirke Postman prek ukazne vrstice z uporabo Newmana, ki je orodje za integracijo ukazne vrstice za Postman.

Newman je brezplačno in odprtokodno orodje. Ponuja zmogljive zmogljivosti za zagon zbirk poštarjev, ki izkorišča nadvse uporabne zmožnosti poštarja, kot so testi, trditve, skripti za predhodno zahtevo itd., In zagon zbirke prek ukazne vrstice.

=> Tukaj si oglejte A-Z vadnic za usposabljanje poštarjev.

Postman_ Integracija ukazne vrstice z Newmanom

Kaj se boste naučili:

Kaj je Newman?

Newman je izvajalec ukazne vrstice za zbirke Postman. Z drugimi besedami, uporabniku omogoča, da prek ukazne vrstice zažene obstoječo zbirko Postman.

Pričakuje ali porabi različico zbirke JSON, ki jo je mogoče dobiti s preprostim izvozom zbirke v obliki zbirke JSON ali URL zbirke, ki ni nič drugega kot isti JSON, ki ga dobimo z izvozom zbirke.

Tu je video vadnica:

Namestitev Newmana

Newman je modul NodeJS in je torej odvisen od sistema, ki ima nameščeno vozlišče. Če želite preveriti, ali je vozlišče nameščeno ali ne, preprosto preverite njegovo različico v sistemu z uporabo spodnjega ukaza.

$ node -v v10.15.3

Če ukaz vrne nekaj izhodnih podatkov, kot je opisano zgoraj, potem to pomeni, da je vozlišče nameščeno in smo pripravljeni namestiti Newman. V nasprotnem primeru lahko vozlišče namestite tako, da upoštevate navodila za namestitev tukaj

Ko je namestitev vozlišča uspešna, lahko preprosto namestite Newman kot kateri koli drug paket vozlišča z uporabo spodnjega ukaza.

npm install -g newman

Tu '-g' pomeni globalno namestitev, kar pomeni, da bo paket Newman dostopen iz katere koli mape / mesta v datotečnem sistemu. Za lokalno namestitev lahko odstranite zastavico ‘-g’ zgoraj, kjer bo paket Newman dostopen samo z nameščene lokacije ali mape.

Če želite potrditi uspešno namestitev Newmana, lahko preprosto preverite njegovo različico z uporabo spodnjega ukaza.

newman -v 4.5.1

Zagon zbirk z uporabo Newmana

Če želite zagnati zbirke z uporabo Newmana, morate imeti katero koli izmed dveh.

  1. Zbirka v formatu JSON.
  2. URL gostujoče zbirke.

Ukaz, ki se uporablja za zagon zbirke poštarjev s pomočjo Newmana, je:

test enote vs primer integracijskega testa
newman run {{collectionJsonPath}} OR newman run {{collectionUrl}}

Poskusimo z uporabo zbirke vzorcev uporabiti Postman.

  1. Odprite aplikacijo Poštar, uporabite katero koli obstoječo zbirko Poštarjev in jo izvozite v obrazec JSON. (Ustvarili bomo novo zbirko s tremi zahtevami, tj. Registriraj uporabnika, uporabnika za prijavo in pridobitev uporabnika z obrazcem za končne točke API tukaj ).
  2. Zdaj zbirko izvozite v format JSON.
  3. Ko je zbirka JSON pridobljena, odprite ukazni poziv in zaženite zbirko z ukazom Newman run (domnevamo, da je bila zbirka izvožena z imenom - Postman_Newman_IntegrationCollection .json) in uporabnik je brskal do imenika za izvoz zbirke, potem je zbirko mogoče izvesti preprosto z uporabo spodnjega ukaza.
newman run Postman_Newman_IntegrationCollection.json

Po zagonu zgornjega ukaza se ustvari naslednji izhod.

Zbirka Runner

Newmanova integracija s spremenljivkami okolja

Zdaj pa poglejmo bolj napredne navade Newmana. Za zbirko, ki se ne zanaša na nobene spremenljivke okolja, bi lahko zbirko preprosto izvedli z ukazom Newman run. Toda za zbirke, ki uporabljajo spremenljivke okolja, moramo skupaj z zbirko JSON zagotoviti tudi spremenljivko okolja JSON.

Primer: Uporabili bomo isto zbirko in uporabili spremenljivko okolja za končno točko GET User, tj. Za zahtevo z končna točka .

Uporabili bomo userId iz zbirke spremenljivk okolja. Tako bo posledična zahteva postala https://reqres.in/api/users/{{userId}}

Zdaj, ko je datoteka okolja ustvarjena, jo izvozite kot JSON z uporabo spodnjih korakov.

  1. Ustvarite okolje z eno spremenljivko z imenom userId in vrednost naj bo nastavljena na '4'.
  2. Zdaj kliknite gumb Nastavitve, da odprete okno 'Upravljanje okolij'.
  3. Kliknite ikono »Prenesi« ob ustvarjenem okolju, da prenesete okolje kot datoteko JSON (datoteko z imenom shranite kot »testEnv.json).

Znova izvozimo zbirko s spremenjeno zahtevo in poskusimo zagnati isto zbirko skupaj z datoteko okolja z ukazom spodaj:

newman run Postman_Newman_IntegrationCollection.json -e testEnv.json

Ko je zgornji ukaz izveden, izhod ostane enak kot pri neposrednem zagonu zbiranja, pri čemer je edina sprememba zahteva »GET User« zdaj prikliče vrednost iz datoteke JSON okolja.

Rezultati trditev z uporabo Newmana

Ker lahko tudi zahteve za poštarja vsebujejo trditve, bomo zdaj predstavili, kako se prikažejo rezultati trditve, ko se zbirke poštarjev izvajajo prek Newmana.

Tekač zbirke Newman je v popolni pariteti z vodjem zbirke Postman in izvršiteljem zahtev. Za zahteve s trditvami se trditve ovrednotijo, ko in ko se izvršitev zahteve zaključi, in povzetek izvedbe trditve je prikazan v povzetku testa na koncu preizkusa.

Za zgornjo zbirko smo dodali trditev na ravni zbirke, da preverimo, ali je koda stanja odziva 200, tj. Za vsako zahtevo, ki je del zbirke, mora biti ta trditev povezana.

Torej, če je imela ta zbirka 3 zahteve, to pomeni, da bi morale biti izvedene skupno 3 trditve.

Oglejte si spodnji posnetek zaslona za poudarjene rezultate izvedbe in rezultate uveljavljanja.

Označeni rezultati izvedbe

Generacija poročila z uporabo Newmana

Zaenkrat vemo, da lahko Newman prek ukazne vrstice zažene zbirke Postman in ustvari nekaj dnevnikov preizkusov in povzetek izvajanja preizkusov. Kaj pa oblikovana poročila, ki bi jih lahko delili ali objavili na nekem strežniku?

No, tudi Newman ima podporo za to. Za ustvarjanje poročil o izvajanju preizkusov Newman je na voljo nekaj modulov vozlišč po meri. Sprehodili se bomo po primeru z uporabo newman-html-reporter .

Ta poročevalec je spet vozliščni modul in ga je treba namestiti ločeno z uporabo spodnjega ukaza.

npm install -g newman-reporter-html

Ko je zgornji modul nameščen, ga lahko uporabite skupaj z ukazom Newman run.

newman run Postman_Newman_IntegrationCollection.json -e testEnv.json -r html

Oznaka '-r' označuje poročevalca, ki se bo uporabljal pri zagonu zbirke Newman.

S to možnostjo uporablja modul ali pakete Newman-reporter-html in ustvari poročilo, ki temelji na HTML-ju, za izvajanje preizkusa.

Oglejte si en tak posnetek zaslona spodaj prikazanega poročila HTML:

Poročilo HTML

Integracija z orodji CI

Ker ima Newman zmožnosti za zagon kot ukazno vrstico, zmanjša veliko odvisnosti od kakršnih koli predpogojev v obliki konzole ali aplikacije, tj. Edina odvisnost, ki jo ima Newman, je vozlišče (ki je običajno na voljo kot izvedba okolja v vseh strojih CI, kot so Jenkinsovi sužnji ali Travisova vozlišča).

To omogoča, da se zbirke Postman izvajajo kot del samih gradbenih cevovodov prek ukazne vrstice Newman.

Ker ima Newman zmožnosti potiskanja rezultatov tudi v obliki HTML, je to zelo koristno in priročno, med samim izvajanjem cevovoda pa lahko rezultate HTML potisnete na strežnik ali jih pošljete po e-pošti želenim uporabnikom itd. zmogljivosti je neskončno, saj so odvisnosti minimalne.

Za podroben primer izvedbe integracije z Jenkinsom si oglejte ta primer iz uradnega spletnega dnevnika Postman tukaj .

Več možnosti z Newmanom

Karkoli smo že pokrili, je podskupina funkcionalnosti, ki jo ponuja Newman. Za popolne podrobnosti o ukazih in stikalih, ki jih podpira Newman, preprosto odprite pomoč za ukazno vrstico za Newman z uporabo spodnjega ukaza.

newman run -h

Tukaj je rezultat zgornjega ukaza s podrobnostmi o vseh stikalih in njihovih pomenih.

Izhod s stikali in njihov pomen

Za referenco Newman API obstajajo tudi drugi informacijski viri. Prosimo, glejte tukaj za uradno dokumentacijo.

Zaključek

V tej vadnici smo se sprehodili po integraciji ukazne vrstice Postman, imenovane Newman, ki omogoča zagon zbirk Postman prek vmesnika ukazne vrstice.

Preprosto gre za paket vozlišč in vsaka ukazna vrstica, ki ima vozlišče nameščeno skupaj z Newmanom, bi morala imeti možnost zagnati zbirko Postman in ustvariti lepa poročila o izvedbi zbirke.

Integracija ukazne vrstice je tudi v veliko pomoč pri integraciji testov zbiranja, ki temeljijo na Postmanu, z orodji CI, kot so Jenkins, Travis itd., Saj izvajanje skozi ukazno vrstico ni odvisno od operacijskega sistema ali aplikacije in preprosto potrebuje okolje vozlišča za zbiranje.

=> Obiščite tukaj za ekskluzivno vadnico za usposabljanje poštarjev.

Priporočeno branje

^