sms-unit-test 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6ab8546f2e10a07343012bf3793c5b9ee3d38f54
+  data.tar.gz: 52e5937e427649c65831d837d1c8782def64489d
+SHA512:
+  metadata.gz: 8e9d16c94cb3d47044efbef8a848173820ed5a615708db085e69802cddc9c6e7b9eb17536169eeb674f5267a4984c34f61bb216c315391317816e0955499411a
+  data.tar.gz: 75ec3cab06219c27f613d83c66c5e1b48d0cb102e954858538943a6654ac9965f0b6875f24efe6b858ee9f7e525201d1a4374056fbde576cf838645c342fae6c

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.rvmrc

data/.ruby-gemset

@@ -0,0 +1 @@
+sms-unit-test

data/.ruby-version

@@ -0,0 +1 @@
+2.4.1

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 2.4.1
+
+script: rake

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in text_spec.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,5 @@
+guard 'rspec', :cli => "--color", :notification => true do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2017-present Kevin Ross
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,90 @@
+# sms-unit-test
+
+[![Build Status](https://travis-ci.org/rosskevin/sms-unit-test.svg)](https://travis-ci.org/rosskevin/sms-unit-test)
+[![Code Climate](https://codeclimate.com/github/rosskevin/sms-unit-test/badges/gpa.svg)](https://codeclimate.com/github/rosskevin/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](https://github.com/twilio/twilio-ruby) and
+[lookout-clickatell](https://github.com/lookout/clickatell) gem.
+
+## Setup
+Add the sms-unit-test gem to `Gemfile`:
+
+```ruby
+group :test do
+  gem "sms-unit-test"
+end
+```
+
+## RSpec
+Configure a driver and include helper and matcher methods in the `spec_helper.rb`:
+
+```ruby
+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 driver
+```
+
+### Usage
+
+```ruby
+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
+end
+```
+
+## Cucumber
+Add the following to `env.rb`:
+
+```ruby
+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:
+
+```ruby
+rails generate sms_unit_test:steps
+```
+
+### Usage
+
+```ruby
+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
+```

data/Rakefile

@@ -0,0 +1,7 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+

data/lib/generators/sms_spec/steps/USAGE

@@ -0,0 +1,6 @@
+Description:
+    Creates text_message_steps.rb in your cucumber step_definitions.
+    
+Examples:
+    `script/rails generate text_spec:steps`
+

data/lib/generators/sms_spec/steps/steps_generator.rb

@@ -0,0 +1,14 @@
+require 'rails/generators'
+
+module SmsUnitTest
+  class StepsGenerator < Rails::Generators::Base
+    def generate
+      copy_file 'sms_steps.rb', 'features/step_definitions/sms_steps.rb'
+    end
+
+    def self.source_root
+      File.join(File.dirname(__FILE__), 'templates')
+    end
+  end
+end
+

data/lib/generators/sms_spec/steps/templates/sms_steps.rb

@@ -0,0 +1,40 @@
+# -------------------------------------------
+# Available methods
+# -------------------------------------------
+
+# messages
+# add_message
+# set_current_number
+# current_number
+# clear_messages
+# current_text_message
+# open_last_text_message_for
+
+
+Given /^no text messages have been sent$/ do
+  clear_messages
+end
+
+Given /^all text messages have been read$/ do
+  clear_messages
+end
+
+Then /^"([^"]*)" should receive a text message$/ do |phone_number|
+  expect(messages_for(phone_number)).to_not be_empty
+end
+
+Then /^"([^"]*)" should receive no text messages$/ do |phone_number|
+  expect(messages_for(phone_number)).to be_empty
+end
+
+When /^"([^"]*?)" opens? the text message$/ do |mobile_number|
+  open_last_text_message_for(mobile_number)
+end
+
+Then /^I should see "([^"]*)" in the text message body$/ do |content|
+  expect(current_text_message).to have_body(content)
+end
+
+Then /^I should see the following in the text message body:$/ do |content|
+  expect(current_text_message).to have_body(content)
+end

data/lib/sms-unit-test.rb

@@ -0,0 +1 @@
+require 'sms_unit_test'

data/lib/sms_unit_test.rb

@@ -0,0 +1,15 @@
+require 'rspec/core'
+require 'rspec/expectations'
+require 'rspec/mocks'
+require 'sms_unit_test/version'
+require 'sms_unit_test/helpers'
+require 'sms_unit_test/data'
+require 'sms_unit_test/message'
+require 'sms_unit_test/mobile_device'
+require 'sms_unit_test/matchers'
+
+module SmsUnitTest
+  def self.driver=(driver_sym)
+    require "sms_unit_test/drivers/#{driver_sym.to_s}"
+  end
+end

data/lib/sms_unit_test/cucumber.rb

@@ -0,0 +1,6 @@
+After do
+  SmsUnitTest::Data.clear_messages
+end
+
+World(SmsUnitTest::Helpers)
+World(SmsUnitTest::Matchers)

data/lib/sms_unit_test/data.rb

@@ -0,0 +1,38 @@
+module SmsUnitTest
+  class Data
+    def self.add_message message
+      @@messages ||= []
+      @@messages << message
+    end
+
+    def self.clear_messages
+      @@messages = []
+      @@current_text_message = nil
+    end
+
+    def self.messages
+      @@messages ||= []
+    end
+
+    def self.set_current_number(number)
+      @@current_number = number
+    end
+
+    def self.current_number
+      @@current_number
+    end
+
+    def self.current_text_message
+      @@current_text_message ||= nil
+    end
+
+    def self.open_last_text_message_for(phone_number)
+      message = messages_for(phone_number).first
+      @@current_text_message = messages.delete(message)
+    end
+
+    def self.messages_for(phone_number)
+      messages.select { |m| m.number == phone_number }
+    end
+  end
+end

data/lib/sms_unit_test/drivers/clickatell.rb

@@ -0,0 +1,20 @@
+module Clickatell
+  class API
+    include SmsUnitTest::Helpers
+
+    def self.authenticate(api_key, login, password)
+      new(api_key, login, password)
+    end
+
+    def initialize(api_key, login, password)
+      @api_key = api_key
+      @login = login
+      @password = password
+    end
+
+    def send_message(dest, body, opts={})
+      from = opts[:from]
+      add_message SmsUnitTest::Message.new(:number => dest, :from => from, :body => body)
+    end
+  end
+end

data/lib/sms_unit_test/drivers/twilio-ruby.rb

@@ -0,0 +1,89 @@
+begin
+  require 'twilio-ruby'
+rescue LoadError
+  puts 'WARNING: Twilio is not loaded properly. Ensure to add "twilio-ruby" to your Gemfile before using this driver'
+end
+
+module Twilio
+  extend SingleForwardable
+
+  def_delegators :configuration, :account_sid, :auth_token
+
+  ##
+  # Pre-configure with account SID and auth token so that you don't need to
+  # pass them to various initializers each time.
+  def self.configure(&block)
+    yield configuration
+  end
+
+  ##
+  # Returns an existing or instantiates a new configuration object.
+  def self.configuration
+    @configuration ||= Util::Configuration.new
+  end
+  private_class_method :configuration
+
+  module REST
+    class Client
+
+      def initialize(*args)
+        # mimic the primary class's #initialize.
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        @config = options #DEFAULTS.merge! options
+
+        @account_sid = args[0] || Twilio.account_sid
+        @auth_token = args[1] || Twilio.auth_token
+        if @account_sid.nil? || @auth_token.nil?
+          raise ArgumentError, 'Account SID and auth token are required'
+        end
+      end
+
+      class Messages
+        include SmsUnitTest::Helpers
+
+        def create(opts={})
+          to = opts[:to]
+          body = opts[:body]
+          from = opts[:from]
+          add_message SmsUnitTest::Message.new(:number => to, :from => from, :body => body)
+        end
+      end
+
+      class Account
+        def sms
+          Sms.new
+        end
+
+        def messages
+          Messages.new
+        end
+      end
+
+      def account
+        account = Account.new
+      end
+
+
+      ## Mirror method_missing approach
+      ##
+      # Delegate account methods from the client. This saves having to call
+      # <tt>client.account</tt> every time for resources on the default
+      # account.
+      def method_missing(method_name, *args, &block)
+        if account.respond_to?(method_name)
+          account.send(method_name, *args, &block)
+        else
+          super
+        end
+      end
+
+      def respond_to?(method_name, include_private=false)
+        if account.respond_to?(method_name, include_private)
+          true
+        else
+          super
+        end
+      end
+    end
+  end
+end

data/lib/sms_unit_test/helpers.rb

@@ -0,0 +1,49 @@
+require 'forwardable'
+
+module SmsUnitTest
+  module Helpers
+    extend Forwardable
+    
+    def_delegators :"SmsUnitTest::Data",
+      :messages,
+      :add_message,
+      :set_current_number,
+      :current_number,
+      :clear_messages,
+      :current_text_message,
+      :messages_for,
+      :open_last_text_message_for
+
+    def twiml_message(from, body, opts={})
+      base_options = {
+        "AccountSid"=>"1234567812345678",
+        "Body"=> body,
+        "ToZip"=>"94949",
+        "FromState"=>"MI",
+        "ToCity"=>"NOVATO",
+        "SmsSid"=>"1234567812345678",
+        "ToState"=>"CA",
+        "To"=>"8155552671",
+        "ToCountry"=>"US",
+        "FromCountry"=>"US",
+        "SmsMessageSid"=>"123456712345671234567",
+        "ApiVersion"=>"2008-08-01",
+        "FromCity"=>"GRAND RAPIDS",
+        "SmsStatus"=>"received",
+        "From"=> from,
+        "FromZip"=>"49507"
+      }
+
+      base_options.merge! opts
+    end
+
+    def clkatel_message(from, text, opts={})
+      base_options = {
+        "From"=> from,
+        "Text" => text
+      }
+
+      base_options.merge! opts
+    end
+  end
+end

data/lib/sms_unit_test/matchers.rb

@@ -0,0 +1,41 @@
+module SmsUnitTest
+  module Matchers
+
+    RSpec::Matchers.define :have_text_messages do
+      match do |mobile_device|
+        mobile_device.messages.count > 0
+      end
+
+      if Gem::Version.new(RSpec::Core::Version::STRING) >= Gem::Version.new("3.0.0.beta2")
+        failure_message do |mobile_device|
+          "expected the mobile device '#{mobile_device.number}' to have text messages but it did not"
+        end
+
+        failure_message_when_negated do |mobile_device|
+          "expected the mobile device '#{mobile_device.number}' to have no text messages but it did"
+        end
+      else
+        failure_message_for_should do |mobile_device|
+          "expected the mobile device '#{mobile_device.number}' to have text messages but it did not"
+        end
+
+        failure_message_for_should_not do |mobile_device|
+          "expected the mobile device '#{mobile_device.number}' to have no text messages but it did"
+        end
+      end
+    end
+
+    RSpec::Matchers.define :have_body do |expected_body|
+      match do |message|
+        message.body == expected_body
+      end
+    end
+
+    RSpec::Matchers.define :have_body_like do |expected_body|
+      match do |message|
+        message.body.match(expected_body)
+      end
+    end
+
+  end
+end

data/lib/sms_unit_test/message.rb

@@ -0,0 +1,13 @@
+module SmsUnitTest
+  class Message
+    attr_accessor :number
+    attr_accessor :body
+    attr_accessor :from
+
+    def initialize(opts = {})
+      @number = opts[:number]
+      @body = opts[:body]
+      @from = opts[:from]
+    end
+  end
+end

data/lib/sms_unit_test/mobile_device.rb

@@ -0,0 +1,12 @@
+module SmsUnitTest
+  class MobileDevice
+
+    def initialize(number)
+      @number = number
+    end
+
+    def messages
+      SmsUnitTest::Data.messages.select {|d| d.number == @number}
+    end
+  end
+end

data/lib/sms_unit_test/version.rb

@@ -0,0 +1,3 @@
+module SmsUnitTest
+  VERSION = '1.0.1'
+end

data/rails_generators/sms_unit_test/templates/sms_steps.rb

@@ -0,0 +1,49 @@
+# -------------------------------------------
+# Available methods
+# -------------------------------------------
+
+# messages
+# add_message
+# set_current_number
+# current_number
+# clear_messages
+# current_text_message
+# open_last_text_message_for
+
+
+Given /^no text messages have been sent$/ do
+  clear_messages
+end
+
+Given /^all text messages have been read$/ do
+  clear_messages
+end
+
+Then /^"([^"]*)" should receive a text message$/ do |phone_number|
+  messages_for(phone_number).should_not be_empty
+end
+
+Then /^"([^"]*)" should receive no text messages$/ do |phone_number|
+  messages_for(phone_number).should be_empty
+end
+
+When /^"([^"]*?)" opens? the text message$/ do |mobile_number|
+  open_last_text_message_for(mobile_number)
+end
+
+Then /^I should see "([^"]*)" in the text message body$/ do |content|
+  current_text_message.should have_body(content)
+end
+
+Then /^I should see the following in the text message body:$/ do |content|
+  current_text_message.should have_body(content)
+end
+
+Then /^I should see "([^"]*)" somewhere in the text message body$/ do |content|
+  current_text_message.should have_body_like(content)
+end
+
+Then /^I should see the following somewhere in the text message body:$/ do |content|
+  current_text_message.should have_body_like(content)
+end
+

data/rails_generators/sms_unit_test_generator.rb

@@ -0,0 +1,12 @@
+class SmsUnitTestGenerator < Rails::Generator::Base
+  def manifest
+    m.directory 'features/step_definitions'
+    m.file 'sms_steps.rb', 'features/step_definitions/sms_steps.rb'
+  end
+
+  protected
+
+  def banner
+    "Usage: #{0} sms_unit_test"
+  end
+end

data/sms-unit-test.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path('../lib', __FILE__)
+require 'sms_unit_test/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'sms-unit-test'
+  s.version     = SmsUnitTest::VERSION
+  s.authors     = ['Kevin Ross']
+  s.email       = ['kevin.ross@alienfast.com']
+  s.homepage    = 'https://github.com/rosskevin/sms-unit-test'
+  s.summary     = %q{Test SMS interactions with RSpec and Cucumber}
+  s.description = %q{SMS Spec gives you an RSpec DSL and Cucumber steps to test SMS interactions.}
+
+  s.rubyforge_project = 'sms-unit-test'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ['lib']
+
+  s.add_dependency 'rspec', '~> 3.1'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'twilio-ruby', '~> 4.2'
+  s.add_development_dependency 'lookout-clickatell', '~> 0.8'
+  s.add_development_dependency 'pry'
+end

data/spec/drivers/clickatell_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe SmsUnitTest do
+  include SmsUnitTest::Helpers
+
+  before do
+    SmsUnitTest.driver = :"clickatell"
+    @to_number   = '27999900001' # TEST NUMBER
+    @from_number = '27999900005' # TEST NUMBER
+    @api = Clickatell::API.authenticate(
+      ENV["CLICKATELL_API_KEY"],
+      ENV["CLICKATELL_LOGIN"],
+      ENV["CLICKATELL_PASSWORD"]
+    )
+
+    SmsUnitTest::Data.clear_messages
+  end
+
+  describe "the clickatell driver" do
+    it "captures the outgoing message for testing" do
+      @api.send_message(@to_number, 'Hello from clickatell')
+      open_last_text_message_for(@to_number)
+
+      expect(current_text_message).to have_body("Hello from clickatell")
+      expect(current_text_message.number).to eql(@to_number)
+      expect(current_text_message.from).to be_nil
+    end
+
+  end
+end
+

data/spec/drivers/twilio_spec.rb

@@ -0,0 +1,100 @@
+require 'spec_helper'
+
+describe 'twilio-ruby' do
+  include SmsUnitTest::Helpers
+  SmsUnitTest.driver = :'twilio-ruby'
+
+  before :each do
+    SmsUnitTest::Data.clear_messages
+  end
+
+  context 'instantiation options' do
+
+    before :each do
+      @account_sid = 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
+      @auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
+      @client = nil
+    end
+
+    it 'with two args' do
+      @client = Twilio::REST::Client.new @account_sid, @auth_token
+      expect(@client).to_not be_nil
+    end
+
+    it 'with config' do
+      Twilio.configure do |config|
+        config.account_sid = @account_sid
+        config.auth_token = @auth_token
+      end
+      @client = Twilio::REST::Client.new
+      expect(@client).to_not be_nil
+    end
+  end
+
+
+  context 'using method_missing approach' do
+
+    before do
+      @account_sid = 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
+      @auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
+      Twilio.configure do |config|
+        config.account_sid = @account_sid
+        config.auth_token = @auth_token
+      end
+      @client = Twilio::REST::Client.new
+    end
+
+    it 'intercepts calls to twilio sms client' do
+      @client.messages.create(
+          :from => '+14159341234',
+          :to => '+16105557069',
+          :body => 'Hey there!'
+      )
+
+      open_last_text_message_for('+16105557069')
+      expect(current_text_message).to_not be_nil
+    end
+
+    it 'records the from number for a message' do
+      @client.messages.create(
+          :from => '+14159341234',
+          :to => '+16105557069',
+          :body => 'Hey there!'
+      )
+
+      open_last_text_message_for('+16105557069')
+      expect(current_text_message.from).to eq('+14159341234')
+    end
+  end
+
+  context 'using .account.* methods' do
+
+    before do
+      @account_sid = 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
+      @auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
+      @client = Twilio::REST::Client.new @account_sid, @auth_token
+    end
+
+    it 'intercepts calls to twilio sms client' do
+      @client.account.messages.create(
+          :from => '+14159341234',
+          :to => '+16105557069',
+          :body => 'Hey there!'
+      )
+
+      open_last_text_message_for('+16105557069')
+      expect(current_text_message).to_not be_nil
+    end
+
+    it 'records the from number for a message' do
+      @client.account.messages.create(
+          :from => '+14159341234',
+          :to => '+16105557069',
+          :body => 'Hey there!'
+      )
+
+      open_last_text_message_for('+16105557069')
+      expect(current_text_message.from).to eq('+14159341234')
+    end
+  end
+end

data/spec/helpers_spec.rb

@@ -0,0 +1,153 @@
+require File.join(File.dirname(__FILE__), *%w[spec_helper])
+
+describe SmsUnitTest::Helpers do
+  include SmsUnitTest::Helpers
+
+  before :each do
+    SmsUnitTest::Data.clear_messages
+  end
+
+  describe ".messages" do
+    describe "before any messages have been sent" do
+      it "is empty" do
+        expect(messages).to be_empty
+      end
+    end
+
+    describe "after a message has been sent" do
+      it "adds a message" do
+        expect(lambda {
+          add_message SmsUnitTest::Message.new :number => "5555555512", :body => "Hello there"
+        }).to change(messages, :count).by(1)
+      end
+    end
+  end
+
+  describe ".set_current_number" do
+    it "assigns the current number" do
+      set_current_number "555551234"
+      expect(current_number).to eql("555551234")
+    end
+
+    it 'does not format  phone numbers' do
+      set_current_number '+1555551234'
+      expect(current_number).to eql( '+1555551234')
+
+      set_current_number '+1 (616) 555-2929'
+      expect(current_number).to eql('+1 (616) 555-2929')
+    end
+  end
+
+  describe ".clear_messages" do
+    it "removes all messages" do
+      add_message SmsUnitTest::Message.new :number => "5555555512", :body => "Hello there"
+      add_message SmsUnitTest::Message.new :number => "5555555512", :body => "Hello there"
+      add_message SmsUnitTest::Message.new :number => "5555555512", :body => "Hello there"
+
+      expect(messages.count).to eql(3)
+      clear_messages
+      expect(messages.count).to eql(0)
+    end
+  end
+
+  describe ".current_text_message" do
+    describe "when there are not text messages yet" do
+    before :each do
+      SmsUnitTest::Data.clear_messages
+    end
+
+      it "returns nil" do
+        expect(current_text_message).to be_nil
+      end
+    end
+
+    describe "when there are messages" do
+      let(:message1) { SmsUnitTest::Message.new :number => "5555555513", :body => "Hi" }
+      let(:message2) { SmsUnitTest::Message.new :number => "5555555512", :body => "Hello there" }
+
+      before do
+        add_message message1
+        add_message message2
+      end
+
+      describe "and no messages have been opened" do
+        it "should be nil" do
+          expect(current_text_message).to be_nil
+        end
+      end
+
+      describe "and a message has been opened" do
+        before do
+          open_last_text_message_for("5555555513")
+        end
+
+        it "returns the last open text message" do
+          expect(current_text_message).to eql(message1)
+
+          open_last_text_message_for("5555555513")
+          expect(current_text_message).to be_nil
+
+          open_last_text_message_for("5555555512")
+          expect(current_text_message).to eql(message2)
+        end
+      end
+    end
+  end
+
+  describe ".twiml_message" do
+    context "with defaults" do
+      let(:message) {
+        twiml_message("+16165559982", "Ahoy!")
+      }
+
+      it "modifies the From attribute" do
+        expect(message["From"]).to eql("+16165559982")
+      end
+
+      it "Modifies the Body attribute" do
+        expect(message["Body"]).to eql("Ahoy!")
+      end
+    end
+
+    describe "Overriding options" do
+      let(:message) {
+        twiml_message("+16165559982", "Ahoy!", "ToZip" => "49506", "ToCity" => "Detroit")
+      }
+
+      it "overrides the specified attributes" do
+        expect(message["ToZip"]).to eql("49506")
+        expect(message["ToCity"]).to eql("Detroit")
+        expect(message["Body"]).to eql("Ahoy!")
+        expect(message["From"]).to eql("+16165559982")
+      end
+    end
+  end
+
+  describe ".clkatel_message" do
+    context "with defaults" do
+      let(:message) {
+        clkatel_message("+16165559982", "Ahoy!")
+      }
+
+      it "modifies the From attribute" do
+        expect(message["From"]).to eql("+16165559982")
+      end
+
+      it "Modifies the Body attribute" do
+        expect(message["Text"]).to eql("Ahoy!")
+      end
+    end
+
+    describe "Overriding options" do
+      let(:message) {
+        clkatel_message("+16165559982", "Ahoy!")
+      }
+
+      it "overrides the specified attributes" do
+        expect(message["Text"]).to eql("Ahoy!")
+        expect(message["From"]).to eql("+16165559982")
+      end
+    end
+  end
+
+end

data/spec/matchers_spec.rb

@@ -0,0 +1,88 @@
+require File.join(File.dirname(__FILE__), *%w[spec_helper])
+
+describe SmsUnitTest::Matchers do
+  include SmsUnitTest::Helpers
+  include SmsUnitTest::Matchers
+
+  let(:mobile_number) { "5555555512" }
+
+  class MatcherMatch
+    def initialize(object_to_test_match)
+      @object_to_test_match = object_to_test_match
+    end
+
+    def description
+      "match when provided #{@object_to_test_match.inspect}"
+    end
+
+    def matches?(matcher)
+      @matcher = matcher
+      matcher.matches?(@object_to_test_match)
+    end
+
+    def failure_message
+      "expected #{@matcher.inspect} to match when provided #{@object_to_test_match.inspect}, but it did not"
+    end
+
+    def failure_message_when_negated
+      "expected #{@matcher.inspect} not to match when provided #{@object_to_test_match.inspect}, but it did"
+    end
+  end
+
+  def match(object_to_test_match)
+    if object_to_test_match.is_a?(Regexp)
+      super # delegate to rspec's built in 'match' matcher
+    else
+      MatcherMatch.new(object_to_test_match)
+    end
+  end
+
+  describe ".have_text_messages" do
+    include SmsUnitTest::Matchers
+
+    describe "when the mobile device has no text messages" do
+      it "should not match" do
+        device = SmsUnitTest::MobileDevice.new(:number => mobile_number)
+        expect(have_text_messages).to_not match(device)
+      end
+    end
+
+    describe "when the mobile device has text messages" do
+      it "should match" do
+        add_message SmsUnitTest::Message.new(:number => mobile_number, :body => "something")
+
+        device = SmsUnitTest::MobileDevice.new(mobile_number)
+        expect(have_text_messages).to match(device)
+      end
+    end
+  end
+
+  describe ".have_body" do
+    describe "when bodies match" do
+      it "matches" do
+        message = SmsUnitTest::Message.new(:number => mobile_number, :body => "something")
+
+        expect(have_body("something")).to match(message)
+      end
+    end
+  end
+
+  describe ".have_body_like" do
+    describe "when bodies partially match" do
+      it "matches" do
+        message = SmsUnitTest::Message.new(:number => mobile_number, :body => "something is here")
+
+        expect(have_body_like("something")).to match(message)
+      end
+    end
+
+    describe "when bodies don't partiall match" do
+      it "does not match" do
+        message = SmsUnitTest::Message.new(:number => mobile_number, :body => "something is here")
+
+        expect(have_body_like("godzilla")).to_not match(message)
+      end
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require File.join(File.dirname(__FILE__), *%w[.. lib sms-unit-test])
+
+require 'rubygems'
+require 'pry'

metadata

@@ -0,0 +1,149 @@
+--- !ruby/object:Gem::Specification
+name: sms-unit-test
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+platform: ruby
+authors:
+- Kevin Ross
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-10-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: twilio-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+- !ruby/object:Gem::Dependency
+  name: lookout-clickatell
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: SMS Spec gives you an RSpec DSL and Cucumber steps to test SMS interactions.
+email:
+- kevin.ross@alienfast.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".ruby-gemset"
+- ".ruby-version"
+- ".travis.yml"
+- Gemfile
+- Guardfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/generators/sms_spec/steps/USAGE
+- lib/generators/sms_spec/steps/steps_generator.rb
+- lib/generators/sms_spec/steps/templates/sms_steps.rb
+- lib/sms-unit-test.rb
+- lib/sms_unit_test.rb
+- lib/sms_unit_test/cucumber.rb
+- lib/sms_unit_test/data.rb
+- lib/sms_unit_test/drivers/clickatell.rb
+- lib/sms_unit_test/drivers/twilio-ruby.rb
+- lib/sms_unit_test/helpers.rb
+- lib/sms_unit_test/matchers.rb
+- lib/sms_unit_test/message.rb
+- lib/sms_unit_test/mobile_device.rb
+- lib/sms_unit_test/version.rb
+- rails_generators/sms_unit_test/templates/sms_steps.rb
+- rails_generators/sms_unit_test_generator.rb
+- sms-unit-test.gemspec
+- spec/drivers/clickatell_spec.rb
+- spec/drivers/twilio_spec.rb
+- spec/helpers_spec.rb
+- spec/matchers_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/rosskevin/sms-unit-test
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: sms-unit-test
+rubygems_version: 2.6.13
+signing_key: 
+specification_version: 4
+summary: Test SMS interactions with RSpec and Cucumber
+test_files:
+- spec/drivers/clickatell_spec.rb
+- spec/drivers/twilio_spec.rb
+- spec/helpers_spec.rb
+- spec/matchers_spec.rb
+- spec/spec_helper.rb