Testando Rails apps com RSpec

testando rails
apps com rspec
nando vieira

sobre mim
• trabalho com web desde 1999
• desenvolvo com ruby desde 2006
• escrevo testes desde 2007
Ruby JavaScript Objective-C
PHP

minhas urls
• http://simplesideias.com.br
• http://howtocode.com.br
• http://spesa.com.br
• http://twitter.com/fnando
• http://github.com/fnando

Por que testar?
Para veriﬁcar se o sistema se comporta
como deveria.

Como testar?
Testes manuais.
Testes automatizados.

Testes automatizados
Trazem mais conﬁança.
Identiﬁcam regressões no código.
Permitem refatorar com segurança.

Testar antes ou depois?
Tanto faz.

Testar depois
Exige mais disciplina.
O código é mais difícil de testar.

a.k.a Test Driven Development
Testar antes
O código é mais simples de testar.
Geralmente é mais bem escrito.

Behavior Driven Development
Então surgiu o BDD
Desenvolver aplicações descrevendo seu
comportamento do ponto de vista do cliente.

BDD não é sobre testar o
código.

É sobre o design e
documentação do código.

É sobre escrever software
que é realmente importante.

Frameworks
Sua linguagem preferida deve ter um
framework BDD.
JBehave, PHPSpec, GSpec, JSpec, specs,
NSpec...

David Chelimsky Spec e Story
RSpec é um framework
BDD para Ruby e Rails.

http://rspec.info

Descreva o comportamento
como em uma conversa.

Eu: descreva uma palestra
Vocês:
• ela deve ter um palestrante.
• ela deve ter um tempo deﬁnido.
• ela deve ser interessante.

describe "My Talk" do
it "should be awesome" do
true.should be_true
end
end

Ruby on Rails
Use como plugin.
script/plugin install git://github.com/dchelimsky/rspec.git
script/plugin install git://github.com/dchelimsky/rspec-rails.git

Ruby on Rails
Use como gem.
gem install rspec
gem install rspec-rails

Ruby on Rails
Conﬁgure sua aplicação.
script/generate rspec

Ruby on Rails
Generators disponíveis.
script/generate
integration_spec, rspec, rspec_controller, rspec_model, rspec_scaffold

O que testar?
Tudo o que você julgar importante ser
testado.

Como testar?
Teste uma coisa de cada vez.
Acostume-se com o workﬂow.

Red
Escreva um teste que falhe

Green
Escreva a funcionalidade

Refactor
Refatore o código que passou

Rails Checklist
• Models
• Controllers
• Helpers
• Views
• E-mails
• Rake tasks
• JavaScript
• ...

Model
script/generate rspec_model user role:string --skip-ﬁxture

create app/models/user.rb
create spec/models/user_spec.rb
create db/migrate/20091104135200_create_users.rb

Model
spec/models/user_spec.rb
require 'spec_helper'

describe User do
before(:each) do
@valid_attributes = {

}
end

it "should create a new instance given valid attributes" do
User.create!(@valid_attributes)
end
end

Exemplo
Veriﬁcar se um usuário é admin.

describe User do
it "should be an admin" do
subject.role = "admin"
subject.should be_admin
end
end

Execute a suíte de testes
$ rake spec:models
F

1) NoMethodError in 'User should be an admin'
undefined method `admin?' for #<User id: nil, created_at: nil,
updated_at: nil>
active_record/attribute_methods.rb:255:in `method_missing'
./spec/models/user_spec.rb:5:

Finished in 0.088512 seconds

1 example, 1 failure

Faça o teste passar
app/models/user.rb

class User < ActiveRecord::Base
def admin?
true
end
end

$ rake spec:models

.


1 example, 0 failures

Adicione um teste negativo

describe User do
it "should be an admin" do
subject.role = "admin"
subject.should be_admin
end

it "should not be admin" do
subject.should_not be_admin
end
end

$ rake spec:models
.F

1)
'User should not be admin' FAILED
expected admin? to return false, got true
./spec/models/user_spec.rb:10:


2 examples, 1 failure

app/models/user.rb

class User < ActiveRecord::Base
def admin?
role == "admin"
end
end

Model
Coisas mais comuns
it "should be valid" do
subject.should be_valid
end

it "should have errors" do
subject.should have(1).error_on(:role)
subject.should have(2).errors_on(:role)
end

it "should have no errors" do
subject.should have(:no).error_on(:role)
end

