Agile Web Development with Rails, Edition 5

13.3 Playtime 13.1 Iteration H1: Email Notifications

13.2 Iteration H2: Integration Tests

Create an integration test

rails generate integration_test user_stories
      invoke  test_unit
      create    test/integration/user_stories_test.rb
edit test/integration/user_stories_test.rb
require 'test_helper'
 
class UserStoriesTest < ActionDispatch::IntegrationTest
  fixtures :products
  include ActiveJob::TestHelper
 
  # A user goes to the index page. They select a product, adding it to their
  # cart, and check out, filling in their details on the checkout form. When
  # they submit, an order is created containing their information, along with a
  # single line item corresponding to the product they added to their cart.
  
  test "buying a product" do
    start_order_count = Order.count
    ruby_book = products(:ruby)
 
    get "/"
    assert_response :success
    assert_select 'h1', "Your Pragmatic Catalog"
    
    post '/line_items', params: { product_id: ruby_book.id }, xhr: true
    assert_response :success 
    
    cart = Cart.find(session[:cart_id])
    assert_equal 1, cart.line_items.size
    assert_equal ruby_book, cart.line_items[0].product
    
    get "/orders/new"
    assert_response :success
    assert_select 'legend', 'Please Enter Your Details'
    
    perform_enqueued_jobs do
      post "/orders", params: {
        order: {
          name:     "Dave Thomas",
          address:  "123 The Street",
          email:    "dave@example.com",
          pay_type: "Check"
        }
      }
 
      follow_redirect!
 
      assert_response :success
      assert_select 'h1', "Your Pragmatic Catalog"
      cart = Cart.find(session[:cart_id])
      assert_equal 0, cart.line_items.size
    
      assert_equal start_order_count + 1, Order.count
      order = Order.last
      
      assert_equal "Dave Thomas",      order.name
      assert_equal "123 The Street",   order.address
      assert_equal "dave@example.com", order.email
      assert_equal "Check",            order.pay_type
      
      assert_equal 1, order.line_items.size
      line_item = order.line_items[0]
      assert_equal ruby_book, line_item.product
 
      mail = ActionMailer::Base.deliveries.last
      assert_equal ["dave@example.com"], mail.to
      assert_equal 'Sam Ruby <depot@example.com>', mail[:from].value
      assert_equal "Pragmatic Store Order Confirmation", mail.subject
    end
  end
end

Run the tests

rails test:integration
Run options: --seed 37866
 
# Running:
 
.
 
Finished in 0.779666s, 1.2826 runs/s, 25.6520 assertions/s.
 
1 runs, 20 assertions, 0 failures, 0 errors, 0 skips

Create an integration test using a DSL

rails generate integration_test dsl_user_stories
      invoke  test_unit
      create    test/integration/dsl_user_stories_test.rb
edit test/integration/dsl_user_stories_test.rb
require 'test_helper'
 
class DslUserStoriesTest < ActionDispatch::IntegrationTest
  fixtures :products
  include ActiveJob::TestHelper
 
  DAVES_DETAILS = {
      name:     "Dave Thomas",
      address:  "123 The Street",
      email:    "dave@example.com",
      pay_type: "Check"
  }
 
  MIKES_DETAILS = {
      name:     "Mike Clark",
      address:  "345 The Avenue",
      email:    "mike@pragmaticstudio.com",
      pay_type: "Credit card"
  }
    
  def setup
    LineItem.delete_all
    Order.delete_all
    @ruby_book = products(:ruby)
    @rails_book = products(:two)
  end 
  
  # A user goes to the store index page. They select a product,
  # adding it to their cart. They then check out, filling in
  # their details on the checkout form. When they submit,
  # an order is created in the database containing
  # their information, along with a single line item
  # corresponding to the product they added to their cart.
  
  def test_buying_a_product
    perform_enqueued_jobs do
      dave = regular_user
      dave.get "/"
      dave.is_viewing "Your Pragmatic Catalog"
      dave.buys_a @ruby_book
      dave.has_a_cart_containing @ruby_book
      dave.checks_out DAVES_DETAILS
      dave.is_viewing "Your Pragmatic Catalog"
      check_for_order DAVES_DETAILS, @ruby_book
    end
  end
 
  def test_two_people_buying
    perform_enqueued_jobs do
      dave = regular_user
        mike = regular_user
      dave.buys_a @ruby_book
        mike.buys_a @rails_book
      dave.has_a_cart_containing @ruby_book
      dave.checks_out DAVES_DETAILS
        mike.has_a_cart_containing @rails_book
      check_for_order DAVES_DETAILS, @ruby_book
        mike.checks_out MIKES_DETAILS
        check_for_order MIKES_DETAILS, @rails_book
    end
  end
  
  def regular_user
    open_session do |user|
      def user.is_viewing(page)
        assert_response :success
        assert_select 'h1', page
      end
    
      def user.buys_a(product)
        post '/line_items', params: { product_id: product.id }, xhr: true
        assert_response :success 
      end
    
      def user.has_a_cart_containing(*products)
        cart = Cart.find(session[:cart_id])
        assert_equal products.size, cart.line_items.size
        cart.line_items.each do |item|
          assert products.include?(item.product)
        end
      end
    
      def user.checks_out(details)
        get "/orders/new"
        assert_response :success
        assert_select 'legend', 'Please Enter Your Details'
 
        post "/orders", params: {
          order: { 
            name:     details[:name],
            address:  details[:address],
            email:    details[:email],
            pay_type: details[:pay_type]
          }
        }
 
        follow_redirect!
 
        assert_response :success
        self.is_viewing "Your Pragmatic Catalog"
        cart = Cart.find(session[:cart_id])
        assert_equal 0, cart.line_items.size
      end
    end  
  end
  
  def check_for_order(details, *products)
    order = Order.find_by_name(details[:name])
    assert_not_nil order
    
    assert_equal details[:name],     order.name
    assert_equal details[:address],  order.address
    assert_equal details[:email],    order.email
    assert_equal details[:pay_type], order.pay_type
    
    assert_equal products.size, order.line_items.size
    for line_item in order.line_items
      assert products.include?(line_item.product)
    end
 
    mail = ActionMailer::Base.deliveries.last
    assert_equal order.email, mail.to.first
    for line_item in order.line_items
      assert_includes mail.body.to_s, line_item.product.title
    end
  end
end

Run the tests

rails test:integration
Run options: --seed 49367
 
# Running:
 
...
 
Finished in 0.961823s, 3.1191 runs/s, 51.9846 assertions/s.
 
3 runs, 50 assertions, 0 failures, 0 errors, 0 skips

13.3 Playtime 13.1 Iteration H1: Email Notifications