Tere kõigile, siin on TestMace! Võimalik, et paljud teavad meid läbi meie eelnevaid artiklites. Neile, kes just liitusid: arendame IDE-d API-dele TestMace töötamiseks. Kõige sagedamini esitatav küsimus TestMace'i võrdlemisel konkurentide toodetega on: „Kuidas te Postmanist erinevate?“ Otsustasime, et on aeg anda sellele küsimusele põhjalik vastus. Allpool oleme punktide kaupa välja toonud meie eelised Postman.

Ahnude jaotamine

Kui kasutate Postmanit, siis teate, et päringu liides sisaldab kogu vajalikku funktsionaalsust. Siin on skriptid, testid ja ise päringud. See lihtsustab algajate tööd, kuid suurte stsenaariumide puhul ei ole lähenemine paindlik. Mis siis, kui soovite luua mitu päringut ja teha nende põhjal kogumisi? Mis siis, kui soovite skripti käivitada ilma päringuta või mitu loogiliselt eraldatud skripti järjest? Lõppude lõpuks oleks hea, kui testid ja tavalised utiliitskripti oleks eraldatud. Lisaks on lähenemine, et „lisame kogu funktsionaalsuse ühte punkti“, mitte skaleeritav — liides muutub kiiresti ülekoormatuks.

TestMace jaotab kogu funktsionaalsuse algselt erinevate tüüpide sõlmedeks. Sa tahad teha päringu? Siin on taotlusaste sõlm. Kas soovid skripti kirjutada? Siin see on script sõlm. Kas vajate teste? Palun — Kinnitus sõlm. Ahjaa, sa saad nende kõike keerata ka kaust sõlm. Ja kõik see sobitub omavahel lihtsalt. Selline lähenemine on mitte ainult väga paindlik, vaid ka vastutuse ühtsuse põhimõtte kohaselt võimaldab kasutada ainult seda, mis sul hetkel tõeliselt vajalik on. Miks mul on vaja skripte ja teste, kui tahan lihtsalt teha taotlust?

Inimesele arusaadav projekti formaat

TestMace ja Postmani vahel on kontseptuaalne erinevus hoidmisviisis. Postmanis hoitakse kõik taotlused kuskil kohalikus salvestuses. Kui on vaja jagada taotlusi mitme kasutaja vahel, tuleb kasutada sisseehitatud sünkroonimist. Tegelikult on see levinud lähenemine, millel on oma puudused. Kuidas on andmete turvalisusega? Lõppude lõpuks võib mõnede ettevõtete poliitika keelata andmete hoidmise kolmandate isikute juures. Küll aga usume, et TestMace võib pakkuda midagi paremat! Ja selle täiustuse nimi on „inimesele arusaadav projekti formaat“.

Alustuseks on TestMace'is olemas mõisted "projekt". Rakendus on algselt välja töötatud projektide säilitamiseks versioonihaldussüsteemides: projekti struktuur peaaegu täpselt kattub failistruktuuriga, salvestusvorminguks on kasutatud yaml (ilma liigsete sulgudeta ja koma), ja iga sõlme failiesitust on detailidokumentatsioonis kirjeldatud koos kommentaaridega. Enamasti ei pea te sinna sisse vaatama — kõik väljade nimed on loogilised.

Mida see kasutajale annab? See võimaldab väga paindlikult muuta meeskonna töövooge, kasutades tuttavaid lähenemisi. Näiteks võivad arendajad salvestada projekti samas repository's, mis on backend. Harudes, peale koodi baasistruktuuri muutmise, saab arendaja parandada olemasolevaid päringu stsenaariume ja teste. Pärast muudatuste fikseerimist repository's (git, svn, mercurial — mis teile rohkem meeldib) käivitab CI ( teie lemmik, kellegi peale ei surutud) meie konsooli utiliiti. testmace-cli, ja pärast aruande koostamist (nt junit formaadis, mida testmace-cli ka toetab) saadetakse see vastavasse süsteemi. Ja ülaltoodud turvaküsimus ei ole enam probleem.

Nagu näha, ei suru TestMace oma ökosüsteemi ja paradigma peale. Selle asemel integreerub see hõlpsasti juba kehtestatud protsessidesse.

Dünaamilised muutujad

TestMace järgib no-code kontseptsiooni: kui probleemi saab lahendada ilma koodita, püüame seda võimalust pakkuda. Töö muutujatega on just see funktsioon, kus enamikul juhtudel saab hakkama ilma programmeerimiseta.

Näide: saime serverilt vastuse ja tahame salvestada osa vastusest muutuja. Postmanis kirjutaksime testskriptis (mis iseenesest on kummaline) midagi sellist:

var jsonData = JSON.parse(responseBody);
postman.setEnvironmentVariable("data", jsonData.data);

