Доста извеждане на файлове с функции Gherkin

Ние изграждаме спецификация в Gherkin и бихме искали да представим файловете с функции на заинтересованите страни от бизнеса. Как можем да експортираме всички наши файлове с функции в някакъв „красив“ формат?

Например:

  • Генерирайте документ, съдържащ всички функции
  • ИЛИ интегрирайте функции в друга документация
  • ИЛИ публикувайте файловете с функции на уеб портал (добре форматиран)

person dgmstuart    schedule 08.11.2011    source източник
comment
можете ли да изясните кой избирате в крайна сметка и как да хоствате в компанията?   -  person vikramvi    schedule 24.11.2016
comment
Напуснах проекта и компанията, преди да е взето решение.   -  person dgmstuart    schedule 04.12.2016
comment
пробвахте ли това в нов проект и компания? вашият принос ще бъде от голяма полза за общността и за мен също :)   -  person vikramvi    schedule 05.12.2016
comment
Не: Оттогава изобщо не използвам корнишон/краставица.   -  person dgmstuart    schedule 06.12.2016


Отговори (5)


Най-доброто, което съм виждал досега, е Pickles; http://github.com/picklesdoc/pickles

Работи се, но вече изглежда добре. Моля, изпратете вашите отзиви за GitHub

person Marcus Hammarberg    schedule 09.11.2011
comment
Сега напуснах проекта, но това беше този, който изглеждаше най-обещаващ - всъщност започнахме да го използваме, но не знам докъде е стигнал екипът с него. - person dgmstuart; 30.01.2012
comment
@dgmstuart е жив и ритащ! Те току-що добавиха JSON и DITA поддръжка, както и поддържаха стартирането му от командния ред, powershell (във VS2010 например), MsBuild и NAant. Вижте го: nuget.org/packages/Pickles - person Marcus Hammarberg; 30.01.2012
comment
За съжаление това изглежда е само за машини с Windows... Няма поддръжка за Mac или Linux :( - person Nosrettap; 11.11.2013
comment
Току-що създадох GherkinDoc, npm пакет, който генерира HTML сайтове от функции на Gherkin, npmjs.com/package/gherkindoc - person AlexandrosD; 22.10.2016

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

Той обаче има някои недостатъци - той е само „безплатен, докато е в бета версия“, но това все пак може да ви даде някои идеи.

Хубава характеристика на Relish е, че вашият екип за разработчици може да избере да бутне корнишоните, когато са готови, и заинтересованите страни не трябва да управляват/получават нови имейли/документи и т.н. – те могат просто да опресняват уеб страница на проекта.

person perfectionist    schedule 28.01.2012
comment
Здравейте - благодаря, да, видях Relish сега, но за съжаление бизнесът не се чувстваше удобно спецификацията да бъде отворена за всички - това е огромен недостатък. Разгледахме Pickle, който не е много зрял, но изглеждаше интересен. Напуснах компанията, за която този проблем беше свързан... - person dgmstuart; 30.01.2012
comment
AFAIK всичко, което можете да видите, не е точно. Трябва да качите файловете с функции на уебсайта на relish - така че има включена трета страна, но страниците ви с relish са видими само за вашия собствен вход. - person perfectionist; 30.01.2012
comment
А, изглежда са добавили частни проекти, откакто гледах последно. - person dgmstuart; 09.02.2012

Защо мислиш, че искаш да направиш това?

Бих предположил, че красотата на bdd е, че предоставя повсеместен език между бизнес заинтересованите страни, тестерите и разработчиците. Може да се използва във всяка част от цикъла на тестване, за да опише функциите, които искате, и сценариите, към които се придържат. С вашия файл с характеристики в стил корнишони като обикновен текстов файл, той може да бъде редактиран директно от бизнес заинтересована страна и директно прехвърлен обратно в хранилище на изходния код. Можете буквално да вземете нови сценарии от бизнеса и да потвърдите кои функции трябва да работят, преди да напишете един ред код.

Предоставяйки различен формат за тези файлове, вие пречите на лекотата, с която данните могат да преминат през тези мостове. Да, можете да го разкрасите и да групирате всички функции заедно, в документ на Word и т.н., но като направите това, вие губите способността директно да вземете набор от сценарии направо от бизнеса и да демонстрирате, че кодовата база „работи“ за тях.

Така че бих предложил най-добрият формат за представяне на заинтересованите страни от бизнеса да е точно същият като формата, в който те вече са.

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

person AlSki    schedule 15.11.2011
comment
здрасти Да, съгласен съм, предпочитам да не се забърквам с формата, но основният проблем, който трябва да се реши, е представянето на спецификацията на потребителите - те изобщо не са много запознати с технологиите, така че едва ли ще мога накарайте ги да изтеглят актуализации в локално хранилище! Има редица наистина основни предизвикателства: споделяне от контрола на източника, представяне на спецификацията по визуално четим начин (напр. с подчертаване на синтаксиса) и представяне само на списъка с описания на функции за заинтересовани страни от по-високо ниво. Някакви идеи от този ъгъл? - person dgmstuart; 30.01.2012
comment
Мислили ли сте да внедрите интерфейс? Някой (водещ разработчик / ръководител на екип / технически разбиращ мениджър на проекти) се свързва с потребителите. Те се ангажират чрез имейл към интерфейса, който след това обработва действителния ангажимент. Да, не е идеален, но поддържа всичко в движение и кой знае, след като свикнат с идеята, те също ще се ангажират директно. - person AlSki; 31.01.2012
comment
Наследих система с 450 истории, общо над 46 000 думи - и растя. Да се ​​опитвате да разберете функционалността от необработените текстови файлове с истории е като да се опитвате да разберете системната архитектура чрез четене на хиляди редове код. Ако историите трябва да служат като документация, трябва да има механизъм за лесно увеличаване или намаляване до нивото, на което искате да видите. - person Chris Snow; 18.01.2014

Друг вариант, който не изисква никакви технически умения. Подобен на друг отговор тук, но е специално предназначен да се хареса на бизнеса, а не на технически заинтересовани страни. Това е разширение за Chrome, което автоматично форматира всеки *.feature файл, отворен в Chrome. Вижте примери и инсталирайте тук: Програма за преглед на файлове с функции Pretty Gherkin

person ItsMe-Rodders    schedule 11.03.2015

Опитайте с Gherkin Viewer

Събрах това разширение за chrome за тази цел, тъй като не ми хареса идеята за експортиране/препубликуване на файлове с функции. Това ви позволява да видите истината за оригиналния източник :)

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

Разгледайте, вижте дали работи за вас. Източникът е в GitHub, много елементарно начало, ако някой иска да допринесе, ще бъде високо оценен.

person John Byrne    schedule 12.09.2014