exetel_sms 1.0

data/CHANGELOG

@@ -0,0 +1 @@
+v1.0. Initial commit

data/LICENSE

@@ -0,0 +1,26 @@
+Copyright (c) 2010, Andrew Snow
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+    * this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+    * notice, this list of conditions and the following disclaimer in the
+    * documentation and/or other materials provided with the distribution.
+    * Neither the name of the author nor the names of its
+    * contributors may be used to endorse or promote products derived from
+    * this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

data/Manifest

@@ -0,0 +1,11 @@
+CHANGELOG
+LICENSE
+README
+Rakefile
+class_methods.rb
+client.rb
+config.rb
+deleter.rb
+receiver.rb
+sender.rb
+Manifest

data/Rakefile

@@ -0,0 +1,8 @@
+require 'echoe'
+Echoe.new('exetel_sms') do |g|
+ g.summary = "Ruby gem to send and receive SMS via Exetel's API"
+ g.author = 'Andrew Snow'
+ g.email = 'andrew@modulus.org'
+end
+   
+     

data/class_methods.rb

@@ -0,0 +1,32 @@
+
+require 'uri'
+
+module ExetelSms
+  module ClassMethods
+    def new_reference_number(ident='')
+      @@counter ||= 0
+      @@counter += 1
+      ident + ('%04X%02X%04X' % [Time.now.to_i, $$, @@counter])
+    end
+    
+    def build_url(params_hash)
+      exetel_url + request_fields.map do |field|
+        raise "Missing field: #{field}" unless params_hash.has_key?(field)
+        encode(field.to_s) + '=' + encode(params_hash[field].to_s)
+      end.join('&')
+    end
+          
+    def encode(str)
+      URI.encode(URI.encode(str), /=|&|\?/)
+    end
+    
+    def response_to_hash(fields)
+      raise 'Missing fields in response body' unless fields.length >= response_fields.length
+      ret = {}
+      response_fields.each {|field| ret[field] = fields.shift }
+      ret[:other] = fields
+      ret
+    end
+      
+  end
+end

data/client.rb

@@ -0,0 +1,27 @@
+
+
+require 'net/http'
+require 'net/https'
+require 'uri'
+
+module ExetelSms
+  class Client
+    class << self
+    
+      def request(url)
+        uri = URI.parse(url)
+        h = Net::HTTP.new(uri.host, uri.port)
+        h.use_ssl = true
+        h.verify_mode = OpenSSL::SSL::VERIFY_NONE
+        #h.set_debug_output $stderr
+        body = ''
+        h.start do |http|
+          response = http.request_get(uri.request_uri)
+          body = response.body
+        end
+        raise "No body" unless body && body =~ /|/
+        body.chomp.gsub(/<br>$/i, '').split('|').map {|str| str.strip }
+      end
+    end
+  end
+end

data/config.rb

@@ -0,0 +1,13 @@
+
+module ExetelSms
+  class Config
+  
+    attr_reader :username, :password, :mvn
+    
+    def initialize(username, password, mvn=nil)
+      @username = username
+      @password = password
+      @mvn = mvn
+    end  
+  end
+end

data/deleter.rb

@@ -0,0 +1,42 @@
+
+require 'exetel_sms/client'
+require 'exetel_sms/class_methods'
+
+module ExetelSms
+  
+  class Deleter
+    extend ExetelSms::ClassMethods
+  
+    attr_reader :config
+    def initialize(config)
+      @config = config
+    end
+    
+    def delete(from_mobile_number, message_id)
+      url = self.class.build_url(
+        :username => @config.username,
+        :password => @config.password,
+        :mobilenumber => from_mobile_number
+        :messageid => message_id
+      )
+      
+      response_to_hash(ExetelSms::Client.request(url))
+    end
+    
+    class << self
+      
+      def response_fields
+        [:status, :notes]
+      end
+      
+      def request_fields
+        [:username, :password, :mobilenumber, :messageid]
+      end
+
+      def exetel_url
+        'https://www.exetel.com.au/sendsms/api_sms_mvn_delete.php?'
+      end
+
+    end
+  end
+end

