Informazioni sullo strumento
I feature file vengono letti da product owner e sviluppatori oltre che dai tester, quindi un layout coerente è importante. Questo formattatore reindenta i blocchi Feature, Rule, Background, Scenario, Scenario Outline ed Examples, colloca i tag insieme all’elemento a cui appartengono, allinea le pipe nelle tabelle di dati e nelle tabelle Examples, e lascia intatto il contenuto delle doc string a parte il rientro di base. Esegue anche controlli lint di base: scenari senza step Then, nomi di scenario duplicati, step fuori da uno scenario, Scenario Outline senza Examples, segnaposto senza una colonna Examples corrispondente, righe di tabella irregolari e doc string non chiuse. Supporta le parole chiave in inglese e gira interamente nel browser.
Come si usa
- Incolla il contenuto di un file .feature, oppure clicca “Load sample” per vedere un file con problemi voluti.
- Scegli 2 o 4 spazi. La versione formattata ed evidenziata compare a destra e i risultati del lint compaiono sotto con i numeri di riga dell’input.
- Copia o scarica il risultato, oppure clicca “Replace input with formatted” per continuare a modificare la versione pulita.
Formattatore e linter Gherkin: domande frequenti
Perché viene segnalato uno scenario senza step Then?
Gli step Then contengono le asserzioni. Uno scenario con soli step Given e When esegue azioni ma non verifica nulla, quindi passa finché non viene sollevata un’eccezione. Il linter considera And e But dopo un Then come parte del blocco Then.
Modifica il testo dei miei step?
No. Cambia solo il rientro, comprime gli spazi in eccesso tra i tag e allinea le celle delle tabelle. La formulazione degli step, i parametri tra virgolette e il contenuto delle doc string restano invariati.
Gli Examples sono ammessi sotto un semplice Scenario?
Da Gherkin 6, Scenario e Scenario Outline sono intercambiabili quando è presente una tabella Examples, e Cucumber lo esegue come outline. Il linter accetta entrambi; i segnaposto come <user> devono comunque corrispondere a un’intestazione di colonna degli Examples.