Simplifiez-vous?

2plus2 Make it simple? Spécification est important - cette déclaration est clair pour tout le monde. Un produit largement utilisé, la technologie ou de la langue sans un cahier des charges est inutile. Un cahier des charges sans testsuite est dangereux. Une suite de tests, sans majoration et de tests est impossible. Ce processus est assez complexe. Toutefois, il existe des moyens de simplifier l'étape de balisage.

Quant à la spécification en langage Java (JLS) et Virtual Machine Java Specification (JVM) elles sont écrites dans FrameMaker. Ensuite spec est exporté au format HTML et PDF. Le balisage est intégré en version html. Mon opinion est que des informations de marquage doivent être placés dans (ou en relation avec) le texte d'origine. Dans notre cas, il s'agit d'un document FrameMaker. Je ne suis pas sûr que cela est possible à tous, mais je pense qu'il est. Si non, peut-être FrameMaker n'est pas la meilleure solution. En conséquence, nous permettra de réduire considérablement la quantité de temps et les efforts nécessaires pour le transfert de balisage ancien et le marquage de nouveau texte. En outre, durant l'écriture de la prochaine révision de la spécification de l'auteur avec l'équipe de tck devrait balisage tous les chenged et de nouvelles affirmations. Je dirais que la meilleure façon, c'est quand la rédaction de spécifications et les processus de balisage sont fait en même temps. Il est raisonnable pour l'auteur de souligner les développeurs à tester les états financiers qui doivent être testés.



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

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