Здравейте на всички, на линия съм TestMace! Възможно е много от вас да ни знаят от нашите предишни статии статии. За тези, които се присъединяват сега: ние разработваме IDE за работа с API на TestMace. Най-често задаваният въпрос при сравняването на TestMace с конкурентни продукти е „С какво се различавате от Postman?“. Решихме, че е време да дадем изчерпателен отговор на този въпрос. По-долу описахме нашите предимства спрямо Postman.

Разделяне на узли

Ако работите с Postman, знаете, че интерфейсът на заявката съдържа всичките необходим функционал. Тук има и скриптове, и тестове, и самите заявки. Това улеснява работата на новак, но при големи сценарии такъв подход не е гъвкав. Какво ако искате да създадете няколко заяви и да направите агрегация по тях? Какво ако искате да изпълните скрипт без заявка или няколко логически разделени скрипта подред? В крайна сметка, не би било лошо да отделите тестовете от обикновените утилитарни скриптове. Освен това, подходът „добавяме целия функционал в един узел“ не е мащабируем — интерфейсът бързо става претоварен.

TestMace първоначално разделя целия функционал на различни типове узли. Искате да направите заявка? Ето ви request step узел. Искате да напишете скрипт? Ето ви скрипт узел. Нужни са ви тестове? Моля — Assertion узел. Ах да, можете да опаковате всичко това в folder узел. И всичко това лесно се комбинира. Такъв подход не само е много гъвкав, но и, в съответствие с принципа на единствената отговорност, позволява да използвате само това, от което наистина се нуждаете в момента. Защо ми трябват скриптове и тестове, ако просто искам да направя заявка?

Човешко четим формат на проекта

Между TestMace и Postman има концептуално различие в начина на съхранение. В Postman всички заявки се съхраняват някъде в локалното хранилище. Ако е необходимо да споделите заявки между няколко потребителя, трябва да използвате вградена синхронизация. Всъщност това е общоприет подход, не лишен от недостатъци. Какво е положението със сигурността на данните? Политиката на някои компании може да не позволява съхраняване на данни при трети лица. Въпреки това смятаме, че TestMace може да предложи нещо по-добро! И името на това подобрение е „човешко четим формат на проекта“.

Започваме с това, че в TestMace в принципе съществува понятието "проект". И приложението е разработвано в началото с насоченост към съхраняване на проекти в системи за контрол на версиите: дървото на проекта практически се проектира буквално върху файловата структура, а за формат на съхранението се използва yaml (без излишни скобки и запетаи), а файловото представяне на всеки възел е детайлно описано в документацията с коментари. Но в повечето случаи няма да се налага да поглеждате там — всички имена на полета имат логични наименования.

Какво дава това на потребителя? То позволява много гъвкаво изменение на работния поток на екипа, ползвайки познати подходи. Например, разработчиците могат да съхраняват проекта в същото хранилище, в което е и бекендът. В клоновете, освен промените в самата кодова база, разработчикът може да коригира съществуващите сценарии на заявки и тестове. След фиксиране на промените в хранилището (git, svn, mercurial — каквото ви харесва) CI (вашата любима, невменена) стартира нашата конзолна утилита testmace-cli, а полученият след изпълнение отчет (например, във формат junit, който също се поддържа в testmace-cli) се изпраща в съответната система. Да и въпросът, посочен по-горе, с безопасността вече не е проблем.

Както виждате, TestMace не натрапва своята екосистема и парадигма. Вместо това той лесно се интегрира в вече утвърдени процеси.

Динамични променливи

TestMace следва концепцията no-code: ако проблемът може да се реши без използване на код, ние се стараем да дадем такава възможност. Работа с променливи е точно онази функционалност, при която в повечето случаи може да се мине без програмиране.

Пример: получихме отговор от сървъра и искаме да запазим част от отговора в променлива. В Postman бихме написали в тестовия скрипт (което само по себе си е странно) нещо от сорта на:

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

