Sanibonani nonke! Namuhla sifuna ukwethula emphakathini we-IT umkhiqizo wethu - i-IDE yokusebenza nama-API I-TestMace. Mhlawumbe abanye benu sebazi ngathi izihloko ezedlule. Kodwa-ke, akubanga khona ukubuyekezwa okuphelele kwethuluzi, ngakho-ke sibhekana nalokhu kushiyeka okungekuhle.

Ukugqugquzela

Ngingathanda ukuqala ngokuthi, empeleni, safika kanjani kule mpilo futhi sanquma ukudala ithuluzi lethu lomsebenzi othuthukisiwe nge-API. Ake siqale ngohlu lokusebenza okufanele umkhiqizo ube nalo, okuthi ngalo, ngokubona kwethu, singasho ukuthi “i-IDE yokusebenza ngama-API”:

• Ukudala nokwenza imibuzo kanye nemibhalo (ukulandelana kwemibuzo)
• Ukubhala izinhlobo ezahlukene zokuhlolwa
• Isizukulwane sokuhlola
• Ukusebenza ngezincazelo ze-API, okuhlanganisa ukungenisa kusuka kumafomethi afana ne-Swagger, i-OpenAPI, i-WADL, njll.
• Izicelo zokubhuqa
• Ukusekelwa okuhle kolimi olulodwa noma eziningi zokubhala izikripthi, okuhlanganisa ukuhlanganiswa namalabhulali adumile
• nokunye.

Uhlu lunganwetshwa ukuze luvumelane nokuthanda kwakho. Ngaphezu kwalokho, kubalulekile ukudala hhayi kuphela i-IDE ngokwayo, kodwa futhi nengqalasizinda ethile, njengokuvumelanisa kwamafu, amathuluzi omugqa womyalo, isevisi yokuqapha ku-intanethi, njll. Ekugcineni, izitayela zeminyaka yamuva azisho nje kuphela ukusebenza okunamandla kohlelo lokusebenza, kodwa futhi nokubonakalayo kwalo okujabulisayo.

Ubani odinga ithuluzi elinjalo? Ngokusobala, bonke labo abaxhumeke ngandlela thize ekuthuthukisweni nasekuhlolweni kwama-API bangabathuthukisi nabahloli =). Ngaphezu kwalokho, uma okokuqala kuvame ukwanele ukwenza imibuzo eyodwa kanye nemibhalo elula, khona-ke kubahloli lokhu kungenye yamathuluzi ayinhloko, okumele, phakathi kwezinye izinto, ihlanganise indlela enamandla yokubhala izivivinyo enekhono lokuziqhuba. CI.

Ngakho, ngokulandela le mihlahlandlela, saqala ukwakha umkhiqizo wethu. Ake sibone ukuthi yini esesiyizuzile kulesi sigaba.

Ukuqala okusheshayo

Ake siqale nomuntu engimaziyo kuqala nesicelo. Ungayilanda kuwebhusayithi yethu. Okwamanje, wonke amapulatifomu amakhulu ama-3 asekelwa - Windows, Linux, MacOS. Landa, faka, qalisa. Uma uyethula okokuqala, ungase ubone iwindi elilandelayo:

Chofoza uphawu lokuhlanganisa phezulu endaweni yokuqukethwe ukuze udale isicelo sakho sokuqala. Ithebhu yombuzo ibonakala kanje:

Ake sikubheke kabanzi. Isixhumi esibonakalayo sesicelo sifana kakhulu nesixhumi esibonakalayo samaklayenti athandwayo okuphumula, okwenza ukufuduka kusuka kumathuluzi afanayo kube lula. Masenze isicelo sokuqala ku-url https://next.json-generator.com/api/json/get/NJv-NT-U8

Ngokuvamile, ekuboneni kokuqala, iphaneli yokuphendula nayo ayilahli noma yiziphi izimanga. Nokho, ngingathanda ukunakwa amaphuzu athile:

1. Umzimba wempendulo uvezwa ngesimo sesihlahla, okokuqala esingeza okuqukethwe kolwazi futhi okwesibili sikuvumela ukuthi wengeze izici ezithakazelisayo mayelana nalokhu ngezansi.
2. Kukhona ithebhu ethi Iziqinisekiso, ebonisa uhlu lokuhlolwa kwesicelo esinikeziwe

