Подтвердить что ты не робот

Довольно выводные файлы функций Gherkin

Мы собираем спецификацию в Gherkin, и мы хотели бы представить файлы функций заинтересованным сторонам. Как мы можем экспортировать все наши файлы функций в каком-то "симпатичном" формате?

Например:

  • Создать документ, содержащий все функции
  • ИЛИ интегрировать функции в другую документацию
  • ИЛИ опубликовать файлы функций на веб-портале (красиво отформатированный)
4b9b3361

Ответ 1

Лучшее, что я видел до сих пор, это Pickles; http://github.com/picklesdoc/pickles

Он работает в процессе, но хорошо выглядит. Отправьте свои отзывы о GitHub

Ответ 2

Наша команда в настоящее время использует relish, проект кода, который прекрасно отформатирует ваши корнишоны на веб-сайте.

Однако у него есть некоторые недостатки - это только "свободное время в бета-версии", но это все равно может дать вам некоторые идеи.

Приятная особенность наслаждения заключается в том, что ваша команда разработчиков может выбрать, чтобы подталкивать корнишонов, когда они готовы, а заинтересованным сторонам не нужно управлять/получать новые электронные письма и документы и т.д. - они могут просто обновлять веб-страницу проекта.

Ответ 3

Почему вы думаете, что хотите это сделать?

Я бы предположил, что красота bdd заключается в том, что она обеспечивает вездесущий язык между заинтересованными сторонами бизнеса, тестировщиками и разработчиками. Он может использоваться в любой части цикла тестирования для описания функций, которые вы хотите, и сценариев, которые они придерживаются. С вашим файлом стиля gherkin в виде простого текстового файла он может быть отредактирован непосредственно участником бизнеса и перенесен обратно в репозиторий исходного кода. Вы можете буквально взять новые сценарии из бизнеса и подтвердить, какие функции нужно работать, прежде чем писать одну строку кода.

Предоставляя другой формат для этих файлов, вы мешаете легкости, с которой данные могут пересекать эти мосты. Да, вы можете префлотировать его и объединить все функции вместе, в текстовый документ и т.д., Но, делая это, вы теряете возможность напрямую брать набор сценариев прямо из бизнеса и демонстрировать, что кодовая база "работает" для них.

Итак, я бы предположил, что лучший формат для представления заинтересованным сторонам бизнеса точно такой же, как и формат, в котором они уже находятся.

Однако, вы подумали о том, чтобы изменить ваш бегун ваших тестов. Даже если функции все еще находятся в обычном тексте, бегун, такой как concordion или Concordion.net даст вам очень симпатичный показ тестового прогона.

Ответ 4

Другой вариант, который не требует технического мастерства. Подобно другому ответу здесь, но он специально разработан, чтобы обратиться к бизнесу, а не к техническим заинтересованным сторонам. Это расширение Chrome, которое автоматически форматирует любой файл *.feature, открытый в Chrome. Смотрите примеры и установите здесь: Pretty Gherkin просмотрщик файлов функций

Ответ 5

Пойдите с Gherkin Viewer

Я собрал это расширение хром для этой цели, поскольку мне не нравилась идея экспортировать/переиздавать файлы функций. Это позволяет вам просмотреть исходную правду источника:)

https://chrome.google.com/webstore/detail/gherkin-viewer/lfckgakamnfdbanfefglincnckfnlapp?hl=en-GB

Взгляните, посмотрите, работает ли это для вас. Источник находится на GitHub, очень простой старт, если кто-то хотел бы внести большой вклад.