lita-twilio 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2ea54e16ff61284f26512a7abdf827ec4f36301b
+  data.tar.gz: 2975d3c78eca632904e2aff90792e937ded3d2f2
+SHA512:
+  metadata.gz: 9f6852c357516807af1736b1e3fbbe8c59fedaab9d94bd11b0b8ab6419871243ba3e5da3fa297f00cfb4ad14ef13d95f45496396bd39cd1b5147c1615660357e
+  data.tar.gz: da28a3a876ec1610cc44fe7c36a2541e20bf7cbca5e271d4245aa15a4ae84c934cd89fb3aa255bcd8bd30b99a3570baacc991b0b2052562a7df411bbdfa0ae7e

data/.gitignore

@@ -0,0 +1,20 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.DS_Store
+secrets.txt
+fixtures/vcr_cassettes/*

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 2.0.0
+script: bundle exec rake
+before_install:
+  - gem update --system
+services:
+  - redis-server

data/Gemfile

@@ -0,0 +1,11 @@
+source "https://rubygems.org"
+gem 'lita'
+gem 'rack-test'
+gem 'twilio-ruby'
+gem 'vcr'
+gem 'rspec-core'
+gem 'simplecov'
+gem 'coveralls'
+gem 'rspec'
+gem 'webmock'
+gem 'rake'

data/README.md

@@ -0,0 +1,36 @@
+[![Build Status](https://travis-ci.org/chriswoodrich/lita-twilio.svg?branch=master)](https://travis-ci.org/chriswoodrich/lita-twilio)  [![Coverage Status](https://coveralls.io/repos/chriswoodrich/lita-twilio/badge.svg)](https://coveralls.io/r/chriswoodrich/lita-twilio)
+
+# lita-twilio
+
+Lita-Twilio integrates your Twilio account into Lita. Send and receive text messages from your company chat room.
+
+## Installation
+
+Add lita-twilio to your Lita instance's Gemfile:
+
+``` gem "lita-twilio" ```
+
+## Configuration
+
+There's a bit of Yak-shaving to do here, sorry.
+
+### Required attributes
+* **default_room** (`String`) - The room or person Lita will message on receipt of incoming SMS.
+* **account_sid** (`String`) Your Twilio account's sid.
+* **auth_token** (`String`) Your Twilio account's auth_token.
+* **phone_number** (`String`) Your Twilio account's phone_number.
+* **server_token** (`String`) A keyphrase you will use to authenticate requests to the :post route.  You'll need this token to properly setup Twilio callbacks to power the receive route.
+
+### Twilio Account Setup
+* If you have the free account, you'll need to manually add and verify numbers to which you want to send.
+* Go to ```https://www.twilio.com/user/account/phone-numbers/incoming``` and change the ```Request URL``` under messages to ```http://yourdomain.com/twilio?token=VALUE-OF-YOUR-CONFIG-SERVER_TOKEN```.
+
+## Usage
+
+*```Litabot: sms 415-867-5309 Hello Jenny``` will send an SMS to (415) 867-5309 with the message "Hello Jenny"
+* Phone numbers must be strictly in the XXX-XXX-XXXX format, and sms or SMS (case insensitive) must be used as a command to Litabot.
+* Any incoming messages to your Twilio account will be displayed with the message and sender.
+
+## License
+
+[MIT](http://opensource.org/licenses/MIT)

data/Rakefile

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

data/lib/lita/handlers/twilio.rb

@@ -0,0 +1,49 @@
+module Lita
+  module Handlers
+    class Twilio < Handler
+
+      require 'twilio-ruby'
+
+      config :default_room, type: String, required: true
+      config :account_sid, type: String, required: true
+      config :auth_token, type: String, required: true
+      config :phone_number, type: String, required: true
+      config :server_token, type: String, required: true
+
+      http.post '/twilio', :receive_sms
+
+      route %r{^sms ([0-9]{3}-[0-9]{3}-[0-9]{4}) (.*)}i, :send_sms, help: {
+        "litabot: sms 415-867-5309 message content" => "Sends the SMS message to the number inputted"
+      }
+
+      def target
+        @target ||= config.default_room
+      end
+
+      def receive_sms(request, response)
+        return unless request.params.delete('token') == config.server_token
+        if request && request.params && !request.params.empty?
+          decoded = MultiJson.load(request.params.keys.first)
+          robot.send_message(target, "Message from #{decoded['From']}: #{decoded['Body']}")
+        end
+      end
+
+      def send_sms(response)
+        begin
+          client = ::Twilio::REST::Client.new(config.account_sid, config.auth_token)
+
+          if client.account.messages.create(:from => config.phone_number,
+                                            :to => response.matches[0][0],
+                                            :body => response.matches[0][1])
+            robot.send_message(target, "Sent message to #{response.matches[0][0]}")
+          end
+        rescue Exception => e
+          robot.send_message(@target, "Failed to send message: #{e.message}")
+        end
+
+      end
+
+    end
+    Lita.register_handler(Twilio)
+  end
+end

data/lib/lita-twilio.rb

@@ -0,0 +1,12 @@
+require "lita"
+
+Lita.load_locales Dir[File.expand_path(
+  File.join("..", "..", "locales", "*.yml"), __FILE__
+)]
+
+require "lita/handlers/twilio"
+
+Lita::Handlers::Twilio.template_root File.expand_path(
+  File.join("..", "..", "templates"),
+ __FILE__
+)

data/lita-twilio.gemspec

@@ -0,0 +1,25 @@
+Gem::Specification.new do |spec|
+  spec.name          = "lita-twilio"
+  spec.version       = "0.0.1"
+  spec.authors       = ["Chris Woodrich"]
+  spec.email         = ["cwoodrich@gmail.com"]
+  spec.description   = "Twilio integration for Lita"
+  spec.summary       = "Send and receive SMS with from your Lita-configured chat room"
+  spec.homepage      = "https://github.org/chriswoodrich/lita-twilio"
+  spec.license       = "MIT"
+  spec.metadata      = { "lita_plugin_type" => "handler" }
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "lita", ">= 4.2"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rack-test"
+  spec.add_development_dependency "rspec", ">= 3.0.0"
+  spec.add_development_dependency "simplecov"
+  spec.add_development_dependency "coveralls"
+end

data/locales/en.yml

@@ -0,0 +1,4 @@
+en:
+  lita:
+    handlers:
+      twilio:

data/spec/lita/handlers/twilio_spec.rb

@@ -0,0 +1,57 @@
+require "spec_helper"
+require 'vcr'
+
+describe Lita::Handlers::Twilio, lita_handler: true do
+  it { is_expected.to route_http(:post, "/twilio?token=#{ENV['SERVER_TOKEN']}").to(:receive_sms) }
+  it { is_expected.to route_command("sms 415-867-5309 JENNNNNNY").to(:send_sms) }
+
+
+  before do
+    registry.config.handlers.twilio.default_room = ENV["DEFAULT_ROOM"]
+    registry.config.handlers.twilio.account_sid = ENV["ACCOUNT_SID"]
+    registry.config.handlers.twilio.auth_token = ENV["AUTH_TOKEN"]
+    registry.config.handlers.twilio.phone_number = ENV["PHONE_NUMBER"]
+    registry.config.handlers.twilio.server_token = ENV["SERVER_TOKEN"]
+    registry.config.http.host = '127.0.0.1'
+    registry.config.http.port = '8080'
+  end
+
+  describe '#receive' do
+    let(:request) do
+      request = double('Rack::Request')
+      allow(request).to receive(:params).and_return(params)
+      request
+    end
+    let(:params) { {'Body' => 'Hi Lita!', 'From' => 'Jimmy'} }
+    let(:response) { Rack::Response.new }
+    it 'sends alerts user to the received message' do
+      http.post("/twilio?token=#{ENV['SERVER_TOKEN']}", params.to_json)
+      expect(replies.last).to include('Hi Lita!')
+    end
+  end
+
+  describe '#send_sms' do
+    it "Outputs a message that a message was sent, given proper params" do
+      VCR.use_cassette('sms') do
+        t = ENV["TEST_RECIPIENT_PHONE_NUMBER"]
+        send_command("sms #{t} this is a test message")
+        expect(replies.last).to eq "Sent message to #{t}"
+      end
+    end
+    it "Fails gracefully if Twilio generates an exception" do
+      send_command("sms 000-000-0000 OK computer")
+      expect(replies.last).to include('Failed to send message:')
+    end
+  end
+
+  describe "Twilio is pointing the Lita's webserver address and triggers received message callback" do
+    it 'should point to Lita\'s post route and trigger a robot message' do
+      full = "http://#{Lita.config.http.host}:#{Lita.config.http.port}/twilio?token=#{ENV['SERVER_TOKEN']}"
+      response = http.post(full, {'Body' => 'Hi Jimmy!', 'From' => 'Lita'}.to_json )
+      expect(response.status).to eq 200
+      expect(replies.last).to include('Hi Jimmy!')
+    end
+  end
+
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,24 @@
+require "simplecov"
+require "coveralls"
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+  SimpleCov::Formatter::HTMLFormatter,
+  Coveralls::SimpleCov::Formatter
+]
+SimpleCov.start { add_filter "/spec/" }
+require 'vcr'
+require "lita-twilio"
+require "lita/rspec"
+require 'webmock/rspec'
+
+
+VCR.configure do |c|
+  c.cassette_library_dir = 'fixtures/vcr_cassettes'
+  c.hook_into :webmock # or :fakeweb
+  c.allow_http_connections_when_no_cassette = false
+end
+
+# A compatibility mode is provided for older plugins upgrading from Lita 3. Since this plugin
+# was generated with Lita 4, the compatibility mode should be left disabled.
+Lita.version_3_compatibility_mode = false
+
+

metadata

@@ -0,0 +1,156 @@
+--- !ruby/object:Gem::Specification
+name: lita-twilio
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Chris Woodrich
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-03-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: lita
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.2'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !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: rack-test
+  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: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  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: coveralls
+  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: Twilio integration for Lita
+email:
+- cwoodrich@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- README.md
+- Rakefile
+- lib/lita-twilio.rb
+- lib/lita/handlers/twilio.rb
+- lita-twilio.gemspec
+- locales/en.yml
+- spec/lita/handlers/twilio_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.org/chriswoodrich/lita-twilio
+licenses:
+- MIT
+metadata:
+  lita_plugin_type: handler
+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: 
+rubygems_version: 2.4.3
+signing_key: 
+specification_version: 4
+summary: Send and receive SMS with from your Lita-configured chat room
+test_files:
+- spec/lita/handlers/twilio_spec.rb
+- spec/spec_helper.rb