CODEWITHSUNDEEP
ruby-on-railsrubyruby-on-rails-3rspecinstance-variables
TradeRaider
TradeRaider

Reputation: 754

How do instance variables in rspec work?

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

Upvotes: 21

Views: 23485

Answers (3)

Victor Deryagin
Victor Deryagin

Reputation: 12215

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

Upvotes: 2

peakxu
peakxu

Reputation: 6675

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.

Upvotes: 34

Simone Carletti
Simone Carletti

Reputation: 176352

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).

Upvotes: 12

Related Questions