Assertion colorier

rainbow Assertion coloring l'élaboration de tests de conformité consiste à identifier les affirmations contenues dans un cahier des charges, l'écriture des tests de conformité qui vérifient les assertions identifiés et reliant le test à l'affirmation selon laquelle il teste.
Commençons par les points suivants:
- L'affirmation est marquée
- L'affirmation réelle est difficile de voir dans les spécifications (actuellement il n'y a que l'affirmation de petit gif à la fin de chaque affirmation)
- Assertions complète ne sont consultés par la lecture du html directement ou regarder chaque test
- Début de la affirmations sont difficiles à voir dans le code html
- Fournir un moyen visuel pour afficher l'affirmation est facilement le problème que nous tentons de résoudre.

Le point principal est de couleur les assertions (texte spécification elle-même) en utilisant des balises HTML. La recherche a été faite qui balises HTML à utiliser. Div, span, table et balises de police ont été examinées. La meilleure solution est la balise de police. Ainsi, le texte est entouré de balises de police. L'attribut class de la balise de police correspond au type de l'affirmation. Fe si le asserion est nouveau, il est de couleur rouge, pour indiquer que les tests doivent être écrites, les affirmations anciennes sont colorés en vert pour indiquer que les tests existent déjà. Il devrait y avoir un utilitaire (script ou un programme java) pour balayer marqué cahier des charges et d'ajouter automatiquement les balises nécessaires pour la coloration. La couleur de fond du texte sera déterminé par la couleur attribut title de l'affirmation. Cette méthode a été appliquée et fonctionne correctement. Aux fins de facilité d'utilisation, il devrait y avoir un mécanisme pour cacher les colorants, Fe un javascript.

Un inconvénient de cette solution est que la couleur est statique car elle est basée sur l'attribut title. Une deuxième solution serait que l'outil vérifier une existence d'un test (basé sur l'ID affirmation ou un lien dans l'affirmation). Si il existe un test, nous ferions quelque chose pour régler la couleur de cette affirmation. Il pourrait être aussi simple que la fixation d'un attribut title. Un inconvénient de cette solution serait que la coloration affirmation serait encore statique, mais sur la base lorsque l'utilisateur exécuter les scripts.

Une variante de la solution donnée est que nous générer dynamiquement les données de couverture lorsque la spécification est visualisé dans un navigateur. Nous déterminer si un test existe dans le répertoire de test pour une affirmation donnée et la couleur l'affirmation en conséquence. Cela pourrait se faire grâce à un javascript / vbscript en utilisant des objets, qui permettent l'accès aux systèmes de fichiers. Cette méthode serait dynamique et devrait toujours avoir le dernier état affirmation de couverture.

Voici quelques exemples de JLS3 chapitres "Conversions et promotions" et "interfaces":

JLS3 colored Assertion coloring

JLS3 colored2 Assertion coloring

Assertions conv063, conv047, conv065, conv48, conv66 et conv049 sont de la version précédente de la spécification, ils n'ont pas été modifiées et mise à jour des tests n'est pas nécessaire - de couleur aigue-marine est (vert neurtal). Conv155 et conv156 sont nouveaux, de nouveaux tests devraient être développés, les affirmations sont colorés en rouge éclatante. Conv064 a été modifié, mise à jour de test est nécessaire - de couleur orange. Annot019 est un nouveau, des tests existent, mais ils sont nécessaires pour être changé - couleur saumon. Annot020 est nouveau, mais кудумфте tests existent - de couleur vert clair.

Le principal avantage de la coloration spec est que la spécification est visualisé. L'utilisateur peut voir l'affirmation entier et son titre. On peut dire en regardant les spécifications, où il ya des zones où la couverture est faible et où certains lots ou des tests devraient être ajoutés ou modifiés. Il est essentiellement la possibilité de voir à quel point une spécification est marqué et la façon dont il est testé.



, , , , , , ,
  • Share / Bookmark
Print This Post Imprimer cet article

métadonnées Markup

11 Markup metadata La définition la plus simple de métadonnées, c'est que ce sont les données sur les données. Les métadonnées peuvent être très utiles. En ce qui concerne le balisage y avait une certaine métadonnées intégrées: id, petite description de l'affirmation, le lien pour tester. Pendant le transfert de balisage, j'ai réalisé que plus de métadonnées serait très utile. Dans la nouvelle version de la spécification, il y avait plusieurs sortes d'affirmations:

  • anciens:
    texte non-changé, les tests n'ont pas besoin de tout changement;
  • oldToBeChanged:
    texte modifié, les tests ne doivent être modifiées;
  • nouvelles:
    totalement nouveau texte, de nouveaux tests nécessaires;
  • newWritten:
    nouveau texte, mais les tests existent déjà (parce que le processus d'élaboration d'essai a commencé dès que les spécifications du projet de disposition);
  • newWrittenToBeChanged:
    nouveau texte, des tests existent, spec projet changé, les tests doivent être modifiées ou des tests existants ne suffisent pas.