Но според нас, написването на скрипт за толкова прост и често срещан сценарий изглежда излишно. Затова в TestMace имате възможност да присвоите на променливата част от отговора, използвайки графичен интерфейс. Вижте колко е просто:

И сега, при всяко искане, тази динамична променлива ще бъде обновявана. Но може да възразите, аргументирайки, че подходът на Postman е по-гъвкав и позволява не само да се направи присвояване, но и да се извърши предварителна обработка. Ето как можете да модифицирате предишния пример:

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

Както и да е, за това в TestMace има скрипт възел, който покрива този сценарий. За да възпроизведете предишния случай, но в изпълнение на TestMace, е необходимо след искането да създадете script възел и да използвате следния код като скрипт:

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

Както виждате, композицията на възлите и тук оказа добър ефект. А за толкова прост случай, какъвто е описан по-горе, можете дори просто да присвоите израза ${crypto.MD5($response.data)} на променливата, създавана чрез графичния интерфейс!

Създаване на тестове чрез GUI

Postman позволява да създавате тестове чрез написване на скриптове (в случая на Postman това е JavaScript). Този подход има множество предимства — практически неограничена гъвкавост, наличието на готови решения и т.н.

Въпреки това, реалността често е такава (не сме ние, животът е такъв), че тестовият специалист не разполага с умения за програмиране, а би искал да носи полза на екипа още сега. За такива случаи, следвайки концепцията за no-code, TestMace позволява създаването на прости тестове чрез графичния интерфейс, без да е необходимо написването на скриптове. Ето как изглежда процесът на създаване на тест, който сравнява стойности за равенство:

Но създаването на тестове в графичния редактор не отменя възможността да се пишат тестове в код. Тук са същите библиотеки, които са и в script възела, и chai за написване на тестове.

Възможността за изпълнение на вече съществуващ сценарий по връзка (Link възел)

Често възникват ситуации, когато определено искане или дори целия сценарий трябва да бъде изпълнен няколко пъти в различни части на проекта. Пример за такива искания може да служи кастомната многоетапна автентикация, приведението на средата в нужното състояние и т.н. Общо казано, ако говорим на термините на програмирането, бихме искали да имаме функции, които могат да бъдат преизползвани в различни части на приложението. В TestMace тази функция се изпълнява от link Възел. Използването му е много просто:
1) създайте заявка или сценарий
2) създайте възел от тип Link
3) в параметрите посочете линка към сценария, създаден на първата стъпка

В по-напреднал вариант можете да посочите кои динамични променливи от сценария да предавате на по-високо ниво относно линка. Звучи сложно? Да предположим, че сме създали Folder с име create-post, в който на този възел се назначава динамична променлива postId. Сега в Link възела create-post-link можете явно да посочите, че променливата postId да се назначи на предка create-post-link. Този механизъм (отново, да се изразим програматорски) може да се използва за връщане на резултата от „функция“. В общи линии е готино, DRY в пълен ръст и отново нито един ред код не пострада.

Що се отнася до Postman, искането за повторно използване на заявки виси от 2015 година, и изглежда дори има някои намеци, че работят над този проблем. В сегашния си вид Postman наистина има възможност за смяна на потока на изпълнение, което в теорията, вероятно, позволява да се реализира подобно поведение, но това е по-скоро мръсен хак, отколкото наистина работещ подход.

Други разлики

• По-голям контрол над областта на видимост на променливите. Най-малкия обхват, в който може да се определи променлива в Postman, е колекция. TestMace позволява да се определят променливи за всяка заявка или папка. В Postman споделяне на колекция позволява експорт само на колекции, докато в TestMace споделянето работи за всеки възел.
• TestMace поддържа наследявани заглавия, които по подразбиране могат да се добавят в дочерни заявки. В Postman по този въпрос има задача, и тя дори е затворена, но като решение се предлага… да се използват скриптове. В TestMace всичко това се конфигурира чрез GUI и има възможност за опционално изключване на наследяваните заглавия в конкретни потомци.
• Undo/Redo. Работи не само при редактиране на възли, но и при премахване, изместване, преименуване и други операции, които променят структурата на проекта.
• Файловете, прикрепени към заявките, стават част от проекта и се съхраняват заедно с него, докато прекрасно се синхронизират, за разлика от Postman. (Да, вече не е необходимо всеки път ръчно да избирате файлове при всяко стартиране и да ги предавате на колеги в архиви)