it "should have records" do
User.should have(1).record
User.should have(2).records
end

Controller
script/generate rspec_controller users
create spec/controllers/users_controller_spec.rb
create spec/helpers/users_helper_spec.rb
create app/controllers/users_controller.rb
create app/helpers/users_helper.rb

Controller
spec/controllers/users_controller_spec.rb

describe UsersController do

#Delete this example and add some real ones
it "should use UsersController" do
controller.should be_an_instance_of(UsersController)
end

end

Exemplo
Criar um novo usuário.
class UsersController < ApplicationController
def new
@user = User.new
end

def create
@user = User.new(params[:user])

if @user.save
flash[:notice] = "A new user has been created!"
redirect_to @user
end
end
end


context "GET: new" do
it "should instantiate user" do
assigns[:user].should be_a_kind_of(User)
end
end
end

$ rake spec:controllers

F

1) 'UsersController GET: new should instantiate user' FAILED
expected nil to be a kind of User(id: integer, role: string,
created_at: datetime, updated_at: datetime)



app/controllers/users_controller.rb

def new
@user = User.new
end
end


.



Escreva o próximo teste

describe "POST: create" do
context "on success" do
it "should create user with provided arguments" do
user = mock_model(User).as_null_object
User.should_receive(:new).with("role" => "editor").and_return(user)
post :create, :user => {:role => "editor"}
end
end
end
end

F

1) Spec::Mocks::MockExpectationError in 'UsersController POST:
create on success should create user with provided arguments'
<User(id: integer, role: string, created_at: datetime,
updated_at: datetime) (class)> expected :new with
({"role"=>"editor"}) once, but received it 0 times


4 examples, 3 failures


def create
end
end


..




it "should redirect to the show page" do
response.should redirect_to(user_url(assigns[:user]))
end
end
end
end


F

1) 'UsersController POST: create on success should redirect to
the show page' FAILED
expected redirect to "http://test.host/users/1", got no redirect




def create

if @user.save
redirect_to @user
end
end
end


.....F




it "should set success message" do
flash[:notice].should == "A new user has been created!"
end
end
end
end

F

1) 'UsersController POST: create on success should set success
message' FAILED
expected: "A new user has been created!",
got: nil (using ==)


5 examples, 1 failure

def create

if @user.save
flash[:notice] = "A new user has been created!"
redirect_to @user
end
end
end


.......


7 examples


context "on failure" do
it "should not redirect" do
user = mock_model(User)
user.should_receive(:save).and_return(false)
User.should_receive(:new).and_return(user)
post :create

response.should_not be_redirect
end
end
end
end

Helper
É gerado quando um controller é criado

describe UsersHelper do
#Delete this example and add some real ones or delete this file
it "should be included in the object returned by #helper" do
included_modules = (class << helper; self; end).send :included_modules
included_modules.should include(UsersHelper)
end

end

Exemplo
Exibir conteúdo para usuários admin.
<% content_for_admin(@user) do %>

<% end %>

spec/helpers/users_helper_spec.rb

describe UsersHelper do
describe "#content_for_admin" do
it "should display content for admins" do
user = User.new(:role => "admin")
content = helper.content_for_admin(user) { "content" }
content.should == "content"
end
end
end

$ rake spec:helpers
F

1) NoMethodError in 'UsersHelper#content_for_admin should display
content for admins'
undefined method `content_for_admin' for
#<Spec::Rails::Example::HelperExampleGroup::HelperObject:
0x1030c2138>



app/helpers/users_helper.rb

module UsersHelper
def content_for_admin(user, &block)
yield if user.admin?
end
end

$ rake spec:helpers

.



Views
Teste a semântica e não o código gerado.
É difícil escrever testes antes do markup.
Utilize stubs & mocks!
Sem exemplos!

Duas coisas que você deve
tirar desta palestra
Tente de verdade se acostumar ao workﬂow RED-
GREEN-REFACTOR.

Crie testes tão rápido quanto possível.
Ou você não irá escrever testes.

Saiba mais sobre
RSpec http://rspec.info
Cucumber http://cukes.info
Factory Girl http://bit.ly/4EicvV

one more thing

compra agora!
http://howtocode.com.br

obrigado
nando@simplesideias.com.br

Testando Rails apps com RSpec

Mais conteúdo relacionado

Mais procurados (20)

Semelhante a Testando Rails apps com RSpec (20)

Mais de Nando Vieira (7)

Testando Rails apps com RSpec