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

Разделяне на възли

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

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

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

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

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

Какво дава това на потребителя? То позволява много гъвкава промяна на работния поток на екипа, използвайки познатите подходи. Например, разработчиците могат да съхраняват проекта в същия репозиторий, в който е и backend. В клоновете, освен промените в кодовата база, разработчикът може да коригира съществуващите сценарии за заявки и тестове. След фиксирането на промените в репозитория (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 има script узел, който покрива този сценарий. За да възпроизведете предишния случай, но вече в изпълнение на 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) в параметрите посочете линка към скрипта, създаден на първата стъпка

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

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

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

• По-голям контрол над обхвата на видимост на променливите. Най-малкия обхват, в който може да се определи променлива в Postman, е колекция. TestMace позволява да се определят променливи за всяка заявка или папка. В Postman Share колекция позволява експортиране само на колекции, докато в 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