Njengoba ubona, ithuluzi lethu lingasetshenziswa njengeklayenti elikahle lokuphumula. Kodwa-ke, besingeke sibe lapha uma amandla ayo abekhawulelwe ekuthumeleni izicelo kuphela. Okulandelayo, ngizochaza imiqondo eyisisekelo nokusebenza kwe-TestMace.

Imiqondo Eyisisekelo Nezici

Knot

Ukusebenza kwe-TestMace kuhlukaniswe ngezinhlobo ezahlukene zamanodi. Esibonelweni esingenhla, sibonise ukusebenza kwenodi ye-RequestStep. Kodwa-ke, izinhlobo ezilandelayo zama-node manje seziyatholakala kuhlelo lokusebenza:

• CelaIsinyathelo. Le yi-node lapho ungakha khona isicelo. Ingaba nenodi Yokugomela eyodwa kuphela njenge-elementi yengane.
• Ukugomela. I-node isetshenziselwa ukubhala izivivinyo. Kungaba kuphela inodi yengane yenodi ye-RequestStep.
• Ifolda. Ikuvumela ukuthi uhlanganise ama-Folder kanye nama-RequestStep node ngaphakathi kwawo.
• Iphrojekthi. Lena inodi yempande, eyakhiwe ngokuzenzakalelayo lapho iphrojekthi idaliwe. Uma kungenjalo, iphinda ukusebenza kwe-Node Yefolda.
• Isixhumanisi. Xhuma kufolda noma inodi ye-RequestStep. Ikuvumela ukuthi usebenzise kabusha imibuzo nezikripthi.
• nokunye.

Ama-node atholakala kuma-scratches (iphaneli engezansi kwesokunxele, isetshenziselwa ukudala ngokushesha imibuzo "yokuvala okukodwa") kanye namaphrojekthi (iphaneli phezulu kwesokunxele), esizohlala kuyo ngokuningiliziwe.

Le phrojekthi

Lapho wethula uhlelo lokusebenza, ungase ubone umugqa Wodwa Wephrojekthi ekhoneni eliphezulu kwesokunxele. Lena impande yesihlahla sephrojekthi. Uma uqala iphrojekthi, kwakhiwa iphrojekthi yesikhashana, indlela encike ohlelweni lwakho lokusebenza. Noma nini ungakwazi ukuhambisa iphrojekthi endaweni ekulungele wena.

Inhloso eyinhloko yephrojekthi yikhono lokulondoloza intuthuko ohlelweni lwefayela nokuqhubeka ukuvumelanisa ngokusebenzisa izinhlelo zokulawula inguqulo, sebenzisa imibhalo ku-CI, ubuyekeze izinguquko, njll.

Okuguquguqukayo

Okuguquguqukayo kungenye yezindlela eziyinhloko zohlelo lokusebenza. Labo kini abasebenza ngamathuluzi afana ne-TestMace kungenzeka sebevele banombono walokho esikhuluma ngakho. Ngakho-ke, okuguquguqukayo kuyindlela yokugcina idatha evamile nokuxhumana phakathi kwama-node. I-analogue, isibonelo, yizinto eziguquguqukayo zemvelo ku-Postman noma i-Insomnia. Nokho, sadlulela phambili futhi sathuthukisa isihloko. Ku-TestMace, okuguquguqukayo kungasethwa ezingeni le-node. Noma yikuphi. Kukhona futhi indlela yokuthola okuguquguqukayo kumadlozi kanye neziguquguquko ezeqayo enzalweni. Ukwengeza kunezinombolo eziguquguqukayo ezakhelwe ngaphakathi, amagama eziguquguqukayo ezakhelwe ngaphakathi aqala ngawo $. Nazi ezinye zazo:

• $prevStep — isixhumanisi kokuguquguqukayo kwenodi yangaphambilini
• $nextStep — isixhumanisi kokuguquguqukayo kwenodi elandelayo
• $parent - into efanayo, kodwa kuphela idlozi
• $response - impendulo evela kuseva
• $env - Izimo eziguquguqukayo zamanje
• $dynamicVar - okuguquguqukayo okuguquguqukayo okudalwe ngesikhathi sokwenziwa kombhalo noma umbuzo

$env - lawa ajwayelekile ngokwezinga le-Project node variables, nokho, isethi yezimo eziguquguqukayo iyashintsha kuye ngendawo ekhethiwe.

