signupto 0.0.2

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 YOUR NAME
+
+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

@@ -0,0 +1,4 @@
+merb_signupto
+=================
+
+A plugin for the Merb framework that provides ....

data/Rakefile

@@ -0,0 +1,35 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'lib/signupto/version'
+
+PLUGIN = "signupto"
+NAME = "signupto"
+VERSION = Signupto::Version::STRING
+AUTHOR = "Tim Perrett"
+EMAIL = "code@timperrett.com"
+HOMEPAGE = "http://blog.timperrett.com"
+SUMMARY = "Core connectivity to the signupto SMS gateway service"
+
+spec = Gem::Specification.new do |s|
+  s.name = NAME
+  s.version = VERSION
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README", "LICENSE"]
+  s.summary = SUMMARY
+  s.description = s.summary
+  s.author = AUTHOR
+  s.email = EMAIL
+  s.homepage = HOMEPAGE
+  s.require_path = 'lib'
+  s.autorequire = PLUGIN
+  s.files = %w(LICENSE README Rakefile) + Dir.glob("{lib,spec}/**/*")
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+task :install => [:package] do
+  sh %{sudo gem install pkg/#{NAME}-#{VERSION}}
+end

data/lib/signupto.rb

@@ -0,0 +1,9 @@
+$:.unshift(File.dirname(__FILE__)) unless
+   $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require 'signupto/account'
+require 'signupto/message'
+require 'signupto/action/base'
+require 'signupto/action/balance'
+require 'signupto/action/sender'
+require 'signupto/base'

data/lib/signupto/account.rb

@@ -0,0 +1,19 @@
+module Signupto
+  class Account
+    
+    attr_reader :apihash
+    attr_reader :customer_number
+    
+    # Pass in your account details to create an account object.
+    # Your +apihash+ and +cid+ which will both be found on the signup.to
+    # dashboard interface.
+    def initialize(apihash, customer_number)
+      @apihash, @customer_number = apihash, customer_number
+    end
+    
+    def to_http
+      URI.encode("cid=#{@customer_number}&hash=#{@apihash}")
+    end
+    
+  end
+end

data/lib/signupto/action/balance.rb

@@ -0,0 +1,24 @@
+module Signupto
+  module Action
+    class Balance < Base
+      
+      def initialize(account)
+        if account.is_a?(Account)
+          if super(account.apihash, account.customer_number)
+            payload = set_payload()
+            run_action(payload)
+          end
+        else
+          raise "ERROR"
+        end
+      end
+
+      protected
+      
+        def set_payload
+          @payload = [@account.to_http, 'mode=balance'].join('&')
+        end
+      
+    end
+  end
+end

data/lib/signupto/action/base.rb

@@ -0,0 +1,31 @@
+require 'net/http'
+require 'uri'
+
+module Signupto
+  module Action
+    class Base
+      
+      # Parent class that all specific actions are derived.
+      def initialize(account_hash, customer_number)
+        @account = Signupto::Account.new(account_hash, customer_number)
+      end
+      
+      def to_s
+        return @result.body
+      end
+
+      protected
+      
+        # Actually make the call to the api URL. SignUp.to use a 
+        # PHP response method, so I make a URI encoded GET to there servers
+        # and await the response; handling it appropriatly.
+        def run_action(payload, page = 'smpp_account')
+          Net::HTTP.start('sms.sign-up.to', 80) do |http|
+            @result = http.get('/'<< page << '.php?' << payload)
+            return @result
+          end
+        end
+      
+    end
+  end
+end

data/lib/signupto/action/sender.rb

@@ -0,0 +1,32 @@
+module Signupto
+  module Action
+    class Sender < Base
+      
+      def initialize(account, message)
+        if message.is_a?(Message) and account.is_a?(Account)
+          if super(account.apihash, account.customer_number)
+            @message = message
+            payload = set_payload()
+            run_action(payload, 'smpp_send')
+          end
+        else
+          raise "You can only supply a Message object"
+        end
+      end
+      
+      protected
+      
+        # Configure the payload to send on this text message.
+        # to   - Recipient mobile number in full international format (no ‘+’ or ‘00’) 
+        # message  - Message body text 
+        # from   - SMS sender 
+        # cost   - Cost (in pence) to the recipient 
+        # network  - Recipient’s network  
+        # smsc   - ID of client selected SMS route 
+        def set_payload
+          @payload = [@account.to_http, "to=#{@message.to.to_s}", "message=#{@message.body.to_s}", "from=#{@message.from.to_s}"].join('&')
+        end
+      
+    end
+  end
+end

data/lib/signupto/base.rb

@@ -0,0 +1,30 @@
+module Signupto
+  class Base
+  
+    class << self
+      # retrives your account balance and returns it as a string
+      def balance(options = {})
+        if options.has_key?(:account_hash) and options.has_key?(:customer_number)
+          account = Account.new(options[:account_hash], options[:customer_number])
+          return Action::Balance.new(account).to_s
+        end
+      end
+      
+      # Upon a sucsesfull send this will return the message number for tracking purposese
+      # on the signupto systems.
+      def send!(options = {})
+        if options.has_key?(:account_hash) and options.has_key?(:customer_number)
+          account = Account.new(options[:account_hash], options[:customer_number])
+          if options.has_key?(:message) and options.has_key?(:to)
+            message = Message.new(options[:to], options[:message], options[:from])
+            puts message.to
+            return Action::Sender.new(account, message)
+          else
+            raise ArgumentError, "You must supply a message to send and a place to send it"
+          end
+        end
+      end
+    end
+    
+  end
+end

data/lib/signupto/message.rb

@@ -0,0 +1,19 @@
+module Signupto
+  class Message
+    
+    # Make the elements of the message accesible.
+    # This way you can do @message.from etc to makes debuging the code
+    # a lot simpler (I find at least)
+    attr_reader :to, :from, :body
+    
+    # Set the recipient (which must be in international format, with no leading +)
+    # and the from paramater, and the body. The From paramater will take a string up to
+    # 12 characters long, then on the recipients phone it will appear as if it is from 
+    # someone in there contacts rather than and unknown number.
+    def initialize(to, body, from = nil)
+      # validate_number(to)
+      @to, @body, @from = to, URI.encode(body), from
+    end
+    
+  end
+end

data/lib/signupto/version.rb

@@ -0,0 +1,9 @@
+module Signupto
+  module Version #:nodoc:
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 2
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.4
+specification_version: 1
+name: signupto
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+date: 2008-01-04 00:00:00 +00:00
+summary: Core connectivity to the signupto SMS gateway service
+require_paths: 
+- lib
+email: code@timperrett.com
+homepage: http://blog.timperrett.com
+rubyforge_project: 
+description: Core connectivity to the signupto SMS gateway service
+autorequire: signupto
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Tim Perrett
+files: 
+- LICENSE
+- README
+- Rakefile
+- lib/signupto
+- lib/signupto/account.rb
+- lib/signupto/action
+- lib/signupto/action/balance.rb
+- lib/signupto/action/base.rb
+- lib/signupto/action/sender.rb
+- lib/signupto/base.rb
+- lib/signupto/message.rb
+- lib/signupto/version.rb
+- lib/signupto.rb
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: 
+- README
+- LICENSE
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+