Skip to content

Escreve os cenários Gherkin em português - #37

Merged
ThomasTDS merged 1 commit into
masterfrom
docs/gherkin-em-portugues
Oct 2, 2026
Merged

ThomasTDS merged 1 commit into
masterfrom
docs/gherkin-em-portugues

Conversation

@ThomasTDS

Copy link
Copy Markdown
Owner

Resumo

  • Todos os .feature começam com # language: pt e usam as palavras-chave em português: Funcionalidade, Cenário, Esquema do Cenário, Exemplos, Dado, Quando, Então e E
  • Os passos trocam o sujeito "ele" por "o usuário". Logo após "Dado que existe um booking criado", o "E que ele possui um token" se referia, pela gramática, ao booking
  • TC-002: o passo vira o usuário solicita um token com o login "admin" e a senha "senha_errada", para não repetir "usuário"
  • "booking" e os nomes dos campos da API (firstname, totalprice etc.) foram mantidos, por serem os nomes usados na API, nos modelos e nas issues
  • Os decorators dos steps acompanham o novo texto. A lógica dos steps não muda
  • docs/test-cases.md: os links de cada TC foram recalculados a partir da posição real da tag e apontam para a linha do Cenário. Os antigos não seguiam uma regra única (o do TC-001 apontava para a tag, o do TC-002 para uma linha em branco)
  • README: o item de BDD menciona o Gherkin em português

Os títulos dos cenários não mudam, então os nomes dos testes no relatório continuam os mesmos.

Test plan

  • Cenário descartável com # language: pt (todas as palavras-chave usadas aqui, inclusive Esquema do Cenário) passando no pytest-bdd 8.1 (local) e 9.0 (versão do CI)
  • mypy .
  • ruff check .
  • ruff format --check .
  • pytest: 53/53 testes passando
  • pytest -m smoke: 5 cenários selecionados pelas tags, todos passando

Os arquivos .feature passam a usar # language: pt (Funcionalidade, Cenário, Dado, Quando, Então), e os passos trocam o sujeito "ele" por "o usuário", que era ambíguo logo após "que existe um booking criado". Os links da matriz em docs/test-cases.md foram recalculados para apontar para a linha de cada Cenário.
@codecov

codecov Bot commented Oct 2, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@ThomasTDS
ThomasTDS merged commit de4f8f1 into master Oct 2, 2026
7 checks passed
@ThomasTDS
ThomasTDS deleted the docs/gherkin-em-portugues branch October 2, 2026 19:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant