tatango-sms 0.1

data/History.txt

@@ -0,0 +1,7 @@
+=== 0.1 / 2008-10-17
+
+* 1st write
+	* send messages in one line
+	* receive messages with a block
+
+

data/Manifest.txt

@@ -0,0 +1,7 @@
+History.txt
+README.txt
+Manifest.txt
+lib/tatango_sms.rb
+lib/tatango_sms/mo.rb
+lib/tatango_sms/mt.rb
+test/test_tatango_sms.rb

data/README.txt

@@ -0,0 +1,52 @@
+= TatangoSMS
+
+* http://tatango.com/developers
+
+== Description
+
+The Tatango Messaging Gateway provides a way for you to utilize our streamlined messaging pipeline to send out SMS messages to your users. SMS messages are advertisement-supported, so we can provide this service at zero cost to the developer.
+
+== Sign-up
+
+In order to use the Tatango SMS Gateway, you will need to sign up for a gateway key. You can sign up at http://tatango.com/developers/gateway.
+
+== Install
+
+gem install tatango-sms
+
+== Requirements
+
+TatangoSMS::MO requires +mongrel+ and +activesupport+. Neither are listed as a gem dependency because TatangoSMS::MT does not require them.
+
+TatangoSMS::MT requires <tt>digest/md5</tt>, <tt>net/http</tt>, and +uri+ from ruby core.
+
+== Documentation
+
+TatangoSMS::MT:: for mobile-terminated support
+TatangoSMS::MO:: for mobile-oriented support
+
+more documentation can be found at: http://tatango.com/developers/gateway/docs
+
+== Support
+
+Have questions? You can usually find the Tatango engineering team at ##tatango on Freenode.
+
+More information here: http://tatango.com/developers/connect
+
+== Example
+
+	require 'rubygems'
+	require 'tatango_sms/mt'
+	require 'tatango_sms/mo'
+
+	# setup a mobile terminated object with our Tatango SMS Gateway key and password
+	mt = TatangoSMS::MT.new('key', 'password')
+
+	# run a server on port 3333 to accept incoming messages from Tatango
+	server = TatangoSMS:MO.server('0.0.0.0', '3333')
+	TatangoSMS::MO.receive(server, '/') do |phone_number, content|
+	  # send the reversed message back
+	  mt.send(phone_number, content.reverse)
+	end
+
+	server.run.join

data/lib/tatango_sms.rb

@@ -0,0 +1,36 @@
+# This file is part of TatangoSMS.
+#
+# TatangoSMS is a simple library to facilitate the use of the Tatango
+# Messaging Gateway. The Tatango Messaging Gateway provides a way for you to utilize our
+# streamlined messaging pipeline to send out SMS messages to your users.
+# SMS messages are advertisement-supported, so we can provide this
+# service at zero cost to the developer. 
+#
+# More information can be found at http://tatango.com/developers/gateway
+#
+# Copyright (c) 2008, Tatango Inc.
+# All rights reserved.
+#
+# 
+# TatangoSMS is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# TatangoSMS is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser Public License
+# along with TatangoSMS.  If not, see <http://www.gnu.org/licenses/>.
+
+
+
+require 'tatango_sms/mo'
+require 'tatango_sms/mt'
+
+
+module TatangoSMS
+  VERSION = '0.1'
+end

data/lib/tatango_sms/mo.rb

@@ -0,0 +1,99 @@
+# This file is part of TatangoSMS.
+#
+# TatangoSMS is a simple library to facilitate the use of the Tatango
+# Messaging Gateway. The Tatango Messaging Gateway provides a way for you to utilize our
+# streamlined messaging pipeline to send out SMS messages to your users.
+# SMS messages are advertisement-supported, so we can provide this
+# service at zero cost to the developer. 
+#
+# More information can be found at http://tatango.com/developers/gateway
+#
+# Copyright (c) 2008, Tatango Inc.
+# All rights reserved.
+#
+# 
+# TatangoSMS is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# TatangoSMS is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser Public License
+# along with TatangoSMS.  If not, see <http://www.gnu.org/licenses/>.
+
+
+require 'rubygems'
+require 'mongrel'
+require 'activesupport' # for Hash.from_xml
+
+
+module TatangoSMS
+  
+  # TatangoSMS::MO makes it easy to receive messages from the Tatango SMS Gateway
+  #
+  # Example:
+  #   require 'tatango_sms/mo'
+  #   server = TatangoSMS::MO.server('0.0.0.0', '3333')
+  #   TatangoSMS::MO.receive(server, '/') do |phone_number, content|
+  #     # parse content and do something
+  #     # maybe even send a message back with TatangoSMS::MT.send(...)
+  #   end
+  #   server.run.join
+  class MO
+    class << self
+      
+      # setup a new mongrel server to accept MOs
+      #
+      # returns a Mongrel::HttpServer
+      # 
+      # Examples:
+      #   server = Mongrel::MO.server('0.0.0.0', '3333')
+      #   # see MO::receive for how to register a block of code to receive messages
+      #   server.run # run the server
+      #   server.acceptor.join # the acceptor thread can be found here
+      def server(*args)
+        Mongrel::HttpServer.new(*args)
+      end
+      
+      # register a block of code to receive messages
+      #
+      # expects a Mongrel::HttpServer. use MO.server or just use one you already have?
+      #
+      # NOTE: +content+ will be exactly what the user entered in their cell phone.
+      # if they used your keyword, it will also be in +content+
+      #
+      # Example:
+      #   TatangoSMS::MO.receive(server, '/') do |phone_number, content|
+      #     puts "message from #{phone_number} was #{content}"
+      #   end
+      def receive(server, path = '/', &blk)
+        server.register(path, Handler.new(&blk))
+      end
+    end
+    
+    class Handler < Mongrel::HttpHandler # :nodoc:
+      def initialize(&blk)
+        @processor = blk
+      end
+      
+      def process(request, response)
+        
+        params = Hash.from_xml(request.body.read)
+        phone_number = params['message']['sender']
+        content = params['message']['content']
+        
+        # puts "Processing request from: #{request.params['REMOTE_ADDR']} phone: #{phone_number}"
+        
+        @processor.call(phone_number, content)
+
+        response.start(202) do |head,out|
+          head["Content-Type"] = 'text/plain'
+        end
+      end
+    end
+  end
+end

