Roberto

Escrevi um pouco apressado, estarei viajando daqui a pouco e como já tinha uma parte no ‘draft’, resolvi publicar logo. :)

O código apresentado nos exemplos está utilizando os métodos da versão do RSpec 0.9, que foi lançado ontem na lista de usuários e o site do projeto ainda apresenta a versão 0.8.2(até o momento), porém nada complicado de “converter”.

Então, aqui vamos. :)

Pequena Introdução

Muito, e há muito tempo, tem se falado de Desenvolvimento orientado a Testes, ou TDD(Test-Driven Development). Metodologias, como a Extreme Programming, que fazem sua utilização, além de frameworks e ferramentas para as mais diversas linguagens. “Mas será que estamos fazendo corretamente? TDD é realmente sobre testes?”. Foram alguns dos questionamentos que levaram a Dave Astels e Dan North a criarem outra alternativa: BDD, Behaviour Driven Development, ou Desenvolvimento orientado a Comportamento. Notaram que experientes praticantes de TDD chegavam a um ponto que percebiam que não estavam escrevendo testes e sim definindo comportamentos. Tendo isso em mente, desenvolveram frameworks que permitissem um melhor foco nessas definições: JBehave e RSpec(tema deste post).

Instalando

gem install rspec

Possui algumas dependências como o rcov e o rake, acesse a documentação para outras.

Estrutura básica

#no "describe" descrevemos o que estamos especificando no momento
describe Carteira do 

    #este método é chamado antes de cada "it", pode ser utilizado para indicar um estado dos objetos envolvidos e mocks.
    setup do
        ...
    end

    #nos métodos "it" é onde realmente trabalhamos
    it "deve ter um método para entrada $" do
        ...
    end

    it "não deve estar vazia" {
        ...
    }

end

#podemos definir mais de um describe por arquivo.
describe Carteira, " (validações)" do #este describe resultaria em: "Carteira (validações)" 
    ...
end

Should e Expectations

O RSpec adiciona os métodos should(‘devia’) e should_not(‘não devia’) à Object, tornando disponível para qualquer objeto de sua aplicação (durantes os testes :) ):

#exemplos
carteira.should_not ...
post.should_not ...
post.save!.should ...

E também define um conjunto de Expectations(‘expectativas’) para que possamos definir os comportamentos esperados.

#exemplos
be_...(...)
have(...).(...)
raise_error(...)

‘Juntando’:

carteira.should_not be_a_kind_of(Carro)
#carteira não devia ser do tipo Carro

post.should_not have(3).comentarios
#post não deve ter 3 comentários

post.save!.should raise_error
#post.save! devia causar erro

A leitura flui melhor do que ‘assert aquilo’, não? :) Veja outros Expectations.

Exemplo

Como exemplo vamos definir o comportamento de Carteira.

Primeiro criamos o “esqueleto”:

#arquivo carteira_spec.rb
require 'carteira' #vamos criar mais abaixo
describe Carteira do

    setup do
        @carteira = Carteira.new
    end
end

Agora vamos para o primeiro comportamento:

• o valor inicial de dinheiro deve ser 0. :|

it "o valor inicial de dinheiro deve ser 0 :|" do
    @carteira.dinheiro.should == 0
    @carteira.dinheiro.should eql?(0) #alternativa 1
    @carteira.dinheiro.should be_zero #alternativa 2        
end

Três formas de (d)escrever. Na última o “be_zero” na verdade está utilizando o método “zero?” de dinheiro(Fixnum), servindo para qualquer ‘predicate’ (método terminado em ’?’). Ex: be_include (Array:include?), be_empty(String:empty?).

Mais dois comportamentos:

• o método ganho(x) deve incrementar o dinheiro em x. :)
• o método gasto(x) deve decrementar o dinheiro em x, lançar erro SemGranaError caso o valor for se tornar negativo. :(

it "o método ganho(x) deve incrementar o dinheiro em x. :)" do
    @carteira.ganho(3)
    @carteira.dinheiro.should == 3 #outra forma! =]        
end

it "o método gasto(x) deve decrementar o dinheiro em x, lançar erro SemGranaError caso o valor for se tornar negativo. :(" do
    lambda{ @carteira.gasto(3) }.should raise_error(SemGranaError)

    @carteira.ganho(3)
    @carteira.gasto(3).should == 0        
end

Fácil, não? Agora vamos criar nossa Carteira, para podermos executar os testes(?):

#arquivo carteira.rb
class Carteira

    attr_accessor :dinheiro

    def initialize
    end

    def ganho(dinheiro)
    end

    def gasto(dinheiro)
    end

end

Para executar: spec carteira_spec.rb. Como saída teremos:

FFF

1)
NoMethodError in 'Carteira o valor inicial de dinheiro deve ser 0 :|'
undefined method `dinheiro' for #<Carteira:0xb7c51270>
./carteira_spec.rb:10:

2)
NoMethodError in 'Carteira o método ganho(x) deve incrementar o dinheiro em x. :)'
undefined method `dinheiro' for #<Carteira:0xb7c3b484>
./carteira_spec.rb:17:

3)
NameError in 'Carteira o método gasto(x) deve decrementar o dinheiro em x, lançar erro SemGranaError caso o valor for se tornar negativo. :('
uninitialized constant SemGranaError
./carteira_spec.rb:21:

Finished in 0.009035 seconds

3 examples, 3 failures

Cada ‘F’ no início representa uma falha e cada tópico descreve uma falha. É interessante que tudo falhe na primeira vez, para sabermos que funcionou depois que implementamos (oras!).

Implementando a primeira especificação:

    def initialize
        @dinheiro = 0
    end

Executando(spec carteira_spec.rb), temos:

.FF

1)
'Carteira o método ganho(x) deve incrementar o dinheiro em x. :)' FAILED
expected 3, got 0 (using ==)
./carteira_spec.rb:17:

2)
NameError in 'Carteira o método gasto(x) deve decrementar o dinheiro em x, lançar erro SemGranaError caso o valor for se tornar negativo. :('
uninitialized constant SemGranaError
./carteira_spec.rb:21:

Finished in 0.008884 seconds

3 examples, 2 failures

“E cadê o que eu fiz?”. Virou um ’.’, aquele pontinho quer dizer que funcionou.

Finalizando implementando o resto:

#arquivo carteira.rb
class Carteira

    attr_accessor :dinheiro

    def initialize
        @dinheiro = 0
    end

    def ganho(dinheiro)
        @dinheiro = @dinheiro + dinheiro
    end

    def gasto(dinheiro)
        raise SemGranaError if (@dinheiro - dinheiro) < 0
        @dinheiro = @dinheiro - dinheiro
    end

end

class SemGranaError < StandardError

end

Saída:

...

Finished in 0.007725 seconds

3 examples, 0 failures

Experimente outras opções de formatação, para olhar as opções execute: spec – -help

Fim!

Gostou? Se sim, no próximo projeto utilize o RSpec, ou alguma ferramenta BDD ou TDD, seu aplicativo ficará saudável, não tem mais desculpa. (Não preparei nada para a alternativa ‘não’ :D ).

Já estou preparando posts sobre mock e rspec_on_rails.

Comporte-se e até a próxima.