7
votes

La documentation est-elle lisible par des non-programmeurs possibles avec Spock?

Fitessse a une fonction de documentation de style wiki. Il a fourni à la fois le code et la DOC pour ces tests de spécification.

Y a-t-il un moyen de passer à Spock (avec plug-in? / hors de la boîte?) Pour générer un type de documentation similaire à figurer aux gestionnaires / intervenants de projet, qui ne peut pas être censé lire le code source (Groovy) des spécifications de SPOCK.


0 commentaires

3 Réponses :


3
votes

SPOCK vous permet d'ajouter des descriptions à Blocks, E.G.:

when: "5 dollars are withdrawn from the account"
account.withdraw(5)

then: "3 dollars remain"
account.balance == 3

p> Nous n'utilisons pas encore cette information, il est facile d'accéder à partir d'une extension (voir le lien ci-dessous). Ce qui reste à faire est de transformer cela dans un bon rapport. P>

https://github.com/spockframework/spock-uberconf-2011/blob/master/src/test/groovy/extension/custom/reportextension.groovy a> p> p>


3 commentaires

J'utilise la fonctionnalité de commentaire et je me demandais comment cela est devenu une partie de la sortie. Merci Peter!


On dirait que les NFJS ont pris la pièce jointe du PPS que vous aviez là. Je ferai de googler sur la recherche des extensions et des rapports. Toute information add'l, vous pourrez peut-être fournir serait génial. Merci encore.


Le repo github que j'ai lié ci-dessus contient tout le matériel de ma dernière conversation, y compris les diapositives.



11
votes

Eh bien, j'ai utilisé les chaînes décrivant chaque bloc de SPOCK dans vos tests pour générer des rapports HTML. S'il vous plaît visitez mon projet et laissez-moi savoir si cela aide:

https://github.com/renatatatatatates/spock-reports

Vous pouvez télécharger le JAR à partir du répertoire Reports , puis il suffit de l'ajouter à votre parcours de classe. Exécutez vos tests et "miraculeusement" Vous aurez des rapports générés dans le répertoire Build / Spock-Rapports !

Vous pouvez même fournir vos propres fêtes de style CSS si vous souhaitez personnaliser les rapports, comme expliqué dans Readme.

Voici un blogpost j'ai écrit sur l'écriture de ce Extension de Spock.

mise à jour

Spock-Reports a été disponible sur Maven Central pendant un moment maintenant, ainsi que JCenter .


3 commentaires

Mise à jour: Vous n'avez pas besoin de télécharger le pot, SPOCK-Reports est disponible auprès de JCenter comme artefact maven.


Bonjour, je me demandais s'il est possible d'inclure des journaux de console avec les rapports Spock. Je visualise quelque chose comme un bouton Développer lorsque: alors: les balises et l'expansion de ceux-ci afficheront la console correspondante. De plus, je voudrais contribuer à cela s'il est possible de mettre en œuvre et de passer à Git.


Veuillez utiliser Github pour les demandes de fonctionnalités.



0
votes

Il y a déjà de bonnes réponses ici, mais si vous souhaitez conserver vos définitions BDD exemptes de toute plomberie, vous pouvez regarder Pease , qui vous permettra d'utiliser une langue de spécification de gerkine avec SPOCK.


1 commentaires

Malheureusement Pease est désormais homologué : PAY est obsolète et gagné 't être développé ou maintenu plus loin. Ma recommandation est d'examiner le projet Cucumber-JVM.