Bonjour à tous, ici TestMace! Il est possible que beaucoup d'entre vous nous connaissent grâce à nos précédentes articles. Pour ceux qui viennent de nous rejoindre : nous développons un IDE pour travailler avec l'API TestMace. La question la plus posée lors de la comparaison de TestMace avec des produits concurrents est : « En quoi êtes-vous différent de Postman ? ». Nous avons décidé qu'il était temps de donner une réponse développée à cette question. Ci-dessous, nous avons listé nos avantages par rapport à Postman.

Division en nœuds

Si vous travaillez avec Postman, vous savez que l'interface de la requête contient toutes les fonctionnalités nécessaires. Il y a des scripts, des tests et, bien sûr, les requêtes elles-mêmes. Cela simplifie le travail pour les débutants, mais pour de grands scénarios, cette approche n'est pas flexible. Que faire si vous souhaitez créer plusieurs requêtes et faire de l'agrégation dessus ? Que faire si vous voulez exécuter un script sans requête ou plusieurs scripts logiquement séparés en série ? Au final, il serait bon de séparer les tests des scripts utilitaires ordinaires. De plus, l'approche « ajouter toutes les fonctionnalités dans un seul nœud » n'est pas évolutive - l'interface devient rapidement surchargée.

TestMace divise initialement toutes les fonctionnalités en différents types de nœuds. Vous voulez faire une requête ? Voici un nœud de requête. Vous voulez écrire un script ? Voici un script nœud. Besoin de tests ? Pas de problème - Assertion nœud. Ah oui, vous pouvez également envelopper tout cela dans un dossier nœud. Et tout cela s'assemble facilement ensemble. Cette approche est non seulement très flexible, mais également conforme au principe de responsabilité unique, permettant d'utiliser seulement ce dont vous avez vraiment besoin à l'instant. Pourquoi ai-je besoin de scripts et de tests si je veux simplement faire une requête ?

Format lisible par l'homme pour le projet

Il existe une différence conceptuelle entre TestMace et Postman concernant la manière de stocker. Dans Postman, toutes les requêtes sont stockées quelque part dans un stockage local. Si vous devez partager des requêtes entre plusieurs utilisateurs, il faut utiliser la synchronisation intégrée. En réalité, c'est une approche courante, mais elle n'est pas sans défauts. Qu'en est-il de la sécurité des données ? La politique de certaines entreprises peut ne pas permettre de stocker des données chez des tiers. Cependant, nous pensons que TestMace peut offrir quelque chose de mieux ! Et cet amélioration, c'est le « format lisible par l'homme du projet ».

Commençons par le fait qu'il existe en principe une entité "projet" dans TestMace. L'application a été initialement conçue pour stocker des projets dans des systèmes de contrôle de version : l'arborescence du projet est pratiquement projetée un à un sur la structure de fichiers, le format de stockage utilisé est le yaml (sans crochets ni virgules superflus), et la représentation des fichiers de chaque nœud est détaillée dans la documentation avec des commentaires. Mais dans la plupart des cas, vous ne serez pas amené à y jeter un œil — tous les noms de champs ont des désignations logiques.

Que cela apporte-t-il à l'utilisateur ? Cela permet de modifier très flexiblement le flux de travail de l'équipe, en utilisant des approches familières. Par exemple, les développeurs peuvent stocker le projet dans le même référentiel que le backend. Dans les branches, en plus de modifier directement la base de code, le développeur peut corriger les scénarios de requêtes existants et les tests. Après avoir validé les modifications dans le référentiel (git, svn, mercurial — ce que vous préférez), CI (votre outil préféré, non imposé par personne) lance notre utilitaire en ligne de commande testmace-cli, et le rapport généré après exécution (par exemple, au format junit, qui est également pris en charge par testmace-cli) est envoyé au système correspondant. De plus, la question mentionnée ci-dessus concernant la sécurité n'est plus un problème.

Comme vous pouvez le voir, TestMace n'impose pas son écosystème et sa paradigme. Au lieu de cela, il s'intègre facilement dans des processus déjà établis.

Variables dynamiques

TestMace suit le concept no-code : si un problème peut être résolu sans utiliser de code, nous essayons de donner cette possibilité. Travailler avec des variables est exactement cette fonctionnalité où, dans la plupart des cas, on peut se passer de programmation.

Exemple : nous avons reçu une réponse du serveur, et nous souhaitons sauvegarder une partie de la réponse dans une variable. Dans Postman, nous aurions écrit dans le script de test (ce qui est en soi étrange) quelque chose comme :

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