Функции, които вече са на път

Не можахме да устоим на изкушението да разкрием завесата на предстоящите версии, особено когато функционалността е много привлекателна и вече преминава през предизвикателна финална обработка. И така, запознайте се.

Функции

Както е известно, за генериране на стойности в Postman се използват т.нар. динамични променливи. Списъкът им е внушителен и преобладаващото мнозинство функции служат за генериране на фалшиви стойности. Например, за генериране на произволен имейл е необходимо да напишете:

{{$randomEmail}}

Въпреки това, тъй като това са променливи (да, и динамични), те не могат да се използват като функции: те не са параметризируеми, следователно вземането на хеш от стринга не е възможно.

В TestMace планираме да добавим "честни" функции. В самите ${} ще можете не само да се позовете на променлива, но и да извикате функция. Тоест, ако трябва да генерирате прословутия фалшив имейл, просто ще напишем

${faker.internet.email()}

Освен че е функция, можете да забележите, че има възможност за извикване на метод на обект. И вместо голям плосък списък от динамични променливи, имаме набор от логично групирани обекти.

А какво ако искаме да изчислим хеш от стринг? Лесно!

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

Можете да забележите, че като параметри дори можете да предавате променливи! В този момент внимателният читател може да заподозре нещо странно...

Използване на JavaScript в изразите

... И не без основание! Когато бяха формулирани изискванията към функциите, стигнахме до заключението, че в изразите трябва да можем да пишем валиден JavaScript. Затова сега можете свободно да пишете изрази в духа на:

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

И всичко това без скриптове направо в полетата за въвеждане!

Що се отнася до Postman, там можете само да използвате променливи, и при опит да напишете някакво изразително изразяване, валидаторът се оплаква и отказва да го изчисли.

Развито автоматично допълване

В момента TestMace предлага стандартно автоматично допълване, което изглежда по следния начин:

Тук освен автоматично допълваната стринг, се посочва какво представлява съответната стринг. Този механизъм работи само в изрази, обрамчени в скоби ${}.

Както може да се забележи, добавени са визуални маркери, които указват типа на променливата (например, низ, число, масив и т.н.). Освен това можете да променяте режимите на автозавършване (например, можете да изберете автозавършване с променливи или заглавия). Но дори и това не е най-важното!

На първо място, автозавършването работи дори в изрази (където е възможно). Ето как изглежда:

И на второ място, сега автозавършването е достъпно и в скриптове. Вижте как работи!

Няма смисъл да сравняваме този функционал с Postman — там автозавършването е ограничено само до статични списъци с променливи, заглавия и техните стойности (поправете ме, ако съм забравил нещо). Скриптовете не се автозавършват 🙁

Заключение

През октомври измина една година от началото на разработката на нашия продукт. През това време успяхме да направим много неща и по някои параметри настигнахме нашите конкуренти. Но все пак, нашата цел е да създадем наистина удобен инструмент за работа с API. Имаме още много работа, ето примерен план за развитие на проекта ни през следващата година: https://testmace.com/roadmap.

Вашият фидбек ще ни помогне да се ориентираме по-добре в изобилието от функции, а вашата подкрепа ни дава сили и увереност, че правим правилното нещо. Случи се така, че днес е важен ден за нашия проект — денят на публикуване на TestMace на ProductHunt. Моля, подкрепете нашия проект, това е много важно за нас. Особено, защото на нашата PH страница днес има примамливо предложение, което е ограничено.

Източник: habr.com