http://dl.dropbox.com/u/75418/session.rb

E coloquem na pasta: C:\Ruby187\lib\ruby\gems\1.8\gems\webrat-0.7.3\lib\webrat\core
por cima do arquivo existente.

Com tudo instalado e pronto vamos começar a pensar em BDD (desenvolvimento guiado por comportamento). Vamos criar um projeto para efetuarmos os testes:

rails new trabalho

Lembrando as idéias de BDD, criamos primeiro os testes, depois o códigos que resolvam aqueles testes, só depois refatoramos, ou seja, alteramos o código para, efetivamente, funcionar da maneira prevista nos requisitos.

Primeiramente configuramos nossa aplicação para usar o cucumber. Abrimos o arquivos Gemfile na pasta raiz do nosso projeto e, no final do arquivo, adicionaremos as seguintes linhas:

group :development, :test do
  gem 'cucumber'
  gem 'cucumber-rails'
  gem 'webrat'
end

Após isso iremos gerar os arquivos básicos para funcionamento do cucumber, com o seguinte comando, dentro da pasta do projeto (cd trabalho):

rails generate cucumber:install pt-BR

O parâmetro pt-BR serve para que os arquivos possam ser feitos em português do Brasil.

ricardo@linuxmint ~/trabalho $ rails generate cucumber:install pt-BR
      create  config/cucumber.yml
      create  script/cucumber
       chmod  script/cucumber
      create  features/step_definitions
      create  features/step_definitions/web_steps.rb
      create  features/step_definitions/web_steps_pt-BR.rb
      create  features/support
      create  features/support/paths.rb
      create  features/support/env.rb
       exist  lib/tasks
      create  lib/tasks/cucumber.rake
        gsub  config/database.yml
        gsub  config/database.yml
       force  config/database.yml

Antes de criar nossos testes, vamos fazer uma pequena correção em um arquivo de configuração que foi gerado. Na pasta features/support, abrimos o arquivo env.rb. Iremos alterar a linha 19, trocando o conteúdo:

  config.mode = :rails

por:

  config.mode = :rack

Feito isso, vamos criar nosso primeiro arquivo de história de usuário: na pasta features vamos criar um arquivo chamado pessoas.feature (.feature é a extensão padrão do cucumber para histórias de usuário). Digitaremos nele o seguinte conteúdo:

# language: pt
Funcionalidade: Gerenciamento de pessoas
  Para efetuar o gerenciamento de pessoas
  Como um usuário cadastrado
  Eu quero cadastrar, alterar e excluir pessoas no sistema

  Cenário: Cadastro de Pessoas
    Dado que eu esteja no cadastro de pessoas
    Quando eu preencho "nome" com "Ricardo"
    E eu preencho "idade" com "24"
    E eu preencho "peso" com "88.5"
    E eu aperto "Cadastrar"
    Então eu devo ver "Pessoa cadastrado com sucesso"
    E eu devo ver "Nome: Ricardo"
    E eu devo ver "Idade: 24"
    E eu devo ver "Peso: 88.5"
    E eu devo ver "Cadastrar nova pessoa"

Com nossa história de usuário pronta, podemos executar o teste. Como não existe código ainda, os testes irão falhar. Para executar os testes executamos o comando:

rake cucumber

O primeiro erro que acontece é:

ricardo@linuxmint ~/trabalho $ rake cucumber
(in /home/ricardo/trabalho)
rake aborted!
Unknown database 'trabalho_development'

Isso significa que devemos criar o banco de dados, com o comando:

rake db:create:all

rodamos o comando rake:cucumber novamente e obtemos o erro a seguir:

ricardo@linuxmint ~/trabalho $ rake cucumber
(in /home/ricardo/trabalho)
/home/ricardo/trabalho/db/schema.rb doesn't exist yet. Run "rake db:migrate" to create it then try again. If you do not intend to use a database, you should instead alter /home/ricardo/trabalho/config/application.rb to limit the frameworks that will be loaded

Significa que devemos migrar para o banco de dados, com o seguinte comando:

rake db:migrate

Rodando rake:cucumber novamente, conseguiremos começar a executar os teste. Nesse momento, encontraremos o seguinte erro:

ricardo@linuxmint ~/trabalho $ rake cucumber
(in /home/ricardo/trabalho)
bundle exec /usr/bin/ruby1.8 -I "/var/lib/gems/1.8/gems/cucumber-0.10.0/lib:lib" "/var/lib/gems/1.8/gems/cucumber-0.10.0/bin/cucumber"  --profile default
Using the default profile...
U---------

1 scenario (1 undefined)
10 steps (9 skipped, 1 undefined)
0m1.360s

You can implement step definitions for undefined steps with these snippets:

Dado /^que eu esteja no cadastro de pessoas$/ do
  pending # express the regexp above with the code you wish you had
end