L'ajout de ce type de données en langage de balisage simplifierait grandement les travaux futurs - le développement d'essai. Parce que, tout en regardant une assertion dans le spec peut facilement dire si d'autres tests sont nécessaires ou plusieurs devraient être mis à jour.

Avec la donnée architecture balisage est a été décidé d'utiliser l'attribut title dans la balise href (la deuxième ancre). Ainsi, le balisage ressemblerait à ceci:

<a name=assertionID> <! - description shord en commentaire html ->
déclaration affirmation ici
<img href="path <a src="pics/assert.gif"> à title=assertType> ID test test" qui est le même que l'affirmation d'identité </ a>

L'attribut title peut être visualisé dans un navigateur comme un indice.

JLS3 html Markup metadata

JLS3 html code Markup metadata



, , , , , , , , , ,
  • Share / Bookmark
Print This Post Imprimer cet article

Markup transfert - cauchemar ou un morceau de gâteau?

train Markup transfer   nightmare or a piece of cake?
L'ensemble du processus de création d'un balisage et le développement de tests prend du temps. Et quand il semble que le travail est fait, une nouvelle version du spec est libéré. Qu'est-ce qui se passe ensuite? Bien sûr, il ya un besoin d'une nouvelle version de la suite de test. De nouveaux tests doivent être écrites et les anciennes mises à jour ou même supprimé.

La meilleure façon de commencer est de faire le balisage. Cette tâche peut être divisée en deux sous-groupes:

  • transfert de balisage vieux de la spec précédente à la nouvelle spécification (ceci est nécessaire car de nombreux tests ont déjà été écrites, elles sont liées à id Spec, en réutilisant tous les tests possibles, c'est une bonne idée);
  • balisage et de nouvelles affirmations mise à jour.

Transférer le balisage est assez simple de le faire à la main:

  1. Recherchez la balise de balisage dans les spécifications du vieux.
  2. Trouver le meilleur endroit pour insérer la balise dans la nouvelle version de la spécification.
  3. Insérez la balise.

Si il ya seulement 10 affirmations - ce travail est un morceau de gâteau. Mais si il ya des milliers C'est un travail dur qui doit être automatisée. Le plus difficile est de trouver un nouveau lieu approprié pour des balises. Il est difficile de simplement parce que la spécification a été modifiée. Pour JLS2 au processus de migration JLS3 l'alrorithm flollowing a été utilisée:

Chaque affirmation est arrondie avec des ancres HTML. Deux d'entre eux devraient être transférés en utilisant l'algorithme tel.

Hin 1T: si certains tag est transféré, il ya une grande possibilité, cette balise suivante dans Spec ancienne sera placé après celui qui est transféré.

Astuce 2: algorithme doit vérifier que la deuxième ancre doit être placé après la première et pas trop loin de là.

  1. Regardez le texte avant et après la balise dans Spec vieux. Trouver dans les spécifications du nouveau. Si l'un d'eux 72s Markup transfer   nightmare or a piece of cake? a pas changé - la réponse est trouvée. habituellement la longueur devrait être 1-2 sentances, au moins 60 caractères. Si aucune ou plusieurs sentances trouvées - sauter cette étape.
  2. Essayez de faire les mêmes que dans (1), mais supprimer toutes les balises HTML du texte qui entoure près de la balise. Si aucun trouvées - sauter cette étape.
  3. Essayez d'adopter l'algorithme, qui essaye de trouver un texte semblable dans les spécifications du nouveau.
    un fichier. Suivez les étapes (1) et (2), mais desrease la durée de la recherche de texte dans une boucle jusqu'à ce que la phrase se trouve ou la durée est trop courte. Le travail pratique a montré que ce nombre ne devrait pas être inférieure à 20.
    b. Si les étapes (1) et (2), ou (3a) ont trouvé plusieurs sentances augmenter la longueur du texte à la recherche jusqu'à ce que le texte se trouve dans la spécification de nouvelles ou de la limite supérieure (Fe 140 caractères) est atteint. Utilisez des conseils pour trouver le meilleur texte correspondant.

Adopter algorithme pourrait être utilisé à la fois en ignorant les balises HTML et profiter d'eux. Algorithme est valable pour les spécifications écrites en texte brut, HTML ou XML.

Cet algorithme a été mis en œuvre dans JLS2-> outil de marquage transfert JLS3. 84% des balises ont été transférés automatiquement. Le reste d'entre eux ont été effectuées manuellement.



, , , , , ,
  • Share / Bookmark
Print This Post Imprimer cet article