data/exetel_sms.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{exetel_sms}
+  s.version = "1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Andrew Snow"]
+  s.date = %q{2010-08-25}
+  s.description = %q{Ruby gem to send and receive SMS via Exetel's API}
+  s.email = %q{andrew@modulus.org}
+  s.extra_rdoc_files = ["CHANGELOG", "LICENSE", "README"]
+  s.files = ["CHANGELOG", "LICENSE", "README", "Rakefile", "class_methods.rb", "client.rb", "config.rb", "deleter.rb", "receiver.rb", "sender.rb", "Manifest", "exetel_sms.gemspec"]
+  s.homepage = %q{}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Exetel_sms", "--main", "README"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{exetel_sms}
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Ruby gem to send and receive SMS via Exetel's API}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/receiver.rb

@@ -0,0 +1,41 @@
+
+require 'exetel_sms/client'
+require 'exetel_sms/class_methods'
+
+module ExetelSms
+  
+  class Receiver
+    extend ExetelSms::ClassMethods
+  
+    attr_reader :config
+    def initialize(config)
+      @config = config
+    end
+    
+    def receive(from_mobile_number)
+      url = self.class.build_url(
+        :username => @config.username,
+        :password => @config.password,
+        :mobilenumber => from_mobile_number
+      )
+      
+      self.class.response_to_hash(ExetelSms::Client.request(url))
+    end
+    
+    class << self
+      
+      def response_fields
+        [:status, :exetel_id, :from_mobile_number, :received_at, :notes, :message]
+      end
+      
+      def request_fields
+        [:username, :password, :mobilenumber]
+      end
+
+      def exetel_url
+        'https://www.exetel.com.au/sendsms/api_sms_mvn_inbox.php?'
+      end
+
+    end
+  end
+end

data/sender.rb

@@ -0,0 +1,46 @@
+
+require 'exetel_sms/client'
+require 'exetel_sms/class_methods'
+
+module ExetelSms
+  
+  class Sender
+    extend ExetelSms::ClassMethods
+  
+    attr_reader :config
+    def initialize(config)
+      @config = config
+    end
+    
+    def send(to_mobile_number, msg, from_mobile_number, reference_number)
+      url = self.class.build_url(
+        :username => @config.username,
+        :password => @config.password,
+        :sender => from_mobile_number,
+        :message => msg,
+        :messagetype => 'Text',
+        :referencenumber => reference_number,
+        :mobilenumber => to_mobile_number
+      )
+      
+      self.class.response_to_hash(ExetelSms::Client.request(url))
+    end
+    
+    class << self
+      
+      def response_fields
+        [:status, :to_mobile_number, :reference_number, :exetel_id, :notes]
+      end
+      
+      def request_fields
+        [:username, :password, :mobilenumber, :message, :sender, :messagetype, :referencenumber]
+      end
+
+      def exetel_url
+        'https://www.exetel.com.au/sendsms/api_sms.php?'
+        #username=xxxxxxxx&password=xxxxxxxx&mobilenumber=xxxxxxxx&message=xxxxxxxx&sender=xxxxxxxxx&messagetype=Text&referencenumber=xxxxxx'
+      end
+
+    end
+  end
+end

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification 
+name: exetel_sms
+version: !ruby/object:Gem::Version 
+  hash: 15
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  version: "1.0"
+platform: ruby
+authors: 
+- Andrew Snow
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-08-25 00:00:00 +10:00
+default_executable: 
+dependencies: []
+
+description: Ruby gem to send and receive SMS via Exetel's API
+email: andrew@modulus.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG
+- LICENSE
+- README
+files: 
+- CHANGELOG
+- LICENSE
+- README
+- Rakefile
+- class_methods.rb
+- client.rb
+- config.rb
+- deleter.rb
+- receiver.rb
+- sender.rb
+- Manifest
+- exetel_sms.gemspec
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Exetel_sms
+- --main
+- README
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 11
+      segments: 
+      - 1
+      - 2
+      version: "1.2"
+requirements: []
+
+rubyforge_project: exetel_sms
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Ruby gem to send and receive SMS via Exetel's API
+test_files: []
+