Tere kõik, siin on TestMace! Võib-olla teavad paljud meist meie eelnevatest artikleid. Neile, kes just liitusid: me arendame IDE-d API-dega töötamiseks TestMace'i jaoks. Kõige sagedamini esitatav küsimus TestMace'i ja konkurentide toodete võrdlemisel on - „Milles te Postmanist erinevate?” Otsustasime, et on aeg anda põhjalik vastus sellele küsimusele. Järgnevalt oleme punkthaaval kirja pannud meie eelised võrreldes Postman.

Sõlmedeks jagamine

Kui töötate Postmaniga, siis teate, et päringu liides sisaldab kogu vajalikku funktsionaalsust. Seal on skriptid, testid ja ise päringud. See lihtsustab uustulnukate tööd, kuid suurte stsenaariumide puhul ei ole selline lähenemine paindlik. Mis siis, kui soovite luua mitmeid päringuid ja teha nende pealt agregatsiooni? Mis siis, kui soovite käivitada skripti ilma päringuta või mitu loogiliselt eraldatud skripti järjest? Lõppude lõpuks oleks tore eraldada testid tavalistest utilitaarsetest skriptidest. Peale selle on lähenemine „kõik funktsionaalsus ühte sõlme” mitteskaleeritav - liides muutub kiiresti ülekoormatud.

TestMace jagab algselt kogu funktsionaalsuse erinevate tüüpidega sõlmedeks. Soovid teha päringu? Siin on päringusamm sõlm. Soovid kirjutada skripti? Siin on script sõlm. Vajad teste? Palun - Kinnitus sõlm. Ah jaa, sa saad selle kõik keerata kaust sõlme. Ja kõik see on lihtsalt omavahel kombineeritav. Selline lähenemine on mitte ainult väga paindlik, vaid ka kooskõlas vastutuse jaotamise põhimõttega, lubades kasutada ainult seda, mis on tõeliselt vajalik hetkel. Miks mul on skripte ja teste vaja, kui ma tahan lihtsalt päringut teha?

Inimesele arusaadav projekti formaat

TestMace'i ja Postmani vahel on kontseptuaalne erinevus salvestusmeetodis. Postmanis salvestatakse kõik päringud kuskil kohalikus salvestuses. Kui on vajadus jagada päringuid mitme kasutaja vahel, tuleb kasutada sisseehitatud sünkroniseerimist. Tegelikult on see üldaktsepteeritud lähenemine, mis ei ole ilma puudusteta. Kuidas on andmete turvalisusega? Lõppude lõpuks ei pruugi paljude ettevõtete poliitika lubada andmete hoidmist kolmandatel isikutel. Küll aga usume, et TestMace suudab pakkuda midagi paremat! Selle parenduse nimi on „inimesele arusaadav projekti formaat”.

Alustame sellest, et TestMace's on põhimõtteliselt olemas „projekt“ mõiste. Rakendus arendati algselt silmas pidades projektide salvestamist versioonihalduse süsteemides: projekti struktuur peegeldab praktiliselt täpselt failistruktuuri, salvestusformaadina kasutatakse yaml'i (ilma liigsete sulgude ja komadeeta), ning iga sõlme failiesitus on dokumentatsioonis põhjalikult kirjeldatud. Ent enamikul juhtudel te ei pea sinna vaatama — kõik väljade nimed on loogiliselt nimetatud.

Mis kasu see kasutajale annab? See võimaldab väga paindlikult muuta meeskonna töövoogu, kasutades tuttavaid lähenemisi. Näiteks saavad arendajad hoida projekti samas hoidlas nagu backend. Harudes, peale koodi baasi otsese muutmise, saab arendaja parandada olemasolevaid päringuskeeme ja teste. Pärast muudatuste salvestamist hoidlas (git, svn, mercurial — mis teile rohkem meeldib) CI (teie lemmik, mitte kellelegi pealesurutud) käivitab meie käsurea utiliidi testmace-cli, ja pärast täitmist saadud aruanne (nt junit formaadis, mida testmace-cli samuti toetab) saadetakse vastavasse süsteemi. Ja eelpool mainitud turvalisuse küsimus ei ole enam probleem.

Kuidas näete, TestMace ei kehtesta oma ökosüsteemi ja paradigma. Selle asemel integreerub see lihtsalt juba väljakujunenud protsessidesse.

Dünaamilised muutujad