rake aborted!
Command failed with status (1): [bundle exec /usr/bin/ruby1.8 -I "/var/lib/...]

Esse erro nos diz que devemos criar a regra necessária para executar a primeira linha de nosso primeiro cenário. Para resolver isso devemos criar, na pasta features/step_definitions um arquivo chamado gerenciamento.rb, que conterá essa regra. Nesse arquivo colocamos o código que o cucumber nos trouxe como resultado:

Dado /^que eu esteja no cadastro de pessoas$/ do
  pending # express the regexp above with the code you wish you had
end

alterando a linha do meio para:

Dado /^que eu esteja no cadastro de pessoas$/ do
  visit new_pessoa_path
end

Esse comando diz ao cucumber para visitar a página de cadastro de nova pessoa (new_pessoa_path).
Executando novamente rake cucumber, começará a dar erros da lógica da aplicação propriamente dita. O erro desta vez é o seguinte:

undefined local variable or method `new_pessoa_path' for # (NameError)
./features/step_definitions/gerenciamento.rb:2:in `/^que eu esteja no cadastro de pessoas$/'
features/gerenciamento.feature:8:in `Dado que eu esteja no cadastro de pessoas'

A causa desse erro é que não existe ainda caminho para o cadastro de pessoas. Para corrigir esse erro vamos ao arquivo config/routes.rb e colocamos o seguinte conteúdo no lugar do que já existe lá:

Trabalho::Application.routes.draw do
  resources :pessoas
end

Esse código mapeia os caminhos (urls) para a entidade pessoas. Rodando rake cucumber novamente, encontramos o seguinte erro:

uninitialized constant PessoasController (ActionController::RoutingError)
./features/step_definitions/gerenciamento.rb:2:in `/^que eu esteja no cadastro de pessoas$/'
features/gerenciamento.feature:8:in `Dado que eu esteja no cadastro de pessoas'

Significa que o controlador de pessoas ainda não existe. Vamos criá-lo com o seguinte comando:

rails generate controller pessoas

Dessa forma geramos o controlador de pessoas e o erro anterior não acontecerá mais. Rodando rake:cucumber, dará o seguinte erro:

The action 'new' could not be found for PessoasController (AbstractController::ActionNotFound)
./features/step_definitions/gerenciamento.rb:2:in `/^que eu esteja no cadastro de pessoas$/'
features/gerenciamento.feature:8:in `Dado que eu esteja no cadastro de pessoas'

Esse erro significa que não há o método new no controlador pessoas. Então, devemos criá-lo. No arquivo app/controller/pessoas_controller criamos, dentro da classe, o método new:

class PessoasController < ApplicationController
  def new
    @pessoa = Pessoa.new
  end
end

Fazendo isso e executando rake cucumber, dará o seguinte erro:

uninitialized constant PessoasController::Pessoa (NameError)
./app/controllers/pessoas_controller.rb:3:in `new'
./features/step_definitions/gerenciamento.rb:2:in `/^que eu esteja no cadastro de pessoas$/'
features/gerenciamento.feature:8:in `Dado que eu esteja no cadastro de pessoas'

Significa que ele não sabe o que é pessoa, ou seja, o modelo pessoa ainda não existe. Nesse momento devemos criá-lo, com o comando:

rails generate model pessoa nome:string idade:integer peso:float

Após isso faremos a migração para o banco novamente, para que a tabela pessoa seja criada:

rake db:migrate

Após esses comandos, executamos novamente rake cucumber e verificamos o seguinte erro:

Missing template pessoas/new with {:formats=>[:html], :handlers=>[:erb, :builder, :rjs, :rhtml, :rxml], :locale=>[:en, :en]} in view paths "/home/ricardo/trabalho/app/views" (ActionView::MissingTemplate)
/usr/lib/ruby/1.8/benchmark.rb:308:in `realtime'
./features/step_definitions/gerenciamento.rb:2:in `/^que eu esteja no cadastro de pessoas$/'
features/gerenciamento.feature:8:in `Dado que eu esteja no cadastro de pessoas'

Esse erro ocorre porque ainda não existe a visão correspondente para o usuário, ou seja, a página com o formulário para preenchimento dos dados de uma pessoa. Devemos criar esse arquivo na pasta app/views/pessoas com o nome new.html.erb e preenchê-lo com o formulário da seguinte forma:

Nova pessoa

<%= form_for(@pessoa) do |f| %>

    <%= f.label :nome %>
    <%= f.text_field :nome %>
  

    <%= f.label :idade %>
    <%= f.text_field :idade %>
  

    <%= f.label :peso %>
    <%= f.text_field :peso %>
  

    <%= f.submit "Cadastrar" %>
  

<% end %>

Ao terminar esse passo, o cucumber começará a passar em várias etapas, como indica a primeira linha do código abaixo.

....F-----

(::) failed steps (::)

The action 'create' could not be found for PessoasController (AbstractController::ActionNotFound)
./features/step_definitions/web_steps.rb:24:in `/^(?:|I )press "([^"]*)"$/'
features/gerenciamento.feature:12:in `E eu aperto "Cadastrar"'

Nesse momento, a execução irá parar no momento de submeter a página, pois, por padrão, o formulário é submetido para a função (action) create, e esta ainda não existe. Dessa forma, devemos criar essa função, logo abaixo da new, da seguinte forma:

 def create
    @pessoa = Pessoa.new(params[:pessoa])

    respond_to do |format|
      if @pessoa.save
        format.html { redirect_to(@pessoa, :notice => "Pessoa cadastrado com sucesso") }
      else
        format.html { render :action => "new" }
      end
    end
  end

Após pressionar o botão cadastrar, por padrão, o nossa action está redirecionando para a action show, que mostrará os dados da pessoa que acabamos de cadastrar. No entanto, como essa action ainda não existe, nos deparamos com o seguinte erro ao rodar rake cucumber novamente:

The action 'show' could not be found for PessoasController (AbstractController::ActionNotFound)
./features/step_definitions/web_steps.rb:24:in `/^(?:|I )press "([^"]*)"$/'
features/gerenciamento.feature:12:in `E eu aperto "Cadastrar"

Para consertar esse problema, devemos criar a action show no controlador de pessoas (pessoas_controller) como segue:

def show
    @pessoa = Pessoa.find(params[:id])
end

Feito isso, rodando rake cucubmer novamente encontramos o seguinte erro:

Missing template pessoas/show with {:formats=>[:html], :handlers=>[:erb, :builder, :rjs, :rhtml, :rxml], :locale=>[:en, :en]} in view paths "/home/ricardo/trabalho/app/views" (ActionView::MissingTemplate)
/usr/lib/ruby/1.8/benchmark.rb:308:in `realtime'
./features/step_definitions/web_steps.rb:24:in `/^(?:|I )press "([^"]*)"$/'
features/gerenciamento.feature:12:in `E eu aperto "Cadastrar"'