Okuguquguqukayo kufinyelelwa nge ${variable_name}
Inani lokuguquguquka lingaba okunye okuguquguqukayo, noma ngisho nenkulumo ephelele. Isibonelo, i-url variable ingaba isisho esifana nalokhu
http://${host}:${port}/${endpoint}.

Ngokwehlukana, kufanelekile ukuqaphela amathuba okunikeza okuguquguqukayo ngesikhathi sokwenziwa kombhalo. Isibonelo, ngokuvamile kunesidingo sokulondoloza idatha yokugunyazwa (ithokheni noma yonke inhlokweni) evela kuseva ngemva kokungena ngemvume ngempumelelo. I-TestMace ikuvumela ukuthi ulondoloze idatha enjalo eziguquguqukayo eziguquguqukayo zomunye wamadlozi. Ukuze ugweme ukungqubuzana neziguquguqukayo “ezimile” ezivele zikhona, okuguquguqukayo okuguquguqukayo kubekwa entweni ehlukile $dynamicVar.

Izimo

Ngokusebenzisa zonke izici ezingenhla, ungaqalisa yonke imibuzo ebhalwe phansi. Isibonelo, ukudala ibhizinisi -> ukubuza ibhizinisi -> ukususa ibhizinisi. Kulesi simo, isibonelo, ungasebenzisa i-Folder node ukuze uqoqe amanodi amaningana we-RequestStep.

Ukuqedela ngokuzenzakalela nokugqamisa isisho

Ukuze uthole umsebenzi olula onezinto eziguquguqukayo (hhayi kuphela) ukuqedela ngokuzenzakalela kuyadingeka. Futhi kunjalo, ukugqamisa inani lesisho ukwenza kube lula futhi kube lula ukucacisa ukuthi ukuhluka okuthile kufana nani. Kunjalo impela uma kungcono ukubona kanye kunokuzwa izikhathi eziyikhulu:

Kuyaphawuleka ukuthi ukuqedela ngokuzenzakalela akwenziwa kuphela eziguquguqukayo, kodwa futhi, isibonelo, izihloko, amanani izihloko ezithile (isibonelo, ukuqedela ngokuzenzakalela for the Content-Type unhlokweni), izivumelwano kanye nokunye okuningi. Uhlu luvuselelwa njalo njengoba uhlelo lukhula.

Hlehlisa/yenza futhi

Ukuhlehlisa/ukwenza kabusha izinguquko kuyinto elula kakhulu, kodwa ngesizathu esithile akwenziwa yonke indawo (futhi amathuluzi okusebenza ngama-API awahlukile). Kodwa asibona abanye balabo!) Sisebenzise ukuhlehlisa/senze kabusha kuyo yonke iphrojekthi, okukuvumela ukuthi uhlehlise hhayi kuphela ukuhlela indawo ethile, kodwa nokudalwa kwayo, ukususwa, ukunyakaza, njll. Imisebenzi ebaluleke kakhulu idinga ukuqinisekiswa.

Ukudala izivivinyo

I-Assertion node inesibopho sokudala ukuhlola. Esinye sezici eziyinhloko yikhono lokudala izivivinyo ngaphandle kokuhlela, usebenzisa abahleli bakhelwe ngaphakathi.

I-Assertion node iqukethe isethi yokugomela. Ukugomela ngakunye kunohlobo lwako; okwamanje kunezinhlobo ezimbalwa zokugomela

1. Qhathanisa amanani - umane uqhathanise amanani angu-2. Kukhona ama-opharetha okuqhathanisa amaningana: alinganayo, awalingani, makhulu kune, makhulu noma alingana, angaphansi, angaphansi, alingana noma alingana nawo.

2. Iqukethe inani - ihlola ukwenzeka kochungechunge oluncane lweyunithi yezinhlamvu.

3. I-XPath - ihlola ukuthi isikhethi ku-XML siqukethe inani elithile.

4. Ukugomela kwe-JavaScript kuwumbhalo we-javascript ongenangqondo obuyisela iqiniso empumelelweni namanga ekuhlulekeni.

Ngiyaqaphela ukuthi esokugcina kuphela esidinga amakhono wokuhlela avela kumsebenzisi, okunye ukugomela okungu-3 kwenziwa kusetshenziswa isikhombimsebenzisi esibonakalayo. Nansi, ngokwesibonelo, indlela ingxoxo yokudala ukugomela kwamanani eqhathanisa ibonakala kanjani:

I-icing ekhekheni wukudala okusheshayo kokugomela okuvela ezimpendulweni, vele ubheke!

Kodwa-ke, ukugomela okunjalo kunemikhawulo esobala, ongahle ufune ukusebenzisa i-javascript ukuze uyinqobe. Futhi lapha i-TestMace ihlinzeka ngendawo enethezekile enokuqedela ngokuzenzakalela, ukugqanyiswa kwe-syntax ngisho nesihlaziyi esimile.

Incazelo ye-API

I-TestMace ikuvumela ukuthi ungagcini nje ngokusebenzisa i-API, kodwa futhi ukuyibhala. Ngaphezu kwalokho, incazelo ngokwayo nayo inokwakheka kwesigaba futhi ihambisana ngokwemvelo kuyo yonke iphrojekthi. Ngaphezu kwalokho, okwamanje kungenzeka ukungenisa izincazelo ze-API kusuka kumafomethi we-Swagger 2.0 / OpenAPI 3.0. Incazelo ngokwayo ayigcini nje ngokuqamba amanga, kodwa ihlanganiswe eduze nayo yonke iphrojekthi, ikakhulukazi, ukuqedela ngokuzenzakalela ama-URL, izihloko ze-HTTP, amapharamitha wemibuzo, njll. kuyatholakala, futhi esikhathini esizayo sihlela ukwengeza izivivinyo. ukuze kuthotshelwe impendulo nencazelo ye-API.

Inodi yokwabelana

Icala: ungathanda ukwabelana ngesicelo esiyinkinga noma umbhalo wonke nozakwenu noma umane usinamathisele esiphazamisini. I-TestMace ihlanganisa naleli cala: uhlelo lokusebenza likuvumela ukuthi ulandelele noma iyiphi i-node ngisho nesihlahla esincane ku-URL. Kopisha-namathisela futhi ungadlulisela kalula isicelo komunye umshini noma iphrojekthi.

Ifomethi yokugcina iphrojekthi efundeka umuntu

Okwamanje, inodi ngayinye igcinwe efayeleni elihlukile elinesandiso se-yml (njengoba kunjalo nge-Assertion node), noma kufolda enegama lenodi kanye nefayela le-index.yml kuyo.
Isibonelo, libukeka kanje ifayela lesicelo esilenzile ekubuyekezweni okungenhla:

index.yml

children: []
variables: {}
type: RequestStep
assignVariables: []
requestData:
  request:
    method: GET
    url: 'https://next.json-generator.com/api/json/get/NJv-NT-U8'
  headers: []
  disabledInheritedHeaders: []
  params: []
  body:
    type: Json
    jsonBody: ''
    xmlBody: ''
    textBody: ''
    formData: []
    file: ''
    formURLEncoded: []
  strictSSL: Inherit
authData:
  type: inherit
name: Scratch 1

Njengoba ubona, yonke into icacile. Uma uthanda, le fomethi ingahlelwa kalula ngokwenza.

Ukulandelana kwamafolda ohlelweni lwefayela kuphinda ngokuphelele ukulandelana kwamanodi kuphrojekthi. Isibonelo, iskripthi esifana nalokhu:

Imephu isistimu yefayela eya esakhiweni esilandelayo (isigaba sefolda kuphela esibonisiwe, kodwa ingqikithi icacile)

Lokhu kwenza inqubo yokubuyekezwa kwephrojekthi ibe lula.

Ngenisa ku-Postman

Ngemva kokufunda konke okungenhla, abanye abasebenzisi bazofuna ukuzama (kulungile?) umkhiqizo omusha noma (lokho isihogo esingadlali!) basebenzise ngokuphelele kuphrojekthi yabo. Nokho, ukufuduka kungamiswa ngenani elikhulu lentuthuko ku-Postman ofanayo. Ezimweni ezinjalo, i-TestMace isekela ukungenisa kwamaqoqo kwa-Postman. Okwamanje, ukungenisa ngaphandle kokuhlolwa kuyasekelwa, kodwa asiphiki ukuthi sikusekele ngokuzayo.

Izinhlelo

Ngethemba ukuthi abaningi balabo abafunde kuze kube manje bawuthandile umkhiqizo wethu. Nokho, akugcini lapho! Umsebenzi womkhiqizo uqhubeka ngokugcwele futhi nazi ezinye izici esihlela ukuzengeza maduze.

Ukuvumelanisa kwamafu