TestMace järgib no-code kontseptsiooni: kui probleemi on võimalik lahendada ilma koodi kasutamata, püüame anda selle võimaluse. Töö muutujaitega on just see funktsionaalsus, kus enamikul juhtudel suudetakse ilma programmeerimiseta hakkama.

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

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

Kuid meie arvates tundub skripti kirjutamine nii lihtsa ja sageli kasutatava stsenaariumi jaoks ülemäärane. Seetõttu on TestMace'is võimalik määrata muutuja tükk vastusest, kasutades graafilist liidest. Vaadake, kui lihtne see on:

Ja ja nüüd igas päringus uuendatakse seda dünaamilist muutujat. Kuid võite väita, et Postmani lähenemine on paindlikum ning see võimaldab mitte ainult määrata väärtust, vaid sooritada ka teatud eelprotsessimist. Nii saate eelmist näidet muuta:

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

Noh, selleks on TestMace'is script moodul, mis katab selle stsenaariumi. Eelmise juhtumi kordamiseks TestMace'is tuleb päringu järel luua script moodul ja kasutada järgmist koodi skripti jaoks:

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

Nagu näete, on moodulite koostamine ka siin hästi toimiv. Ja sellise lihtsa juhtumi puhul, nagu eespool kirjeldatud, saate isegi lihtsalt määrata väljendi ${crypto.MD5($response.data)} muutujaks, mis luuakse graafilise liidese kaudu!

Testide loomine läbi GUI

Postman võimaldab testide loomist skriptide kirjutamise kaudu (Postmani puhul on see JavaScript). Sellel lähenemisel on palju eeliseid — praktiliselt piiramatud võimalused, valmislahenduste olemasolu jne.

Kuid reaalsus on sageli selline (me ei ole sellised, elu on selline), et testijatel ei ole programmeerimisoskusi, kuid sooviks oleks juba praegu meeskonnale kasu tuua. Selliste juhtumite jaoks, järgides no-code kontseptsiooni, võimaldab TestMace luua lihtsaid teste läbi graafilise liidese, ilma skriptide kirjutamiseta. Näiteks, kuidas näeb välja testimise loomise protsess, mis võrdleb väärtusi võrdsuse osas:

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

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

Sageli tekivad olukorrad, kus teatud päringut või isegi tervet stsenaariumi tuleb mitu korda teostada erinevates projektiosades. Näiteks võivad sellised päringud olla kohandatud mitmeastmelised autentimised, keskkonna viimine soovitud olekusse jne. Üldiselt, kui rääkida programmeerimiskeelte terminoloogias, siis tahaks omada funktsioone, mida saab taaskasutada erinevates rakenduse osades. TestMace'is täidab seda funktsiooni link solm. Kasutamine on väga lihtne:
1) loo päring või skript
2) loo Link tüüpi solm
3) määra parameetrites skripti link, mille lõid esimesel sammul

Edasijõudnud variandis saad määrata, milliseid dünaamilisi muutujaid skriptist tõsta kõrgemal seoses lingiga. Kõlab segaselt? Oletame, et oleme loonud kausta nimega create-post, mille sees määratakse antud solmi dünaamiline muutuja postId. Nüüd saad Link solmis create-post-link selgesõnaliselt määrata, et muutuja postId määra vanemale create-post-link. See mehhanism (taas, rääkides programmeerimisekeeles) on kasutatav „funktsioonist” tulemuse tagastamiseks. Üsna äge, DRY täies mahus ja jälle ükski koodirea ei kannatanud.

Postmani osas on funktsiooninõue päringute taaskasutamiseks rippunud alates 2015. aastast, ja tundub, et isegi on mõningaid vihjeid, et selle probleemiga tegeletakse. Praeguses vormis on Postmanil muidugi võimalus täitmise voogu muuta, mis teoorias võimaldab sellist käitumist rakendada, kuid see on pigem räpane nipp kui tõeliselt toimiv lähenemine.

Muud erinevused

• Suurem kontroll muutujate nähtavuse üle. Postmanis saab muutuja määrata kõige väiksemasse ulatusse, mis on kogum. TestMace võimaldab määrata muutujaid iga päringu või kausta jaoks. Postman Share kogum võimaldab eksportida ainult kogusid, samas kui TestMace jagamine töötab iga solmi jaoks.
• TestMace toetab pärandpealkiri, mis võivad vaikimisi alla laadida lastesse päringutesse. Postmanil on selle kohta olemas ülesanne, ja see on isegi suletud, kuid lahenduseks pakutakse… kasutada skripte. TestMace'is konfigureeritakse see kõik GUI kaudu ja on võimalus valikuline pärandipealkirjade väljalülitamine konkreetsetes järeltulijates.
• Tagasi/edasi. See töötab mitte ainult solmade redigeerimisel, vaid ka liigutamisel, kustutamisel, ümbernimetamisel ja muudel toimingutel, mis muudavad projekti struktuuri.
• Päringutele kinnitatud failid muutuvad projekti osaks ja salvestatakse koos sellega, samas kui need sünkroonitakse suurepäraselt erinevalt Postmanist. (Jah, pole enam vaja igal korral käsitsi faile valida iga käivitamise ajal ja edastada kolleegidele arhive.)

Võimalused, mis juba ukse ees

Me ei suutnud vastu panna kiusatusel päeva valgele tuua väikene saladus järgmiste väljalasetega, eriti kuna funktsionaalsus on väga meeldiv ja on juba eelväljaande lihvimise faasis. Nii et, tervitame.

Funktsioonid

Nagu teada, kasutatakse Postmanis väärtuste genereerimiseks nn dünaamilisi muutujaid. Nende loetelu on muljetavaldav ja enamik funktsioone teenib valeandmete genereerimise eesmärki. Näiteks, et genereerida juhuslikku e-posti aadressi, tuleb kirjutada:

{{$randomEmail}}

Kuid kuna need on muutujad (kuigi dünaamilised), ei saa neid kasutada nagu funktsioone: need ei ole parametriseeritavad, seega ei saa stringilt räsida.

TestMace'is plaanime lisada «ausad» funktsioonid. Otse ${} sees saab mitte ainult viidata muutujaile, vaid ka funktsiooni kutsuda. See tähendab, et kui on vaja genereerida kuulus vale e-posti aadress, kirjutame lihtsalt

${faker.internet.email()}

Lisaks sellele, et see on funktsioon, on märgata, et on võimalik kutsuda objekti meetodit. Ja suurte tasapindade dünaamiliste muutujate loendi asemel on meil loogiliselt rühmitatud objektide kogum.

Ent mis saab siis, kui tahame arvutada stringi räsida? Lihtne!

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

On märgata, et parametriks võib isegi edastada muutujaid! Siin võib uudishimu lugeja kahtlustada midagi kahtlast...

JavaScripti kasutamine väljendites

... ja mitte ilmaasjata! Kui funktsioonide nõuded sündisid, jõudsime äkki arusaamisele, et väljendites on vaja lubada kehtiv JavaScript. Seega on nüüd teil vabadus kirjutada väljendeid stiilis:

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

Ja kõik see ilma skriptideta otse sisestusväljade sees!

Mis puudutab Postmanit, siis siin saab kasutada ainult muutujaid ja püüdes kirjutada vähimatki väljendit, protestib validatsioon ja keelab selle arvutamise.

Täpne automaatne täiendamine

Praegu sisaldab TestMace standardset automaatset täiendamist, mis näeb välja järgmiselt:

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

Nagu märkida võib, on lisandunud visuaalsed märgid, mis osutavad muutujate tüübile (näiteks string, number, massiiv jne). Samuti on võimalik muuta automaatse täiendamise režiime (näiteks saab valida automaatse täiendamise muutujate või pealkirjade järgi). Kuid isegi see ei ole veel kõige tähtsam!

Esiteks, automaatne täiendamine töötab isegi väljendites (kui 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!

Seda funktsionaalsust ei ole mõtet Postmaniga võrrelda — seal on automaatne täiendamine piiratud ainult staatiliste muutujate, pealkirjade ja nende väärtuste loetelu (parandage mind, kui ma midagi unustasin). Skripte ei automaattäiendata 🙁

Kokkuvõte

Oktoobris möödus aasta meie toote arendamisest. Selle aja jooksul oleme teinud palju ja mõningates parameetrites oleme jäänud konkurentide tasemele. Kuid meie eesmärk on luua tõeliselt mugav tööriist API-dega töötamiseks. Meil on veel palju tööd ees, siin on meie projekti arendusplaan järgmiseks aastaks: https://testmace.com/roadmap.

Teie tagasiside aitab meil paremini orienteeruda funktsioonide rohkusest, samas kui teie toetus toetab meid ja annab kindlust, et teeme vajalikku tööd. Juhtus nii, et täna on meie projekti jaoks tähtis päev — TestMace avaldamise päev ProductHunt. Palun toetage meie projekti, see on meile väga oluline. Eriti arvestades, et meie PH lehelt on täna ahvatlev pakkumine ja see on piiratud

Allikas: habr.com