data/lib/tatango_sms/mt.rb

@@ -0,0 +1,77 @@
+# This file is part of TatangoSMS.
+#
+# TatangoSMS is a simple library to facilitate the use of the Tatango
+# Messaging Gateway. The Tatango Messaging Gateway provides a way for you to utilize our
+# streamlined messaging pipeline to send out SMS messages to your users.
+# SMS messages are advertisement-supported, so we can provide this
+# service at zero cost to the developer. 
+#
+# More information can be found at http://tatango.com/developers/gateway
+#
+# Copyright (c) 2008, Tatango Inc.
+# All rights reserved.
+#
+# 
+# TatangoSMS is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# TatangoSMS is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser Public License
+# along with TatangoSMS.  If not, see <http://www.gnu.org/licenses/>.
+
+
+require 'digest/md5'
+require 'net/http'
+require 'uri'
+
+module TatangoSMS
+  
+  # TatangoSMS::MT makes it easy to send a message through the Tatango SMS Gateway
+  #
+  # Examples:
+  #   require 'tatango_sms/mt'
+  #   TatangoSMS::MT.send('tatangosmsgatewayKEY', 'password', '9998887777', 'A message')
+  #   # or
+  #   mt = TatangoSMS::MT.new 'tatangosmsgatewayKEY', 'password'
+  #   response = mt.send '9998887777', 'Another silly message'
+  class MT
+
+    @@gateway_url = 'http://gateway.tatango.com/messages'
+    
+    class << self
+      # see MT#send
+      def send(key, password, phone_number, message)
+        new(key, password).send(phone_number, message)
+      end
+    
+      def url=(url) # :nodoc:
+        @@gateway_url = url
+      end
+    end
+    
+    # create an MT instance to avoid repetition of key and password
+    def initialize(key, password)
+      @gateway_key, @gateway_password = key, password
+    end
+    
+    # send a +message+ to +phone_number+
+    #
+    # returns a Net::HTTP response
+    def send(phone_number, message)
+      Net::HTTP.post_form(
+        URI.parse(@@gateway_url), {
+          'key' => @gateway_key,
+          'recipient' => phone_number,
+          'message' => message,
+          'hash' => Digest::MD5.hexdigest(@gateway_password + message)
+        }
+      )
+    end
+  end
+end

data/test/test_tatango_sms.rb

@@ -0,0 +1 @@
+# Sorry, no tests written yet

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification 
+name: tatango-sms
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+platform: ruby
+authors: 
+- Amiel Martin
+- Adrian Pike
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-10-20 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.0
+    version: 
+description: The Tatango Messaging Gateway provides a way for you to utilize our streamlined messaging pipeline to send out SMS messages to your users. SMS messages are advertisement-supported, so we can provide this service at zero cost to the developer.
+email: 
+- amiel@tatango.com
+- apike@tatango.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- README.txt
+- Manifest.txt
+files: 
+- History.txt
+- README.txt
+- Manifest.txt
+- lib/tatango_sms.rb
+- lib/tatango_sms/mo.rb
+- lib/tatango_sms/mt.rb
+- test/test_tatango_sms.rb
+has_rdoc: true
+homepage: http://tatango.com/developers/gateway
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: tatango-sms
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: The Tatango Messaging Gateway provides a way for you to utilize our streamlined messaging pipeline to send out SMS messages to your users
+test_files: 
+- test/test_tatango_sms.rb