Vimos um erro parecido com esse anteriormente, que significa que ainda não existe a visão correspondente para a action show. Sendo assim, vamos corrigir esse erro criando o arquivo show.html.erb na pasta app/views/pessoas, com o seguinte conteúdo:

<%= notice %>


  Nome:
  <%= @pessoa.nome %>



  Idade:
  <%= @pessoa.idade %>



  Peso:
  <%= @pessoa.matricula %>

Nessa visão, na primeira linha, mostramos as mensagens vindas da action, nesse caso a mensagem Pessoa cadastrada com sucesso. Após isso mostramos os dados da pessoa da forma como queríamos ver no teste que fizemos. Feito isso, ao rodarmos rake cucumber novamente, temos o erro a seguir:

.........F

(::) failed steps (::)

expected the following element's content to include "Cadastrar nova pessoa":
Trabalho
Pessoa cadastrado com sucesso
  Nome:
  Ricardo
  Idade:
  24
  Peso:
  88.5
.
 is not true. (Test::Unit::AssertionFailedError)

Esse erro nos diz que está faltando mostrar a mensagem cadastrar nova pessoa, que era esperada no teste que fizemos. Obviamente, essa mensagem trata-se de um link para cadastrar novas pessoas. Para corrigir esse erro basta criarmos o link da forma mostrada a seguir, colocando no arquivo de visão show.html.erb. É possível ainda notar, que esse é o último passo e que, resolvendo esse erro, nosso cadastro estará completo e totalmente testado.

<%= link_to "Cadastrar nova pessoa", new_pessoa_path %>

Roando rake cucumber novamente, temos a mensagem abaixo, mostrando que todos os passos do nosso teste passaram. 1 cenário e 10 passos executados com sucesso:

ricardo@linuxmint ~/trabalho $ rake cucumber
(in /home/ricardo/trabalho)
bundle exec /usr/bin/ruby1.8 -I "/var/lib/gems/1.8/gems/cucumber-0.10.0/lib:lib" "/var/lib/gems/1.8/gems/cucumber-0.10.0/bin/cucumber"  --profile default
Using the default profile...
..........

1 scenario (1 passed)
10 steps (10 passed)
0m1.025s

Então pessoal, podemos notar que é um processo de execução do teste e correção dos erros que vão acontecendo até que tudo funcione corretamente. Espero que todos consigam chegar ao final desse tutorial com tudo executado.

Logo mais colocarei a especificação do nosso trabalho prático.

[]'s
Ricardo Viana

Extraia o arquivo que pegou para C:\Ruby e configurará a variável Path adicionando o caminho C:\Ruby\bin, da seguinte forma. Clique com o botão direito em meu computador e vá em propriedades. Após isso vá em Configurações avançadas do sistema e clique no botão variáveis de ambiente. Localize a variável Path (se não existir, crie uma) e adicione o caminho C:\Ruby\bin. Agora, siga para o passo 4.