Esinye sezici ezicelwe kakhulu. Okwamanje, siphakamisa ukusebenzisa amasistimu okulawula inguqulo ukuze uvumelanise, okwenza ifomethi ibe nobungane kakhulu kulolu hlobo lwesitoreji. Nokho, lokhu kugeleza komsebenzi akufanelekile kuwo wonke umuntu, ngakho-ke sihlela ukwengeza indlela yokuvumelanisa eyaziwa kwabaningi ngamaseva ethu.

CLI

Njengoba kushiwo ngenhla, imikhiqizo yezinga le-IDE ayikwazi ukwenza ngaphandle kwazo zonke izinhlobo zokuhlanganisa nezinhlelo zokusebenza ezikhona noma ukuhamba komsebenzi. I-CLI iyona kanye edingekayo ukuze kuhlanganiswe izivivinyo ezibhalwe ku-TestMace kunqubo yokuhlanganisa eqhubekayo. Umsebenzi ku-CLI uqhubeka ngokugcwele; izinguqulo zangaphambili zizokwethula iphrojekthi ngombiko olula wekhonsoli. Ngokuzayo sihlela ukwengeza okukhipha umbiko ngefomethi ye-JUnit.

I-plugin system

Naphezu kwawo wonke amandla ethuluzi lethu, isethi yamacala adinga izixazululo ayinamkhawulo. Phela kunemisebenzi eqondene nomsebenzi othile. Yingakho esikhathini esizayo sihlela ukungeza i-SDK yokuthuthukisa ama-plugin futhi unjiniyela ngamunye uzokwazi ukwengeza ukusebenza kokuthanda kwabo.

Ukwandisa ububanzi bezinhlobo zamanodi

Le sethi yamanodi ayifaki zonke izimo ezidingwa umsebenzisi. Amanodi ahlelelwe ukwengezwa:

• I-Script node - iguqula futhi ibeke idatha kusetshenziswa i-js ne-API ehambisanayo. Usebenzisa lolu hlobo lwenodi, ungenza izinto ezifana nokucela ngaphambilini kanye nezikripthi zokuthumela isicelo ku-Postman.
• I-GraphQL node - ukwesekwa kwe-graphql
• Inodi yokugomela yangokwezifiso - izokuvumela ukuthi unwebe isethi yokugomela ekhona kuphrojekthi
  Ngokwemvelo, lolu akulona uhlu lokugcina; luzobuyekezwa njalo ngenxa, phakathi kwezinye izinto, impendulo yakho.

Imibuzo Evame Ukubuzwa

Uhluke kanjani ku-Postman?

1. Umqondo wama-node, okuvumela ukuthi ulinganise ngokungapheli ukusebenza kwephrojekthi
2. Ifomethi yephrojekthi efundeka umuntu ngokuyigcina kusistimu yefayela, eyenza umsebenzi ube lula kusetshenziswa amasistimu okulawula inguqulo
3. Ikhono lokudala izivivinyo ngaphandle kokuhlela nokusekelwa kwe-js okuthuthuke kakhulu kusihleli sokuhlola (ukuqedela ngokuzenzakalela, ukuhlaziya okumile)
4. Ukuqedela ngokuzenzakalela okuthuthukisiwe nokugqanyiswa kwevelu yamanje yezinto eziguquguqukayo

Ingabe lona umkhiqizo womthombo ovulekile?

Cha, okwamanje imithombo ivaliwe, kodwa esikhathini esizayo sicabangela ithuba lokuvula imithombo

Uphila ngani?)

Kanye nenguqulo yamahhala, sihlela ukukhipha inguqulo ekhokhelwayo yomkhiqizo. Izofaka phakathi izinto ezidinga uhlangothi lweseva, isibonelo, ukuvumelanisa.

isiphetho

Iphrojekthi yethu ihamba ngokugxumagxuma ibheke ekukhululweni okuzinzile. Kodwa-ke, umkhiqizo ungasetshenziswa kakade, futhi impendulo enhle evela kubasebenzisi bethu bokuqala iwubufakazi balokhu. Siqoqa impendulo ngenkuthalo, ngoba ngaphandle kokubambisana eduze nomphakathi akunakwenzeka ukwakha ithuluzi elihle. Ungasithola lapha:

Website Official

yocingo

ukuxega

Facebook

I-tracker yezinkinga

Sibheke ngabomvu izifiso zakho kanye nokusikisela!

Source: www.habr.com