도구 소개
Feature 파일은 테스터뿐 아니라 프로덕트 오너와 개발자도 읽으므로 일관된 레이아웃이 중요합니다. 이 포매터는 Feature, Rule, Background, Scenario, Scenario Outline, Examples 블록의 들여쓰기를 다시 맞추고, 태그를 해당 요소 바로 위에 배치하며, 데이터 테이블과 Examples 테이블의 파이프(|)를 정렬하고, Doc String 내용은 기본 들여쓰기 외에는 손대지 않습니다. 또한 기본 린트 검사도 수행합니다: Then 스텝이 없는 시나리오, 중복된 시나리오 이름, 시나리오 밖의 스텝, Examples가 없는 Scenario Outline, Examples 컬럼과 일치하지 않는 플레이스홀더, 칸 수가 맞지 않는 표 행, 닫히지 않은 Doc String. 영어 키워드를 지원하며 모든 처리는 브라우저에서 이루어집니다.
사용 방법
- .feature 파일의 내용을 붙여 넣거나, 일부러 문제를 넣은 예시 파일을 보려면 “Load sample”(샘플 불러오기)을 클릭합니다.
- 들여쓰기를 2칸 또는 4칸으로 선택합니다. 정리되고 하이라이트된 결과가 오른쪽에, 린트 결과는 입력 줄 번호와 함께 아래에 표시됩니다.
- 결과를 복사하거나 다운로드하고, 정리된 버전으로 계속 편집하려면 “Replace input with formatted”(입력을 정리된 결과로 교체)를 클릭합니다.
Gherkin 포매터·린터 자주 묻는 질문
Then 스텝이 없는 시나리오가 경고되는 이유는 무엇인가요?
Then 스텝에 어설션이 들어갑니다. Given과 When 스텝만 있는 시나리오는 동작만 수행하고 아무것도 검증하지 않으므로, 예외만 발생하지 않으면 통과합니다. 린터는 Then 뒤의 And와 But을 Then 블록의 일부로 취급합니다.
스텝 텍스트가 바뀌나요?
아니요. 들여쓰기를 바꾸고, 태그 사이의 여분 공백을 합치고, 표 셀에 패딩을 넣을 뿐입니다. 스텝 문구, 따옴표로 묶인 파라미터, Doc String 내용은 그대로 유지됩니다.
일반 Scenario 아래에 Examples를 써도 되나요?
Gherkin 6부터는 Examples 테이블이 있으면 Scenario와 Scenario Outline을 서로 바꿔 쓸 수 있으며, Cucumber는 이를 아웃라인으로 실행합니다. 린터는 둘 다 허용하지만, <user> 같은 플레이스홀더는 여전히 Examples 컬럼 헤더와 일치해야 합니다.