Make it simple?

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

Quant à Java Language Specification (JLS) et Java Virtual Machine Specification (JVM), ils sont écrits dans FrameMaker. SPEC est ensuite exporté au format HTML et PDF. Le balisage est incorporé dans la version html. Mon avis est que l'information de balisage doivent être placés dans (ou en relation avec) le texte d'origine. Dans notre cas, il est FrameMaker document. Je ne suis pas sûr que ce soit possible à tous, mais je le devine. 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 des spécifications de l'auteur avec l'équipe tck devrait balisage affirmations tous chenged et nouveaux. Je dirais que le mieux est quand l'écriture spec et les processus de balisage sont fait à la fois. 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 Print This Post

Assertion coloriage

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 l'essai à l'affirmation selon laquelle elle essais.
Commençons par les points suivants:
- L'affirmation est marqué
- L'affirmation réelle est difficile à voir dans la spécification (actuellement il n'y a que gif affirmation petit à la fin de chaque assertion)
- Compléter les affirmations ne sont que consultés par la lecture du HTML directement ou regarder d'essai, chaque individu
- Début des affirmations sont difficiles à voir dans le code html
- Fournir un moyen visuel pour voir l'affirmation est de loin le problème auquel nous tentons de résoudre.

Le point principal est de colorer les assertions (texte spécification elle-même) en utilisant des balises HTML. Les recherches ont été faites qui balises HTML à utiliser. Div, span, table et des balises de polices ont été examinés. La meilleure solution est la balise de police. Donc, le texte est entouré de balises. L'attribut de classe de la balise de police correspond au type de l'assertion. Fe si le asserion est nouveau il se colore de 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 une utilité (ou d'un programme java script) pour numériser balisé spécification et d'ajouter automatiquement les balises nécessaires pour la coloration. La couleur de fond du texte sera déterminé par la couleur du titre attribut de l'assertion. Cette méthode a été mis en œuvre et fonctionne bien. Aux fins de la facilité d'utilisation, il devrait y avoir un mécanisme pour cacher coloriage, fe un javascript.

Un inconvénient de cette solution est que la couleur est statique, car elle est fondée sur l'attribut titre. Une deuxième solution serait que l'outil permettrait de vérifier s'il ya une existence d'un test (basé sur l'ID de l'affirmation ou un lien dans l'affirmation). Si un test existe, 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 basée sur le moment où l'utilisateur d'exécuter des scripts.

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

Voici quelques exemples de chapitres JLS3 «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 SPEC, ils n'ont pas été modifiés et les essais mise à jour n'est pas nécessaire - la couleur est l'aigue-marine (vert neurtal). Conv155 et conv156 sont nouveaux, de nouveaux tests devraient être développés, les assertions sont colorées en rouge flagrant. Conv064 a été changé, mise à jour de test est nécessaire - couleur orange. Annot019 est nouvelle, les tests existent, mais elles sont nécessaires pour être changé - de couleur saumon. Annot020 est nouveau, mais кудумфте tests existent - de couleur vert clair.

Le principal avantage de la coloration spec est que le SPEC est visualisée. L'utilisateur peut voir l'affirmation entier et son titre. On peut dire en regardant les spec, où il ya des régions où la couverture est faible et où certains lots ou des tests devraient être ajoutées ou modifiées. Il est fondamentalement la possibilité de voir comment un spec est balisé et à quel point il est testé.




  • Share / Bookmark
Print This Post Print This Post

Balisage des métadonnées

11 Markup metadata La définition la plus simple des métadonnées est que ce sont les données sur les données. Métadonnées peuvent être très utiles. En ce qui concerne le balisage il y avait certaines métadonnées intégrées: id, petite description de l'affirmation, lien vers le test. 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:

  • Old:
    non-changé le texte, les tests ne nécessite pas de modifications;
  • oldToBeChanged:
    texte modifié, les tests n'ont pas besoin d'être changé;
  • neuf:
    totalement nouveau texte, de nouveaux tests nécessaires;
  • newWritten:
    nouveau texte, mais les tests existent déjà (parce que le processus d'élaboration de tests ont commencé dès que les spécifications du projet est disponible);
  • newWrittenToBeChanged:
    nouveau texte, des tests existent, spéc projet de changé, donc les tests doivent être modifiés ou les 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 l'un spec peut facilement dire si d'autres tests sont nécessaires ou plusieurs devraient être mis à jour.

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

name=assertionID> <a <! - shord description comme commentaire html ->
l'affirmation de déclaration ici
src="pics/assert.gif"> <img <a href="path à test" title=assertType> test ID qui est la même que l'affirmation ID </ 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 Print This Post