sms-unit-test
This is a hard maintained fork of the sporadically maintained sms-spec. Unlike that gem, I hope to provide it a home with maintenance releases as necessary.
PRs are welcome, as are additional maintainers.
An RSpec DSL and Cucumber steps to test SMS interactions with your Ruby on Rails application.
Currently this gem only supports testing SMS messaging using the twilio-ruby and lookout-clickatell gem.
Setup
Add the sms-unit-test gem to Gemfile:
group :test do
gem "sms-unit-test"
endRSpec
Configure a driver and include helper and matcher methods in the spec_helper.rb:
require "sms_unit_test"
Spec::Runner.configure do |config|
config.include(SmsUnitTest::Helpers)
config.include(SmsUnitTest::Matchers)
end
SmsUnitTest.driver = :"twilio-ruby" #this can be any available sms-unit-test driverUsage
describe "alarm notifications" do
subject(:job) { AlarmNotificationJob.new }
context "via sms" do
let!(:subscription) { FactoryGirl.create :alarm_subscription_sms }
it "delivers an alarm notification" do
job.perform
open_last_text_message_for(subscription.recipient)
expect(current_text_message.body).to eq("Yo")
end
end
endCucumber
Add the following to env.rb:
require "sms_unit_test"
require "sms_unit_test/cucumber"This loads the sms_unit_test RSpec helpers into your cucumber wold. Then,
run the following to generate the text_messsage_steps.rb file:
rails generate sms_unit_test:stepsUsage
Feature: Registering via SMS
In order to use our application
As a user
I want to be able to register with any mobile phone
Scenario: A user submits their phone number for registration
Given I am on the homepage
And I fill in "What is your phone number?" with "6165552345"
When I press "Register"
Then I should see "Thank You"
And "6165552345" opens the text message
And I should see "Thank you for registering. To confirm your subscript reply YES." in the text message body