Возможна ли со Spock документация, читаемая непрограммистами?

FitNesse имеет функцию документации в стиле вики. Он предоставил как код, так и документацию для этих тестов спецификации.

Есть ли способ в Spock (с помощью плагина? / из коробки?) для создания любого типа подобной документации, чтобы хвастаться руководителям проекта / заинтересованным сторонам, от которых нельзя ожидать, что они прочитают (Groovy) исходный код Spock технические характеристики.


person Lorin S.    schedule 03.08.2011    source источник


Ответы (3)


Spock позволяет добавлять описания к блокам, например:

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

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

Хотя мы еще не используем эту информацию, к ней легко получить доступ из расширения (см. ссылку ниже). Осталось превратить это в хороший отчет.

https://github.com/spockframework/spock-uberconf-2011/blob/master/src/test/groovy/extension/custom/ReportExtension.groovy

person Peter Niederwieser    schedule 04.08.2011
comment
Я использовал функцию комментирования, и мне было интересно, как это стало частью вывода. Спасибо Питер! - person Lorin S.; 05.08.2011
comment
Похоже, NFJS удалил вложение pps, которое у вас было. Я погуглю, исследуя расширения и отчеты. Любая дополнительная информация, которую вы можете предоставить, была бы отличной. Еще раз спасибо. - person Lorin S.; 05.08.2011
comment
Репозиторий GitHub, на который я ссылался выше, содержит все материалы из моего последнего выступления, включая слайды. - person Peter Niederwieser; 08.08.2011

Что ж, я использовал строки, описывающие каждый блок Spock в ваших тестах, для создания HTML-отчетов. Пожалуйста, посетите мой проект и дайте мне знать, если это поможет:

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

Вы можете загрузить банку из каталога reports, а затем просто добавить ее в свой путь к классам. Запустите свои тесты, и «чудесным образом» вы получите отчеты, сгенерированные в каталоге build/spock-reports!

Вы даже можете предоставить свои собственные таблицы стилей CSS, если хотите настроить отчеты, как описано в README.

Вот сообщение в блоге Я написал о написании этого расширения Spock.

ОБНОВЛЕНИЕ

spock-reports был доступен на Maven Central, а также JCenter.

person Renato    schedule 12.09.2013
comment
ОБНОВЛЕНИЕ: вам не нужно загружать банку, спок-отчеты доступны в JCenter как артефакт maven. - person Renato; 26.11.2014
comment
Привет. Мне было интересно, есть ли возможность включить журналы консоли вместе с отчетами Spock. Я визуализирую что-то вроде кнопки расширения вокруг тегов when: then: и их раскрытие будет отображать соответствующие журналы консоли, если таковые имеются. Также я хотел бы внести свой вклад в это, если это возможно реализовать и переместить в GIT. - person Raghu Kiran; 05.05.2016
comment
пожалуйста, используйте Github для запросов функций. - person Renato; 06.05.2016

Здесь уже есть несколько отличных ответов, но если вы хотите, чтобы ваши определения BDD были свободны от какой-либо сантехники, вы можете взглянуть на pease, который позволит вам использовать язык спецификации Gherkin со Spock.

person Michal M    schedule 09.10.2015
comment
К сожалению, мир теперь не поддерживается: мир устарел и победил не подлежит дальнейшему развитию или поддержке. Я рекомендую взглянуть на проект Cucumber-JVM. - person ninj; 22.11.2018