Passo 1: Instalação do Ruby

Para que vocês possam começar a trabalhar com rails é necessário primeiro instalar o Ruby. Vamos baixar a versão 1.8.7 do seguinte endereço:

http://rubyforge.org/frs/download.php/73719/rubyinstaller-1.8.7-p330.exe

A instalação segue o padrão next, next, finish. Abaixo seguem as telas correspondentes, com o detalhe de atentar para marcar os dois checkboxes na última tela que farão a adição da pasta bin do ruby (C:\Ruby\bin) ao Path e fará a associação de arquivos com extensão .rb e .rbw com o interpretador ruby.

Passo 2: Instalação das bibliotecas

Para instalar bibliotecas no ruby usamos o aplicativo gem. As bilbiotecas que precisamos são, basicamente, o rails, o cucumber, o webrat e a biblioteca para acesso ao banco de dados. Vamos abrir um terminal: Iniciar-> Executar-> cmd, no Vista ou 7 digitem cmd no campo de busca do menu iniciar e pressionem enter. Nesse terminal iremos executar o seguinte comando:

gem install rails cucumber cucumber-rails webrat sqlite3-ruby

As bibliotecas serão baixadas da internet e instaladas no computador. Esse processo deve demorar um pouco, então, não fechem a janela ou coisa do tipo achando que está travado, ok?

Passo 3: O banco de dados

O banco de dados que usaremos será o sqlite3 (que é o banco de dados padrão do ruby), um banco de dados bem simples que só precisa de 2 arquivos para funcionar. Vamos baixar os arquivos do seguinte endereço:

http://www.sqlite.org/download.html

Baixaremos os arquivos:

http://www.sqlite.org/sqlite-shell-win32-x86-3070500.zip

http://www.sqlite.org/sqlite-dll-win32-x86-3070500.zip

Ao extrair esses arquivos teremos os arquivos: sqlite3.exe, sqlite3.dll, sqlite3.def. Colocaremos esses arquivos na pasta bin do ruby (C:\Ruby\bin), para facilitar nosso acesso a eles.

Passo 4: Criando uma aplicação simples

Vamos testar nossa instalação criando uma aplicação simples. Abriremos um terminal (cmd) e executaremos o seguinte comando:

rails new aplicativo

Será criada a pasta aplicativo com toda a estrutura necessária para a aplicação funcionar. Entraremos na pasta (cd aplicativo) e executaremos os seguintes comandos para criar um cadastro simples e verificar seu funcionamento:

rails generate scaffold pessoa nome:string idade:integer nascimento:date peso:float

(Esse comando cria o modelo, o controlador e as visões necessárias para um cadastro de pessoas funcionar)

rake db:create:all

(Cria os bancos de dados necessários para a aplicação (Ambientes de desenvolvimento, teste e produção))

rake db:migrate

(Migra os dados para o banco: nesse caso, cria a tabela pessoas)

Estamos prontos para ver a aplicação funcionando, para isso, devemos iniciar o servidor:

rails server

E acessar a página correspondente ao cadastro criado:

http://localhost:3000/pessoas

Devemos ver o cadastro completamente funcional, com os dados inseridos na execução do scaffold.

No próximo tutorial colocarei um passo a passo básico de utilização do cucumber.

[]‘s
Ricardo Viana

São pequenas dicas de códigos sobre ruby e rails postadas diariamente, muito legal.

http://rubyquicktips.tumblr.com/

[]‘s
Ricardo Viana

Site oficial: http://cukes.info/

Repositório no github: http://github.com/aslakhellesoy/cucumber

Video Caelum: http://blog.caelum.com.br/2009/10/15/screencast-ruby-on-rails-introducao-a-rspec-e-cucumber/

Blog do Diego Nogueira: http://diegonogueira.com.br/2009/07/25/materiais-sobre-cucumber/

Video vimeo: http://vimeo.com/1725411

Texto do blog do Urubatam: http://www.urubatan.com.br/cucumber-e-bdd-vantagens-para-a-empresa-argumentos-para-o-gerente-para-o-arquiteto-para-o-presidente-da-empresa/

Dois screencasts do railscasts sobre cucumber:
http://railscasts.com/episodes/155-beginning-with-cucumber
http://railscasts.com/episodes/159-more-on-cucumber

Na série de palestras de Carlos Brando: http://www.nomedojogo.com/palestras/
Assitam a todas, ou pelo menos ao de testes (só imaturos não testam), ele mostra uma abordagem inicial da utilização do RSpec e do Cucumber.

É isso, qualquer outro material que encontre posto aqui pra vocês.

[]‘s
Ricardo Viana