Repositório de exemplos de especificação de requisitos executável - uma funcionalidade do sistema SysRadoc, em linguagem Gherkin, do Cucumber.

README.md

SysRadoc-Cucumber-Features

Repositório temporário de funcionalidades do sistema SysRadoc, em linguagem Gherkin, do Cucumber.js. O repositório contém um arquivo .feature de exemplo para o aprendizado dessa Linguagem de Domínio Específica (DSL) que cria especificação executável.

Link para o protótipo de interface do sistema:
http://gustavosotnas.github.io/SysRadoc-Prototipo-GUI-INF-UFG

Instalação e usagem

Para visualizar arquivos .feature off-line com syntax highlighting, é recomendado usar algum dos seguintes editores de texto:

• Sublime Text, com a instalação do pacote Behat Features através do instalador de pacotes Package Control
• Atom, com a instalação do pacote Cucumber através do instalador de pacotes do Atom.

Learning

Materiais para aprender a escrever features na linguagem Gherkin:

• Exemplo de .feature
• BDD na prática – parte 3 – Gherkin
• Desenvolvimento Baseado em Testes (BDD + Cucumber)
• Desenvolvimento orientado a comportamento (BDD) com Cucumber

Cucumber-Exemplo-SysRadoc.feature

#language: pt

# Template de especificação executável em linguagem Gherkin/Cucumber
# Author: Gustavo Moraes <[email protected]>
#
# Artigos sobre a linguagem Gherkin/Cucumber: 
# 	http://elemarjr.net/2012/04/12/bdd-na-prtica-parte-3-gherkin
# 	http://pt.slideshare.net/edumendes/bdd-com-cucumber-14910137
#
# A ferramenta Cucumber é originalmente feita para Ruby, mas pode usada
# para diversas linguagens - por exemplo, para Node.js: 
#	`npm install -g cucumber`
#
# Recomendado visualizar o arquivo com o editor Sublime Text, 
# instale o pacote "Behat Features" com o Package Control 
# para ter o Syntax Highlighting do Gherkin/Cucumber.
#	Sublime Text: http://www.sublimetext.com
#	Package Control: https://packagecontrol.io/installation
#	Behat Features: https://packagecontrol.io/packages/Behat%20Features

	Funcionalidade: Criar cadastro

#	Seguindo o modelo de estória de usuário do BDD e Scrum:
#		Como um [algum papel]
#		Eu quero [alguma necessidade]
#		Para que [benefício/valor da característica]

		Como um docente
		Eu quero utilizar o sistema SysRadoc
		Para que eu possa automatizar a avaliação de Radocs.

		# Restrições: (se tiver...)
		#	1) Blablabla blablabla
		#	2) Lorem ipsum dolor sit amet, consectetur adipisicing elit.

# Expressões-chave do Gherkin/Cucumber:
#
#	Funcionalidade
#	Contexto
#	Cenário
#	Dado
#	Quando
#	Então
#	E
#	Mas
#	Esquema de cenário
#	Exemplos

	Contexto:
		Dado que eu ainda não tenho um cadastro no SysRadoc
		E estou na página inicial do sistema
		Eu gostaria de ter acesso ao SysRadoc para facilitação do processo de avaliação de docentes

# Strings usam "aspas", nomes de variáveis (fora de tabelas) usam <chevrons>
	Esquema do Cenario: Criando cadastro
		Dado o formulário da página "Criar nova conta" está aberto
		Quando eu preencho o meu <nome_completo>
		E seleciono no drop-down a minha <classe_do_docente>
		E digito o meu <endereco_de_email> válido
		E uma nova <senha> para posterior acesso no sistema
		Entao o sistema informa: "Conta criada com sucesso"
		Exemplos:
			| nome_completo         | classe_do_docente              | endereco_de_email     | senha         |
			| "Exemplo de Oliveira" | "Classe E - docente Titular"   | "[email protected]" | "exemplo123@" |
			| "Fulana de Tal"       | "Classe D - docente Associado" | "fulana2example.cm"   | "foobar#1"    |