Kuid meie arvates tundub skripti kirjutamine nii lihtsa ja sageli kasutatava stsenaariumi jaoks liigsete tegemistena. Seetõttu on TestMace'is võimalik asignida muutuja tükk vastusest, kasutades graafilist kasutajaliidest. Vaadake, kui lihtne see on:

Ja nüüd iga päringu korral värskendatakse seda dünaamilist muutujat. Ent võib küsida, et Postmani lähenemine on paindlikum ning võimaldab mitte ainult määramist, vaid ka eelprotsessimist. Siin on, kuidas saab eelnevat näidet muuta:

var jsonData = JSON.parse(responseBody);
postman.setEnvironmentVariable("data", CryptoJS.MD5(jsonData.data));

Noh, selle jaoks on TestMace'is script plokk, mis katab seda stsenaariumi. Eelmise juhtumi kordamiseks, kuid juba TestMace'i kaudu, tuleb pärast päringut luua script plokk ja kasutada skriptina järgmist koodi:

const data = tm.currentNode.prev.response.body.data;
tm.currentNode.parent.setDynamicVar('data', crypto.MD5(data));

Nagu näete, on plokkide kooste ka siin head teenust osutatud. Ja nii lihtsa juhtumi puhul, nagu ülaltoodud, võite isegi lihtsalt määrata väljendi ${crypto.MD5($response.data)} graafilise kasutajaliidese kaudu loodud muutujale!

Testide loomine läbi GUI

Postman võimaldab testide loomiseks skripte kirjutada (Postmanis on see JavaScript). Selle lähenemise plussid on abiga praktiliselt piiramatu paindlikkus, olemasolevad lahendused jne.

Kuid reaalsus on sageli selline (me pole sellised, elu on selline), et testijatel pole programmeerimise oskusi, ja meeskonnale tahaks juba praegu kasu tuua. Selliste juhtumite jaoks, järgides no-code kontseptsiooni, võimaldab TestMace luua lihtsaid teste graafilise liidese kaudu, ilma skriptide kirjutamiseta. Näiteks näeb testimise loomise protsess välja selline, mis võrrelda väärtusi võrdsuseks:

Kuid testide loomine graafilises redaktoris ei välista võimalust testide kirjutamiseks koodis. Siin on kõik samad raamatukogud, mis on script sõlmes, ja chai testide kirjutamiseks.

Võimalus käivitada juba olemasolev stsenaarium lingi kaudu (Link sõlm)

Tihti esinevad olukorrad, kus mõni päring või isegi terve stsenaarium tuleb täita mitu korda projekti erinevates osades. Näiteks võivad sellised päringud olla kohandatud mitmeastmelised autentimised, keskkonna viimine soovitud seisundisse jne. Üldiselt, kui rääkida programmeerimiskeeltest, siis on soov, et oleks funktsioonid, mida saab rakendada erinevates rakenduse osades. TestMace'is täidab seda funktsiooni link moodul. Selle kasutamine on väga lihtne:
1) looge päring või stsenaarium
2) looge Link tüüpi moodul
3) määrake parameetrites link esimesel sammul loodud stsenaariumile

Eeltäiendatud variandi puhul võite määrata, milliseid dünaamilisi muutujaid stsenaariumist edastada kõrgemale tasemele seoses lingiga. Kõlab segaselt? Oletame, et oleme loonud kausta nimega create-post, mille sees määratakse sellele moodulile dünaamiline muutuja postId. Nüüd Link moodulis create-post-link võite selgelt määrata, et muutuja postId määratakse eelkäijale create-post-link. Antud mehhanismi (uuesti, kasutades programmeerimiskeelt) saab kasutada funktsiooni tulemuse tagastamiseks. Üldiselt on see suurepärane, DRY täies hiilguses ja ükski koodirida pole kannatama pidanud.

Mis puutub Postmani, siis funktsioonisoov päringute taaskasutamiseks on ootel alates 2015. aastast, ja tundub, et on isegi mõned vihjed, et selle probleemiga töötatakse. Praegusel kujul võimaldab Postman loomulikult muuta täitmisvoogu, mis teoorias võimaldab sellist käitumist rakendada, kuid see on pigem must nipp kui tõeliselt toimiv lähenemine.

Muud erinevused

• Rohkem kontrolli muutujate ulatuse üle. Postmanis on väikseim ulatus, kus saab muutuja määrata, kogumine. TestMace võimaldab määratleda muutujaid igasuguste päringute või kaustade jaoks. Postmanis võimaldab jagamise funktsioon eksportida ainult kogumisi, samas kui TestMace'i jagamine töötab igasuguste sõlmede jaoks.
• TestMace toetab pärandpealkirju, mis võivad vaikimisi aluseks olla alampäringutes. Postmanil on selle kohta ülesanne, ja see on isegi suletud, kuid lahendusena pakutakse… kasutada skripte. TestMace'is kõik konfigureeritav GUI kaudu ja on võimalus konkreetsetes järglastes päritud päiseid valikuliselt välja lülitada.
• Võta tagasi / Korda. See töötab mitte ainult sõlmede redigeerimisel, vaid ka liikumise, kustutamise, ümbernimetamise ja muude toimingute korral, mis muudavad projekti struktuuri.
• Failid, mis on seotud päringutega, muutuvad projekti osaks ja salvestatakse koos sellega, ning sünkroniseeruvad suurepäraselt, erinevalt Postman'ist. (Jah, ei ole enam vaja igal korral manuaalselt faile valida ja kolleegidele arhiivides edastada.)

Funktsioonid, mis on juba teel.

Me ei suutnud ahvatlusele vastu panna ja avasime natuke saladuseloori järgmiste versioonide üle, eriti kui funktsionaalsus on väga maitsev ja juba läbi pre-releas'i lihvimise. Niisiis, tervitame.

Funktsioonid

Nagu teada, kasutatakse Postman'is väärtuste genereerimiseks nn dünaamilisi muutujaid. Nende loetelu on muljetavaldav. ja absoluutne enamus funktsioone teenivad vale väärtuste genereerimist. Näiteks, et genereerida juhuslikku e-posti, tuleb kirjutada:

{{$randomEmail}}

Kuid kuna need on muutujad (kuigi dünaamilised), ei saa neid funktsioonidena kasutada: need ei ole parameetriseeritavad, seetõttu ei saa stringilt räsida.

TestMace'is kavatseme lisada „ausad” funktsioonid. Otse ${} sees saab mitte ainult viidata muutujale, vaid ka funktsiooni kutsuda. St. kui peame genereerima kuulsat vale e-posti aadressi, kirjutame lihtsalt

${faker.internet.email()}

Peale selle, et see on funktsioon, võib märgata, et objekti meetodi kutsumise võimalus on olemas. Ja suures tasapinnalises nimekirjas dünaamilistest muutujatest on meil loogiliselt rühmitatud objektide kogum.

Aga mis siis, kui me soovime stringilt räsida? Lihtne!

${crypto.MD5($dynamicVar.data)}

Võib märgata, et parameetritena saab isegi muutujaid edastada! Sel hetkel võib peene märkaja kahtlustada kahtlust…

JavaScripti kasutamine väljendites

… Ja mitte asjata! kui nõuded funktsioonidele koostati, tulime äkki järeldusele, et väljendites tuleb lubada kirjutada kehtivat javascripti. Seetõttu võite nüüd väljendeid kirjutada vaimus:

${1 + '' + crypto.MD5('asdf')}

Ja kogu see ilma skriptideta otse sisestusväljadest!

Postmani osas saab kasutada ainult muutujaid, ning kui proovite kirjutada mingit vähest väljendit, siis valideerija nuriseb ja keeldub seda arvutama.

Täiustatud automaatne täiendamine

Praegu on TestMace'il tavaline automaatne täiendamine, mis näeb välja järgmine:

Siin, lisaks automaatse täiendamise reale, on näidatud, kellele see rida kuulub. See mehhanism töötab ainult väljendites, mis on ümbritsetud sulgudega ${}.

Kuidas märgata, on lisandunud visuaalsed markerid, mis näitavad muutuja tüüpi (nt string, number, massiiv jne). Samuti saab muuta automaatse täiendamise režiime (nt saab valida muutujaid või päiseid). Kuid isegi see ei ole kõige tähtsam!

Esiteks töötab automaatne täiendamine isegi väljendites (kus see on võimalik). Nii see välja näeb:

Ja teiseks, nüüd on automaatne täiendamine saadaval ka skriptides. Vaadake, kuidas see töötab!

Selle funktsionaalsuse võrdlemine Postmaniga ei ole mõtet — seal on automaatne täiendamine piiratud ainult staatiliste muutujate, päiste ja nende väärtuste nimekirjadega (palun parandage mind, kui ma midagi unustasin). Skripte ei automaattäiendata 🙁

Kokkuvõte

Oktoobris möödus aasta meie toote arendamisest. Selle aja jooksul oleme suutnud teha palju ja mõnedes parameetrites jõudsime oma konkurentidega samale tasemele. Kuidas iganes, meie eesmärk on luua tõeliselt mugav tööriist API-dega töötamiseks. Meil on veel palju teha, siin on meie projekti arendamise umbkaudne kava järgmiseks aastaks: https://testmace.com/roadmap.

Teie tagasiside aitab meil paremini orienteeruda funktsioonide rohkusest, samas kui teie toetamine annab meile jõudu ja usku, et teeme õiget asja. Täna on meie projekti jaoks oluline päev — TestMace'i publikatsiooni päev ProductHunt. Palun toetage meie projekti, see on meile väga oluline. Eriti, kuna meie PH lehel on täna ahvatlev pakkumine, ja see on piiratud.

Allikas: habr.com