Salama daholo! Androany dia te-hanolotra ny vokatray ho an'ny daholobe IT izahay - IDE ho an'ny fampiasana API . Angamba efa fantatry ny sasany aminareo ny momba anay . Na izany aza, tsy mbola nisy ny famerenana feno momba ny fitaovana, noho izany dia miatrika io lesoka mampalahelo io izahay.
motivation
Te hanomboka amin'ny fomba, raha ny marina, tonga teto amin'ity fiainana ity isika ary nanapa-kevitra ny hamorona fitaovana manokana ho an'ny asa mandroso miaraka amin'ny API. Andeha isika hanomboka amin'ny lisitr'ireo fampiasa izay tokony ananan'ny vokatra iray, izay, araka ny hevitray, dia azo lazaina fa "IDE amin'ny fiasana amin'ny API":
- Mamorona sy manatanteraka fanontaniana sy scripts (sequence de queries)
- Manoratra karazana fitsapana isan-karazany
- Taranaka fitsapana
- Miasa miaraka amin'ny famaritana API, anisan'izany ny fanafarana avy amin'ny endrika toa ny Swagger, OpenAPI, WADL, sns.
- Fangatahana maneso
- Fanohanana tsara ho an'ny fiteny iray na maromaro amin'ny fanoratana script, anisan'izany ny fampidirana ireo tranomboky malaza
- sy ny sisa.
Ny lisitra dia azo itarina mifanaraka amin'ny tsironao. Ankoatr'izay, zava-dehibe ny mamorona tsy ny IDE ihany, fa koa ny fotodrafitrasa sasany, toy ny fampifanarahana ny rahona, ny fitaovana baiko, ny serivisy fanaraha-maso an-tserasera, sns. Amin'ny farany, ny fironana tato anatin'ny taona vitsivitsy dia mandidy antsika tsy ny fampiasa mahery vaika amin'ny fampiharana, fa ny interface tsara koa.
Iza no mila fitaovana toy izany? Mazava ho azy fa ireo rehetra izay farafaharatsiny mifandray amin'ny fampandrosoana sy ny fitsapana ny API dia mpamorona sy tester =). Ankoatr'izay, raha ho an'ny teo aloha dia matetika ampy ny manatanteraka fanontaniana tokana sy script tsotra, dia ho an'ny mpanandrana izany no iray amin'ireo fitaovana lehibe indrindra, izay, ankoatra ny zavatra hafa, dia tokony ahitana rafitra mahery vaika amin'ny fanoratana fitsapana miaraka amin'ny fahafahana mampandeha azy ireo. CI.
Noho izany, nanaraka ireo torolàlana ireo izahay dia nanomboka namorona ny vokatray. Andeha hojerentsika ny zava-bita tamin'ity dingana ity.
Manomboka haingana
Andeha isika hanomboka amin'ny olom-pantatra voalohany amin'ny fampiharana. Afaka misintona azy ianao . Amin'izao fotoana izao, ny sehatra lehibe 3 dia tohanana - Windows, Linux, MacOS. Download, mametraka, manomboka. Rehefa sambany vao manomboka ianao dia mety ho hitanao ity varavarankely manaraka ity:
Kitiho ny marika miampy eo an-tampon'ny faritra votoaty hamoronana ny fangatahanao voalohany. Toy izao ny tabilao fangatahana:
Andeha hojerentsika amin'ny antsipiriany bebe kokoa. Ny interface interface dia mitovy amin'ny interface an'ny mpanjifa fialan-tsasatra malaza, izay manamora ny fifindra-monina avy amin'ny fitaovana mitovy. Andao hanao ny fangatahana voalohany amin'ny url
Amin'ny ankapobeny, raha vao jerena, ny tontolon'ny valin-kafatra ihany koa dia tsy mamoaka zavatra tsy ampoizina. Na izany aza, tiako ny hisarika ny sainao amin'ny lafiny sasany:
- Ny vatan'ny valinteny dia aseho amin'ny endrika hazo, izay voalohany manampy votoaty fampahalalana ary faharoa dia ahafahanao manampy endri-javatra mahaliana izay etsy ambany
- Misy tabilao Assertions, izay mampiseho lisitry ny fitsapana ho an'ny fangatahana nomena
Araka ny hitanao, ny fitaovanay dia azo ampiasaina ho mpanjifa fialan-tsasatra mety. Na izany aza, tsy ho eto isika raha voafetra amin'ny fandefasana fangatahana ihany ny fahaizany. Manaraka izany dia hosoratako ny foto-kevitra fototra sy ny fiasan'ny TestMace.
Hevitra fototra sy endri-javatra
node
Ny fiasa TestMace dia mizara ho karazana node samihafa. Ao amin'ny ohatra etsy ambony, nasehonay ny fiasan'ny node RequestStep. Na izany aza, ireto karazana nodes manaraka ireto dia hita ao amin'ny fampiharana:
- RequestStep. Ity no node ahafahanao mamorona fangatahana. Afaka manana node Assertion iray ihany izy io ho singa zaza.
- Fanambarana. Ny node dia ampiasaina hanoratana fitsapana. Mety ho node zaza amin'ny node RequestStep ihany.
- lahatahiry. Mamela anao hanambatra ny nodes Folder sy RequestStep ao anatin'ny tenany.
- Tetikasa. Ity no node fakany, noforonina ho azy rehefa noforonina ny tetikasa. Raha tsy izany, dia mamerina ny fiasan'ny node Folder.
- Rohy. Rohy mankany amin'ny lahatahiry na RequestStep node. Mamela anao hampiasa fanontaniana sy script indray.
- sy ny sisa.
Ny nodes dia hita amin'ny scratches (ny tontonana eo amin'ny farany ambany ankavia, ampiasaina amin'ny famoronana haingana fanontaniana "iray-off") ary amin'ny tetikasa (ny tontonana eo ankavia ankavia), izay hodinihintsika amin'ny antsipiriany bebe kokoa.
Ny tetikasa
Rehefa manomboka ny fampiharana ianao dia mety mahatsikaritra tsipika Tetika tokana eo amin'ny zoro havia ambony. Io no fototry ny hazo tetikasa. Rehefa manomboka tetikasa ianao dia misy tetikasa vonjimaika noforonina, ny lalana dia miankina amin'ny rafitra fiasanao. Afaka mamindra ny tetikasa amin'ny toerana mety aminao ianao amin'ny fotoana rehetra.
Ny tanjon'ny tetikasa dia ny fahafahana mamonjy ireo fivoarana ao amin'ny rafitra fichier ary mampifanaraka azy ireo bebe kokoa amin'ny alàlan'ny rafitra fanaraha-maso ny dikan-teny, mampandeha scripts amin'ny CI, mijery ny fanovana, sns.
hiovaova
Iray amin'ireo mekanisma manan-danja amin'ny fampiharana iray ny Variables. Ianareo izay miasa amin'ny fitaovana toa an'i TestMace dia mety efa manana hevitra momba izay resahinay. Noho izany, ny variables dia fomba iray hitahirizana angon-drakitra mahazatra sy hifandraisana eo amin'ny nodes. Ny analogue, ohatra, dia fiovan'ny tontolo iainana ao amin'ny Postman na Insomnia. Na izany aza, nandeha lavidavitra kokoa izahay ary namolavola ny lohahevitra. Ao amin'ny TestMace, azo apetraka amin'ny ambaratonga node ny variables. Any. Misy ihany koa ny fomba fandovana ny fari-piainana avy amin'ny razana sy ny fifandimbiasana amin'ny taranaka. Ankoatr'izay dia misy fari-pahalalana maromaro voaorina, manomboka amin'ny anaran'ireo fari-piadidiana naorina $. Ireto ny sasany amin'izy ireo:
$prevStep- rohy mankany amin'ny variables amin'ny node teo aloha$nextStep- rohy mankany amin'ny fari-piainan'ny node manaraka$parent- mitovy ihany fa ho an'ny razana ihany$response- valiny avy amin'ny mpizara$env- fari-piainana ankehitriny$dynamicVar- Variable mavitrika noforonina nandritra ny fanatanterahana ny script na ny fangatahana
$env - ireo dia fari-pahalalana mahazatra amin'ny haavon'ny node Project, na izany aza, miova arakaraka ny tontolo nofantenana ny fitambaran'ny fari-piainan'ny tontolo iainana.
Ny variable dia idirana amin'ny alalan'ny ${variable_name}
Ny sandan'ny fari-piainana iray dia mety ho fari-piainana hafa, na teny iray manontolo mihitsy aza. Ohatra, ny variable url dia mety ho fanehoana toy ny
http://${host}:${port}/${endpoint}.
Misaraka, tsara ny manamarika ny mety hisian'ny fanendrena variables mandritra ny famonoana script. Ohatra, matetika dia ilaina ny mitahiry angon-drakitra momba ny fanomezan-dàlana (marika na ny lohapejy manontolo) izay avy amin'ny mpizara taorian'ny fidirana nahomby. Ny TestMace dia ahafahanao mitahiry angon-drakitra toy izany ho variana mavitrika amin'ny iray amin'ireo razana. Mba hialana amin'ny fifandonana amin'ireo fari-piadidiana "statika" efa misy, dia apetraka ao anaty zavatra misaraka ny fari-piainana mavitrika $dynamicVar.
tranga
Amin'ny fampiasana ireo endri-javatra rehetra voalaza etsy ambony ireo dia azonao atao ny mampandeha ny sora-baventy fangatahana manontolo. Ohatra, mamorona entity -> manontany entity -> mamafa entity. Amin'ity tranga ity, ohatra, azonao atao ny mampiasa ny node Folder mba hanangonana nodes RequestStep maromaro.
Autocompletion sy fanasongadinana ny fomba fiteny
Ho an'ny asa mora miaraka amin'ny variables (ary tsy hoe) dia ilaina ny autocompletion. Ary mazava ho azy, manasongadina ny hasarobidin'ny fanehoan-kevitra iray mba hahamora kokoa sy hahamora kokoa ny manazava ny atao hoe fari-pitsipika manokana. Izany indrindra no mitranga rehefa tsara kokoa ny mahita indray mandeha toy izay mandre in-jato:
Tsara ny manamarika fa ny autocompletion dia ampiharina tsy ho an'ny variables, fa koa, ohatra, ho an'ny lohapejy, soatoavin'ny lohapejy sasany (ohatra, autocompletion ho an'ny lohatenin'ny Content-Type), protocols sy ny maro hafa. Havaozina tsy tapaka ny lisitra rehefa mitombo ny fampiharana.
Esory / avereno
Ny fanafoanana/famerenana ny fanovana dia zavatra tena mety, saingy noho ny antony sasany dia tsy ampiharina na aiza na aiza izany (ary ny fitaovana ampiasaina amin'ny API dia tsy misy afa-tsy). Saingy tsy anisan'ireo izahay!) Nametraka fanafoanana/avereno nandritra ny tetikasa iray manontolo, izay ahafahanao manafoana tsy ny fanovana node manokana, fa ny famoronana, famafana, hetsika, sns. Mitaky fanamafisana ny asa sarotra indrindra.
Mamorona fitsapana
Ny node Assertion dia tompon'andraikitra amin'ny famoronana fitsapana. Ny iray amin'ireo endri-javatra lehibe indrindra dia ny fahafahana mamorona fitsapana tsy misy fandaharana, mampiasa tonian-dahatsoratra naorina.
Ny node Assertion dia ahitana andian-teny. Ny fanambaràna tsirairay dia samy manana ny karazany; amin'izao fotoana izao dia misy karazana fanambaràna maromaro
-
Ampitahao ny soatoavina - ampitahao fotsiny ny soatoavina 2. Misy mpandraharaha fampitahana maromaro: mitovy, tsy mitovy, lehibe noho, lehibe kokoa na mitovy amin'ny, latsaky ny, latsaky na mitovy.
-
Misy sanda - manamarina ny fisian'ny zana-tsipìka ao anaty tady.
-
XPath - manamarina fa misy sanda iray ny mpifidy amin'ny XML.
-
JavaScript assertion dia script javascript tsy misy dikany izay mamerina marina amin'ny fahombiazana ary diso amin'ny tsy fahombiazana.
Marihiko fa ny farany ihany no mitaky fahaiza-manao fandaharana avy amin'ny mpampiasa, ny assertion 3 hafa dia noforonina amin'ny alàlan'ny interface grafika. Eto, ohatra, ny endriky ny fifanakalozan-kevitra amin'ny famoronana fampitahana ny soatoavina:
Ny icing amin'ny mofomamy dia ny famoronana haingana ny fanambarana avy amin'ny valiny, jereo fotsiny!
Na izany aza, ny fanambaràna toy izany dia manana fetra mazava, izay azonao ampiasaina amin'ny fanamafisana javascript mba handresena. Ary eto koa ny TestMace dia manome tontolo milamina miaraka amin'ny autocompletion, fanasongadinana syntax ary mpandinika static mihitsy aza.
API Description
Ny TestMace dia mamela anao tsy hampiasa ny API fotsiny, fa koa handrakitra izany. Ankoatra izany, ny famaritana ny tenany ihany koa dia manana rafitra ambaratongam-pahefana ary mifanaraka ara-organika amin'ny ambiny amin'ny tetikasa. Ankoatra izany, azo atao ny manafatra famaritana API amin'ny endrika Swagger 2.0 / OpenAPI 3.0. Ny famaritana ny tenany dia tsy mandainga fotsiny ny lanja maty, fa mifandray akaiky amin'ny ambiny amin'ny tetikasa, indrindra indrindra, ny famitana ny URL, ny lohatenin'ny HTTP, ny mari-pamantarana fangatahana, sns., ary amin'ny ho avy dia mikasa ny hanampy fitsapana ho fanarahana ny valinteny miaraka amin'ny famaritana API.
Mizara node
Raharaha: te hizara fangatahana olana ianao na script iray manontolo amin'ny mpiara-miasa iray na ampifandraisinao amin'ny bibikely fotsiny. Ny TestMace dia mirakitra an'ity tranga ity ihany koa: ny fampiharana dia mamela anao hanao serialise izay node ary na dia subtree amin'ny URL aza. Copy-paste ary azonao atao ny mamindra mora amin'ny milina na tetikasa hafa ny fangatahana.
endrika fitehirizana tetikasa azo vakin'ny olombelona
Amin'izao fotoana izao, ny node tsirairay dia voatahiry ao anaty rakitra misaraka miaraka amin'ny fanitarana yml (toy ny amin'ny node Assertion), na ao anaty lahatahiry misy ny anaran'ny node sy ny rakitra index.yml ao anatiny.
Ohatra, toy izao ny rakitra fangatahana nataonay tamin'ny famerenana etsy ambony:
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 1Araka ny hitanao dia mazava tsara ny zava-drehetra. Raha tianao, ity endrika ity dia azo ovaina mora foana amin'ny tanana.
Ny ambaratongan'ny lahatahiry ao amin'ny rafi-drakitra dia mamerina tanteraka ny ambaratongan'ny nodes ao amin'ny tetikasa. Ohatra, script toy ny:
Sarintany amin'ity rafitra manaraka ity ny rafi-drakitra (ny ambaratongan'ny lahatahiry ihany no aseho, fa mazava ny fotony)
Manamora ny fizotry ny famerenana ny tetikasa izany.
Import avy amin'ny Postman
Rehefa avy namaky ireo rehetra voalaza etsy ambony ireo ny mpampiasa sasany dia te-hanandrana (sa tsy izany?) vokatra vaovao na (inona no tsy mampihomehy!) hampiasa izany tanteraka amin'ny tetikasany. Na izany aza, ny fifindra-monina dia azo sakanana amin'ny fivoarana marobe amin'ny Postman iray ihany. Ho an'ny tranga toy izany, TestMace dia manohana ny fanafarana fanangonana avy amin'ny Postman. Amin'izao fotoana izao, ny fanafarana tsy misy andrana dia tohanana, saingy tsy manilika ny fanohanana azy ireo amin'ny ho avy.
Plans
Manantena aho fa maro amin'ireo izay namaky hatramin'izao no nankafy ny vokatray. Tsy izay ihany anefa! Mandeha ny asa amin'ny vokatra ary ireto misy endri-javatra sasany kasainay hampidirina tsy ho ela.
Cloud synchronization
Iray amin'ireo endri-javatra angatahina indrindra. Amin'izao fotoana izao, manolotra ny fampiasana rafitra fanaraha-maso ny dikan-teny ho an'ny fampifanarahana, izay mahatonga ny endrika ho sariaka kokoa ho an'ity karazana fitahirizana ity. Na izany aza, tsy mety amin'ny olon-drehetra ity rindranasa ity, noho izany dia mikasa ny hanampy mekanika fampifanarahana mahazatra amin'ny maro amin'ny alàlan'ny lohamilinay izahay.
CLI
Araka ny voalaza etsy ambony, ny vokatra IDE-level dia tsy afaka manao raha tsy misy ny karazana fampidirana rehetra amin'ny fampiharana na ny workflows efa misy. Ny CLI no tena ilaina mba hampidirana ny fitsapana voasoratra ao amin'ny TestMace amin'ny dingana fampidirana mitohy. Mandeha tanteraka ny asa amin'ny CLI; Ny dikan-teny voalohany dia hanomboka ny tetikasa miaraka amin'ny tatitra console tsotra. Amin'ny ho avy dia mikasa ny hampiditra tatitra amin'ny endrika JUnit izahay.
rafitra plugin
Na eo aza ny herin'ny fitaovantsika rehetra, tsy misy fetra ny andiana tranga mitaky vahaolana. Rehefa dinihina tokoa, dia misy asa izay manokana amin'ny tetikasa manokana. Izany no antony amin'ny ho avy dia mikasa ny hanampy SDK ho an'ny famolavolana plugins ary ny developer tsirairay dia afaka manampy fampiasa amin'ny tiany.
Manitatra ny isan'ny karazana node
Tsy mandrakotra ny tranga rehetra takian'ny mpampiasa ity andiana node ity. Nodes izay kasaina ampiana:
- Node Script - manova sy mametraka angona amin'ny fampiasana js sy ny API mifanaraka aminy. Amin'ny fampiasana an'io karazana node io, azonao atao ny manao zavatra toy ny sora-baventy mialoha sy aorian'ny fangatahana ao amin'ny Postman.
- GraphQL node - fanohanana graphql
- Node fanamafisam-peo manokana - dia ahafahanao manitatra ny andiana fanambarana efa misy ao amin'ny tetikasa
Mazava ho azy fa tsy lisitra farany ity; havaozina tsy tapaka izany noho ny zavatra hafa, ny valin-teninao.
FAQ
Inona no maha samy hafa anao amin'ny Postman?
- Ny foto-kevitry ny nodes, izay ahafahanao manefa tsy misy farany ny fiasan'ny tetikasa
- Endriky ny tetikasa mora vakin'ny olombelona miaraka amin'ny fitehirizana azy ao anaty rafitra fichier, izay manamora ny asa amin'ny alàlan'ny rafitra fanaraha-maso ny dikan-teny
- Fahaizana mamorona fitsapana tsy misy fandaharana sy fanohanana js mandroso kokoa amin'ny tonian-dahatsoratra fitsapana (autocompletion, static analyzer)
- Autocompletion mandroso sy fanasongadinana ny sandan'ny variables ankehitriny
Vokatra misokatra ve ity?
Tsia, amin'izao fotoana izao dia mikatona ny loharanom-baovao, fa amin'ny ho avy dia mandinika ny mety hanokafana ny loharano
Inona no fiainanao?)
Miaraka amin'ny dikan-teny maimaim-poana, mikasa ny hamoaka dikan-karama amin'ny vokatra izahay. Anisan'izany ny zavatra mitaky lafiny mpizara, ohatra, ny fampifanarahana.
famaranana
Ny tetikasanay dia mandroso tsikelikely mankany amin'ny famoahana stable. Na izany aza, ny vokatra dia efa azo ampiasaina, ary ny fanehoan-kevitra tsara avy amin'ny mpampiasa voalohany dia manaporofo izany. Mazoto manangona hevitra izahay, satria raha tsy misy fiaraha-miasa akaiky amin'ny fiarahamonina dia tsy azo atao ny manamboatra fitaovana tsara. Afaka mahita anay eto ianao:
Manantena ny fanirianao sy ny soso-kevitrao izahay!
Source: www.habr.com