[Ruby on Rails](https://rubyonrails.org/) has special helper methods that allow you to test instance variables in your app’s [views](http://guides.rubyonrails.org/action_view_overview.html) and [controllers](http://guides.rubyonrails.org/action_controller_overview.html). These are assign and assigns, which stores a hash of the instance variables you can access in your [RSpec](http://rspec.info/) tests.

This tutorial will guide you through how to write a simple controller and view with corresponding tests. These will cover assigning instance variables depending on whether certain conditions are met.

*   [How assign and assigns work](#7faa)
*   [Controller tests](#9b6e)
*   [View tests](#74a8)
*   [Learn more](#0d16)

### How assign and assigns works

If you want to set a controller or view’s instance variables in your RSpec test, then call assign either in a before block or at the start of an example group. The first argument is the name of the instance variable while the second is the value you want to assign to it.

    before do
      assign(:message, 'great test!')
    end

Call its counterpart assigns to examine the instance variables that have been set.

    assigns(:message) => 'great test!'

_Note: According to_ [_RSpec-Rails_](https://github.com/rspec/rspec-rails)_, in Rails 5.x, controller testing has been moved to its own gem which is_ [_rails-controller-testing_](https://github.com/rails/rails-controller-testing)_. Using_ _assigns in your controller specs without adding this gem will no longer work._

![](https://hackernoon.com/hn-images/1*KvQSuNYPmZ-IPIGrb-D4og.png)

### Controller tests

Ruby on Rails RSpec includes the helper method controller to call the [Controller](http://guides.rubyonrails.org/action_controller_overview.html) being tested.

Here is an example of a controller action that sets an instance variable depending on parameters sent to it.

    class MessageController < ApplicationController

      def show
        if params[:message]
          @message = params[:message]
        end
      end

    end

Then you can test this using RSpec. Divide your tests into contexts for the conditions that determine whether the assignment should happen. The first one is when the message is missing from the parameters.

    context 'when params[:message] is not present' do
      before { post :show }

      it 'does not assign a message' do

        expect(assigns(:message)).to be_nil

      end
    end

And this is the test context for when the message is present in the parameters posted to the controller action.

    context 'when params[:message] is present' do
      before { post :show, { message: 'great test!' } }

      it 'assigns the message from params' do 
          
        expect(assigns(:message)).to eq ‘great test!’

      end
    end

![](https://hackernoon.com/hn-images/1*RspplX0V2CtUZmun6Sbl0w.png)

### View tests

To test [Ruby on Rails views](http://guides.rubyonrails.org/layouts_and_rendering.html), you place the test in the matching spec path as the the view in the app folder, then start your [RSpec.describe](https://relishapp.com/rspec/rspec-core/v/3-6/docs/example-groups/basic-structure-describe-it) block with the view file path.

The view helper method render produced the view’s rendered HTML, which can be accessed with its corresponding helper method [rendered](https://relishapp.com/rspec/rspec-rails/v/2-0/docs/view-specs/view-spec).

If you had a view file called index.html.erb that included code, such as <h1> <%= @message %> </h1>, then this is how you can test the assignment to the variable.

    require 'spec_helper'

    RSpec.describe 'views/index.html.erb'
      before do
        assign(:message, 'great test!')
        render
      end

    it 'should display the message' do
        expect(rendered).to include 'great test!'
      end
    end

### Learn more

Writing effective tests not only will give you confidence in the intended outcome of your tests but also guide you on how it really works, including discovering and ironing out bugs.

To find out more about how you can write readable tests that cover the core functionality of Rails, check out [RSpec for Ruby on Rails](https://github.com/rspec/rspec-rails)’ other helper methods, for example that cover redirections and aspects of ActiveRecord models.

#### Read more from [ryanwhocodes](https://medium.com/u/657e01f7428a)

*   [5 tips to speed up testing using rspec and ruby on rails](https://hackernoon.com/5-rspec-tips-to-speed-up-testing-ruby-on-rails-projects-db8759a20869?source=email-657e01f7428a-1527536943601-activity.collection_post_approved)
*   [Testing private methods in Ruby using Rspec](https://medium.freecodecamp.org/testing-private-methods-in-ruby-using-rspec-c3d429fcd25a)
*   [Display your Ruby test coverage using SimpleCov gem and CodeClimate](https://hackernoon.com/display-your-ruby-test-coverage-using-simplecov-gem-and-codeclimate-6db6336fe409)

#### Read more

*   [RSpec for Ruby on Rails on Github](https://github.com/rspec/rspec-rails)
*   [Rails Controller Testing gem on Github](https://github.com/rails/rails-controller-testing)
*   [RSpec docs](https://relishapp.com/rspec)

Too Long; Didn't Read

Build an AI-based text classifier with Tensorflow & NoSQL

Assigns in Ruby on Rails — How you can test instance variables in views and controllers

Too Long; Didn't Read

@ryanwhocodes

RELATED STORIES