Sobre esta ferramenta
Feature files são lidos por product owners e desenvolvedores, além de testers, então um layout consistente importa. Este formatador reindenta os blocos Feature, Rule, Background, Scenario, Scenario Outline e Examples, coloca as tags junto ao elemento a que pertencem, alinha os pipes nas tabelas de dados e de Examples e deixa o conteúdo das doc strings intacto, exceto pela indentação base. Ele também roda checagens básicas de lint: cenários sem passo Then, nomes de cenário duplicados, passos fora de um cenário, Scenario Outlines sem Examples, placeholders sem coluna correspondente em Examples, linhas de tabela irregulares e doc strings não fechadas. Suporta palavras-chave em inglês e roda inteiramente no navegador.
Como usar
- Cole o conteúdo de um arquivo .feature ou clique em “Load sample” para ver um arquivo com problemas propositais.
- Escolha 2 ou 4 espaços. A versão formatada e destacada aparece à direita, e os resultados do lint aparecem abaixo com os números das linhas da entrada.
- Copie ou baixe o resultado, ou clique em “Replace input with formatted” para continuar editando a versão limpa.
Perguntas frequentes: Formatador e linter de Gherkin
Por que um cenário sem passo Then é sinalizado?
Os passos Then contêm as assertions. Um cenário que só tem passos Given e When executa ações, mas não verifica nada, então passa desde que nada lance erro. O linter trata And e But depois de um Then como parte do bloco Then.
Ele altera o texto dos meus passos?
Não. Ele só muda a indentação, reduz espaços extras entre tags e preenche as células das tabelas. A redação dos passos, os parâmetros entre aspas e o conteúdo das doc strings são preservados.
Examples são permitidos em um Scenario simples?
Desde o Gherkin 6, Scenario e Scenario Outline são intercambiáveis quando há uma tabela Examples, e o Cucumber o executa como outline. O linter aceita os dois; placeholders como <user> ainda precisam corresponder a um cabeçalho de coluna de Examples.