fluent-plugin-twilio 0.0.1

data/.gitignore

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

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,14 @@
+Copyright (c) 2013- Kentaro Yoshida
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+

data/README.md

@@ -0,0 +1,67 @@
+fluent-plugin-twilio
+=====================
+
+## Overview
+Fluentd Output plugin to make a call with twilio.
+
+## Installation
+
+### native gem
+`````
+gem install fluent-plugin-twilio
+`````
+
+### td-agent gem
+`````
+/usr/lib64/fluent/ruby/bin/fluent-gem install fluent-plugin-twilio
+`````
+
+## Configuration
+
+### Message Format
+`````
+fluent_logger.post('notify.call', {
+  :message  => 'Hello World!',   # Required
+  :number   => '+8109012345678'  # Required
+})
+`````
+
+### Sample
+`````
+<source>
+  type http
+  port 8888
+</source>
+
+<match notify.call>
+  type twilio
+  account_sid     TWILIO_ACCOUNT_SID  # Required
+  auth_token      TWILIO_AUTH_TOKEN   # Required
+  from_number     +81312345678        # Required with country code
+  default_number  090-1234-5678       # Optional
+</match>
+`````
+
+### Quick Test
+`````
+# test call to +819012345678 and say "Help! System ABC has down." with woman voice.
+$ curl http://localhost:8888/notify.call -F 'json={"number":"+819012345678","voice":"woman","message":"Help! System ABC has down."}'
+
+# check twilio activity log
+$ tail -f /var/log/td-agent/td-agent.log
+`````
+
+## Backend Service
+
+* Twilio https://www.twilio.com/
+* Twilio Japan http://twilio.kddi-web.com/
+
+## TODO
+Pull requests are very welcome!!
+
+## Copyright
+Copyright © 2013- Kentaro Yoshida ([@yoshi_ken](https://twitter.com/yoshi_ken))
+
+## License
+Apache License, Version 2.0
+

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :test
+

data/fluent-plugin-twilio.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "fluent-plugin-twilio"
+  s.version     = "0.0.1"
+  s.authors     = ["Kentaro Yoshida"]
+  s.email       = ["y.ken.studio@gmail.com"]
+  s.homepage    = "https://github.com/y-ken/fluent-plugin-twilio"
+  s.summary     = %q{Fluentd Output plugin to make a call with twilio.}
+
+  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"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "rake"
+  s.add_runtime_dependency "fluentd"
+  s.add_runtime_dependency "twilio-ruby"
+end

data/lib/fluent/plugin/out_twilio.rb

@@ -0,0 +1,51 @@
+class Fluent::TwilioOutput < Fluent::Output
+  Fluent::Plugin.register_output('twilio', self)
+
+  config_param :account_sid, :string
+  config_param :auth_token, :string
+  config_param :from_number, :string, :default => ''
+  config_param :default_number, :string, :default => ''
+  config_param :default_voice, :string, :default => 'woman'
+  config_param :language, :string, :default => 'ja-jp'
+
+  VOICE_MAP = ['woman']
+
+  def initialize
+    super
+    require 'uri'
+    require 'twilio-ruby'
+  end
+
+  def configure(conf)
+    super
+
+  end
+
+  def emit(tag, es, chain)
+    es.each do |time,record|
+      number = record['number'].nil? ? @default_number : record['number']
+      @voice = VOICE_MAP.include?(record['voice']) ? record['voice'] : @default_voice
+      call(number, record['message'])
+    end
+
+    chain.next
+  end
+
+  def call(number, message)
+    response = Twilio::TwiML::Response.new do |r|
+      r.Say message, :voice => @voice, :language => @language
+    end
+    xml = response.text.sub(/<[^>]+?>/, '')
+    url = "http://twimlets.com/echo?Twiml=#{URI.escape(xml)}"
+    $log.info "twilio: generateing twiml: #{xml}"
+
+    client = Twilio::REST::Client.new(@account_sid, @auth_token)
+    account = client.account
+    begin
+      call = account.calls.create({:from => @from_number, :to => number, :url => url})
+    rescue => e
+      $log.error "twilio: Error: #{e.message}"
+    end
+  end
+end
+

data/test/helper.rb

@@ -0,0 +1,28 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'test/unit'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'fluent/test'
+unless ENV.has_key?('VERBOSE')
+  nulllogger = Object.new
+  nulllogger.instance_eval {|obj|
+    def method_missing(method, *args)
+      # pass
+    end
+  }
+  $log = nulllogger
+end
+
+require 'fluent/plugin/out_twilio'
+
+class Test::Unit::TestCase
+end

data/test/plugin/test_out_twilio.rb

@@ -0,0 +1,42 @@
+require 'helper'
+
+class TwilioOutputTest < Test::Unit::TestCase
+  def setup
+    Fluent::Test.setup
+  end
+
+  CONFIG = %[
+    account_sid  TWILIO_ACCOUNT_SID
+    auth_token   TWILIO_AUTH_TOKEN
+    from_number  +8112345678
+  ]
+
+  def create_driver(conf=CONFIG,tag='test')
+    Fluent::Test::OutputTestDriver.new(Fluent::TwilioOutput, tag).configure(conf)
+  end
+
+  def test_configure
+    assert_raise(Fluent::ConfigError) {
+      d = create_driver('')
+    }
+    d = create_driver %[
+      account_sid  TWILIO_ACCOUNT_SID
+      auth_token   TWILIO_AUTH_TOKEN
+      from_number  +8112345678
+    ]
+    d.instance.inspect
+    assert_equal 'TWILIO_ACCOUNT_SID', d.instance.account_sid
+    assert_equal 'TWILIO_AUTH_TOKEN', d.instance.auth_token
+    assert_equal '+8112345678', d.instance.from_number
+  end
+
+  def test_emit
+    d1 = create_driver(CONFIG, 'notify.call')
+    d1.run do
+      d1.emit({'message' => 'hello world.'})
+    end
+    emits = d1.emits
+    assert_equal 0, emits.length
+  end
+end
+

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification
+name: fluent-plugin-twilio
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Kentaro Yoshida
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fluentd
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: twilio-ruby
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- y.ken.studio@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- fluent-plugin-twilio.gemspec
+- lib/fluent/plugin/out_twilio.rb
+- test/helper.rb
+- test/plugin/test_out_twilio.rb
+homepage: https://github.com/y-ken/fluent-plugin-twilio
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Fluentd Output plugin to make a call with twilio.
+test_files:
+- test/helper.rb
+- test/plugin/test_out_twilio.rb