Muito se fala a respeito de TDD (Test Driven Development) hoje em dia, mas o que é essa técnica ninja de desenvolver?
Simples, como o próprio nome já sugere você é guiado por testes, ou seja primeiro você escreve o código de TESTE e somente depois programa! Soa diferente né?!
Mas vamos tentar isso com o Rails e ver como funciona!
Vamos usar o Cucumber, pois ele deixa o teste muito mais amigável, veremos a seguir...
Instale as depêndencias:
apt-get install libxml2 libxml2-dev libxslt-dev
Instale o cucumber:
gem install database_cleaner webrat
Se der algum erro de dependência, irá aparecer algo como "NOME_DA_LIB is missing" na instalação do webrat, instale-a e tente de novo.
Após isso, instale o cucumber-rails
gem install cucumber-rails
Crie uma aplicação RAILS e configure a conexão com o mysql
rails teste_cucumber -d mysql
Entre na pasta do projeto e execute:
cd teste_cucumber/
rake db:create:all
Vamos colocar o cucumber no projeto:
ruby script/generate cucumber
E verificar se está tudo instalado corretamente:
rake cucumber
Agora que estamos com tudo instalado, vamos imaginar o caso de um simples cadastro, a pessoa tem que inserir nome (no máximo 60chars) e email (no formato correto) no banco de dados através de um CRUD (gerado pelo scaffold mesmo).
Etapa1 - Desenvolver.... O TESTE!
Isso mesmo, antes de desenvolver vamos escrever o código do teste!
Vamos criar um passo onde vamos falar para o teste que queremos cadastrar uma pessoa no banco:
script/generate feature usuario id:integer, nome:string, email:string
Dentro da pasta features/ aparecerá um arquivo chamado, manage_usuarios.feature, vamos editá-lo assim:
Feature: Manage usuarios
In order to manage users
As a system's user
wants to register a user
Scenario: Register new usuario sucessfull
Given I am on the new usuario page
When I fill in "Nome" with "Test name"
And I fill in "Email" with "email@email.com"
And I press "Create"
Then I should see "Test name"
And I should see "email@email.com"
Scenario: Register new usuario email error
Given I am on the new usuario page
When I fill in "Nome" with "Nome de teste"
And I fill in "Email" with "this_is_not_a_valid_email"
And I press "Create"
Then I should see "Email - Invalid email"
Scenario: Register new usuario name error
Given I am on the new usuario page
When I fill in "Nome" with "This_user_has_more_than_60_chars_lalalalalalalalalalalalalalalalalalalalalalalalalalalala"
And I fill in "Email" with "email@email.com"
And I press "Create"
Then I should see "Nome - max 60 chars"
Como o próprio arquivo já diz, se um usuário preencher o email de forma errada, deve aparecer o erro, se ele preencher o nome com mais de 60 caracteres, também deve aparecer o erro, se for tudo certo, deverá ver o seu nome e email na listagem.
2 Etapa - Executar os testes e ver se tem erros!
Agora vamos executar o teste:
rake cucumber
Vixi! Vários erros, mas como o rails sabe o que tem que fazer simplesmente com o texto???
Dentro da pasta features/step_definitions estão os arquivos que falam a frase e como ela deve responder ao comando!
Bom, agora que sabemos onde estão os erros, vamos corrigir!
3 Etapa - Escreva seu código!
O primeiro erro que aparece é que não temos a rota para new_usuario, então vamos finalmente criar o scaffold com usuários!
ruby script/generate scaffold Usuario id:integer nome:string email:string
Vamos editar o arquivo de migração db/migrate/20100304174346_create_usuarios.rb para que o banco tenha uma chave primária e respeite os limites de caracteres, do modo que fique assim:
class CreateUsuarios < ActiveRecord::Migration
def self.up
create_table :usuarios, :primary_key => :id do |t|
t.integer :id, :null => false
t.string :nome, :limit => 60, :null => false
t.string :email, :limit=>255, :null => false
t.timestamps
end
end
def self.down
drop_table :usuarios
end
end
Feito isso vamos executar o migrate do banco de dados!
rake db:migrate
Se tudo ocorreu bem já devemos ter nossa interface de CRUD funcionando no localhost, execute a aplicação do jeito que achar melhor para testarmos!
Agora que codificamos uma parte, vamos testar o nosso código pra ver se passa na validação:
rake cucumber
Olha só! Passamos em 1, mas ainda faltam 2! Esquecemos de colocar as validações no email e no nome.
Vamos editar o arquivo app/model/usuario.rb adicionando as validações:
class Usuario < ActiveRecord::Base
validates_format_of :email,
:with => /^([^@\s]+)@((?:[-a-z0-9]+\.)+[a-z]{2,})$/i,
:message => '- Invalid email'
validates_length_of :nome, :within => (0..60), :message=> "- max 60 chars"
end
Etapa 4 - Execute os testes com sucesso!
Agora vamos rodar o teste mais uma vez:
rake cucumber
Agora sim :D passamos em todos os testes! E temos mais uma etapa que não se aplica a esse projeto...
Etapa 5 - Refratore o código
Arrume seu código, pois agora os seus testes já garantem as funcionalidades básicas e assim você garante que o que voce alterar não impactará no projeto.
Etapa 6 - Repita tudo até terminar!
Tudo nos agiles da vida é assim! Faça rápido, bem feito e faça de novo! :D
O projeto pode ser baixado aqui:
http://cbs.net.br/downloads/cucumber_teste.tar.gz
No próximo POST trarei como fazer isso em português!
[]'s
Leonardo Baptista