Mais à notre avis, écrire un script pour un scénario aussi simple et souvent utilisé semble excessif. C'est pourquoi dans TestMace, il est possible d'assigner une partie de la réponse à une variable en utilisant l'interface graphique. Regardez comme c'est simple :

Et maintenant, à chaque requête, cette variable dynamique sera mise à jour. Mais vous pourriez contester cela en argumentant que l'approche de Postman est plus flexible et permet non seulement de faire une affectation, mais également d'exécuter un certain prétraitement. Voici comment modifier l'exemple précédent :

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

Eh bien, pour cela, TestMace dispose d script un nœud qui couvre ce scénario. Pour reproduire le cas précédent, mais déjà dans l'exécution de TestMace, il est nécessaire de créer un nœud script après la requête et d'utiliser le code suivant comme script :

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

Comme vous pouvez le voir, la composition des nœuds a encore été utile ici. Et pour un cas aussi simple que celui décrit ci-dessus, vous pouvez même simplement affecter l'expression ${crypto.MD5($response.data)} à une variable créée via l'interface graphique !

Création de tests via l'IU

Postman permet de créer des tests en écrivant des scripts (dans le cas de Postman, c'est du JavaScript). Cette approche présente de nombreux avantages : flexibilité presque illimitée, disponibilité de solutions prêtes à l'emploi, etc.

Cependant, la réalité est souvent telle (ce n'est pas nous, c'est la vie) que le testeur n'a pas de compétences en programmation, et l'équipe aimerait apporter de la valeur immédiatement. Pour de tels cas, dans le cadre du concept no-code, TestMace permet de créer des tests simples via l'interface graphique, sans avoir besoin d'écrire des scripts. Voici, par exemple, à quoi ressemble le processus de création d'un test qui compare des valeurs pour l'égalité :

Cependant, la création de tests dans l'éditeur graphique n'annule pas la possibilité d'écrire des tests en code. Ici, toutes les mêmes bibliothèques que dans le nœud script, et chai pour écrire des tests.

Possibilité de lancer un scénario existant via un lien (nœud Link)

Il se présente souvent des situations où une certaine requête ou même un scénario entier doit être exécuté plusieurs fois dans différentes parties du projet. Un exemple de telles requêtes pourrait être une authentification personnalisée multi-étapes, la mise en état de l'environnement sur l'état souhaité, etc. En gros, pour parler en termes de langages de programmation, nous aimerions avoir des fonctions réutilisables dans différentes parties de l'application. Dans TestMace, cette fonction est remplie par lien Nœud. Son utilisation est très simple :
1) créez une requête ou un scénario
2) créez un nœud de type Lien
3) dans les paramètres, indiquez le lien vers le scénario créé à l'étape précédente

Dans une version plus avancée, vous pouvez spécifier quelles variables dynamiques du scénario doivent être transmises au niveau supérieur par rapport au lien. Cela semble compliqué ? Supposons que nous ayons créé un Dossier nommé create-post, à l'intérieur duquel une variable dynamique est assignée à ce nœud postId. Maintenant, dans le nœud Lien create-post-link , vous pouvez explicitement indiquer que la variable postId doit être assignée au parent create-post-link. Ce mécanisme (encore une fois, en termes de programmeur) peut être utilisé pour renvoyer un résultat de la « fonction ». En gros, c'est génial, DRY à son meilleur et aucune ligne de code n'a été blessée.

Concernant Postman, la demande d'ajout de la réutilisation des requêtes est en attente depuis 2015, et il semble même que certains indicesindiquent que ce problème est en cours de traitement. Dans sa forme actuelle, Postman a bien sûr la possibilité de changer le flux d'exécution, ce qui, en théorie, permet de réaliser un comportement similaire, mais c'est plutôt un hack sale qu'une véritable approche fonctionnelle.

Autres différences

• Un contrôle accru sur la portée des variables. La plus petite portée dans laquelle une variable peut être définie dans Postman est la collection. TestMace permet de définir des variables pour n'importe quelle requête ou dossier. Dans Postman, le partage de collection permet d'exporter uniquement des collections, tandis que dans TestMace, le partage fonctionne pour n'importe quel nœud.
• TestMace prend en charge les en-têtes hérités, qui peuvent par défaut être ajoutés aux requêtes enfants. Postman a quelque chose à ce sujet tâche, et cela a même été fermé, mais comme solution, il est proposé de… utiliser des scripts. Dans TestMace, tout cela est configuré via l'interface graphique et il est possible de désactiver les en-têtes hérités dans des descendants spécifiques.
• Annuler/Rétablir. Cela fonctionne non seulement lors de l'édition des nœuds, mais également lors du déplacement, de la suppression, du renommage et d'autres opérations modifiant la structure du projet.
• Les fichiers joints aux requêtes deviennent une partie intégrante du projet et sont stockés avec celui-ci, tout en se synchronisant parfaitement, contrairement à Postman. (Oui, il n'est plus nécessaire de sélectionner manuellement les fichiers à chaque exécution et de les transmettre aux collègues dans des archives.)

Des fonctionnalités qui arrivent bientôt

Nous n'avons pas pu résister à la tentation de lever un coin du voile sur les prochaines sorties, surtout lorsque les fonctionnalités sont vraiment séduisantes et déjà en cours de finition avant la sortie. Alors, accueillons-les.

Fonctions

Comme vous le savez, pour générer des valeurs dans Postman, on utilise ce qu'on appelle des variables dynamiques. La liste est impressionnante et la grande majorité des fonctions servent à générer des valeurs fictives. Par exemple, pour générer un e-mail aléatoire, il faut écrire :

{{$randomEmail}}

Cependant, étant donné qu'il s'agit de variables (même dynamiques), elles ne peuvent pas être utilisées comme des fonctions : elles ne sont pas paramétrables, donc il est impossible de prendre le hachage d'une chaîne.

Dans TestMace, nous prévoyons d'ajouter des fonctions « honnêtes ». Directement à l'intérieur de ${}, il sera possible non seulement d'accéder à une variable, mais aussi d'appeler une fonction. Ainsi, si nous voulons générer le fameux e-mail fictif, nous n'aurons qu'à écrire

${faker.internet.email()}

En plus d'être une fonction, il est intéressant de noter qu'il est possible d'appeler une méthode d'objet. Et au lieu d'une grande liste plate de variables dynamiques, nous avons un ensemble d'objets logiquement regroupés.

Et que faire si nous voulons calculer le hachage d'une chaîne ? C'est facile !

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

On peut noter qu'il est même possible de passer des variables en tant que paramètres ! À ce stade, le lecteur curieux pourrait suspecter quelque chose d'étrange…

Utilisation de JavaScript dans les expressions

… Et avec raison ! Lorsque les exigences des fonctions ont été formulées, nous avons soudain réalisé qu'il était nécessaire d'écrire un JavaScript valide dans les expressions. Donc maintenant, vous êtes libre d'écrire des expressions du genre :

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

Et tout cela sans scripts, directement dans les champs d'entrée !

En ce qui concerne Postman, il n'est possible d'utiliser que des variables, et lorsqu'on essaie d'écrire une expression correcte, le validateur se plaint et refuse de l'évaluer.

Autocomplétion avancée

À l'heure actuelle, TestMace dispose d'une autocomplétion standard qui ressemble à ceci :

Ici, en plus de la chaîne autocomplétée, il est indiqué à quoi cette chaîne appartient. Ce mécanisme ne fonctionne que dans les expressions entourées d'accolades ${}.

Comme vous pouvez le constater, des marqueurs visuels ont été ajoutés, indiquant le type de variable (par exemple, chaîne, nombre, tableau, etc.). Il est également possible de modifier les modes de saisie automatique (par exemple, on peut choisir l'autocomplétion avec des variables ou des en-têtes). Mais même cela n'est pas le point le plus important !

Tout d'abord, l'autocomplétion fonctionne même dans les expressions (là où c'est possible). Voilà à quoi cela ressemble :

Et deuxièmement, l'autocomplétion est maintenant également disponible dans les scripts. Regardez comment cela fonctionne !

Il est inutile de comparer cette fonctionnalité à Postman — là, l'autocomplétion est limitée à des listes statiques de variables, d'en-têtes et de leurs valeurs (corrigez-moi si j'ai oublié quelque chose). Les scripts ne sont pas autocomplétés 🙁

Conclusion

Octobre marque un an depuis le début du développement de notre produit. Pendant ce temps, nous avons pu réaliser beaucoup de choses et, sur certains paramètres, nous avons rattrapé nos concurrents. Quoi qu'il en soit, notre objectif est de créer un outil véritablement pratique pour travailler avec les API. Il nous reste encore beaucoup de travail à faire, voici un plan approximatif pour le développement de notre projet dans l'année à venir : https://testmace.com/roadmap.

Votre retour nous permettra de mieux nous orienter dans l'abondance de fonctionnalités, et votre soutien nous donne la force et la confiance que nous faisons quelque chose d'utile. Aujourd'hui est un jour important pour notre projet — le jour de la publication de TestMace sur ProductHunt. S'il vous plaît, soutenez notre projet, cela compte beaucoup pour nous. D'autant plus que sur notre page PH aujourd'hui, il y a une offre alléchante, et elle est limitée

Source : habr.com