How do instance variables in rspec work?

Question

Here is a bit of code from M Hartl's Ruby on Rails Tutorial. Can anyone explain why an instance variable (@user) is necessary and why not use a local variable. Also, since instance variables are supposed to be the variables in the instance of a class, which class is @user instantiated from?

require 'spec_helper'

describe User do

  before { @user = User.new(name: "Example User", email: "[email protected]") }

  subject { @user }

  it { should respond_to(:name) }
  it { should respond_to(:email) }
end

peakxu · Accepted Answer · 2017-05-14 14:59:40Z

34

Use of a local variable in that instance would mean that its scope would be restricted to the before and hence result in an error. The @user is of type User but is an instance variable of the describe block. Rspec has some magic that at run-time makes a class out of each describe block. Each example (it block) ends up being a subclass of said class. Class inheritance lets the examples see @user.

Edited 2017-05-14

Linked blog post is no longer available. Updating with Wayback Machine link + inlining relevant section here.

Note that this is considered an anti-pattern as detailed in this blog post. Use let instead.

let has the following advantages:

It is memoized when used multiple times in one example, but not across examples.
It is lazy-loaded, so you wont waste time initializing the variable for examples that don't reference it.
Will raise an exception if you have a typo in your variable name.

edited May 14, 2017 at 14:59

answered Sep 28, 2012 at 18:18

peakxu

6,6951 gold badge31 silver badges27 bronze badges

Sign up to request clarification or add additional context in comments.

2 Comments

TradeRaider Over a year ago

Oh, I think I get it now. I always thought describe block was used to make the tests more readable to humans and nothing else. Thanks :)

keoghpe Over a year ago

That blog post is no longer available. It might be worth updating the answer to include reasons why using an instance variable is an antipattern and remove the broken link.

Simone Carletti · Accepted Answer · 2012-09-28 18:19:38Z

12

You can't use a local variable because a local variable exists only in the scope of the local method. before, subject and it generates different scopes within the same class.

The following code

before { user = User.new(name: "Example User", email: "[email protected]") }

will raise an undefined variable when you call it in

subject { user }

The instance @user is an instance of the class User (after all, you create it with User.new).

However, instead of instance variables you might want to use the let command. Also, if you define

subject { User.new(name: "Example User", email: "[email protected]") }

the use of before is not required. You'll also get the extra benefit to get a subject method available to access the instance, equal to define let(:subject).

answered Sep 28, 2012 at 18:19

Simone Carletti

177k50 gold badges371 silver badges370 bronze badges

2 Comments

Meltemi Over a year ago

+1 on using let: let(:user) { User.create(name: "Example User", email: "[email protected]") }

Luca G. Soave Over a year ago

+1 on using subject: subject { User.new(name: "Example User", email: "[email protected]") }

Nakilon · Accepted Answer · 2024-08-17 07:37:50Z

2

subject and it blocks are under different scopes, so local variables won't work. @user belongs to class generated by RSpec under the hood.

edited Aug 17, 2024 at 7:37

Nakilon

35.2k16 gold badges112 silver badges149 bronze badges

answered Sep 28, 2012 at 18:19

Victor Deryagin

12.3k1 gold badge32 silver badges38 bronze badges

Collectives™ on Stack Overflow

How do instance variables in rspec work?

3 Answers 3

2 Comments

2 Comments

Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

3 Answers 3

2 Comments

2 Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Related