aproxacs-sms_client 0.1.1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 aproxacs
+
+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.rdoc

@@ -0,0 +1,73 @@
+= sms_client
+* http://github.com/aproxacs/sms_client
+
+== DESCRIPTION:
+You can send free SMS message to anybody by using sms_client.
+sms_client uses sites that gives free SMS in Korea, such as paran, joyzen, xpeed, lg telecom.
+Make sure that you have an account on above sites before using sms_client.
+
+== REQUIREMENTS:
+* ruby 1.8.6
+* mechanize
+* activesupport
+
+== INSTALL:
+
+* sudo gem install aproxacs-sms_client
+
+== SYNOPSIS:
+
+# Sending SMS
+
+  SMS::Client.new("xpeed") do |cli|
+    cli.login("ID", "PASSWORD")
+    cli.from = "01012344567"
+    cli.deliver("0107564321", "Hello~ SMS")
+  end
+
+# Another way to send SMS
+
+  client = SMS::Client.paran
+  client.login("ID", "PASSWORD")
+  client.deliver("0107564321", "Hello~ SMS")
+
+# setting Logger
+
+  SMS.log = Logger.new("chang.log")
+
+# send SMS on command line
+
+  send_text <text> <to> <from> <client> <id> <password>
+
+# using client pool.
+# Client pool is useful because the number of available SMS of one site is exhausted,
+# the next available site is used to send SMS
+
+  config = YAML.load_file("config.yml")
+  pool = SMS::ClientPool.new(config)
+  pool.from = "01024077530"
+  pool.first.deliver("0107564321", "Hello~ SMS") # pool.first chooses the one of lower priority.
+
+# config.yml is like below.
+
+  paran:
+    id: "ID"
+    password: "PASS"
+    priority: 4
+  lgt:
+    id: "ID"
+    password: "PASS"
+    priority: 5
+  xpeed:
+    id: "OD"
+    password: "PASS"
+    priority: 2
+  joyzen:
+    id: "ID"
+    password: "PASS"
+    priority: 1
+
+
+== Copyright
+
+Copyright (c) 2009 aproxacs. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,54 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "sms_client"
+    gem.summary = %Q{Free SMS libraray in Korea}
+    gem.email = "aproxacs@gmail.com"
+    gem.homepage = "http://github.com/aproxacs/sms_client"
+    gem.authors = ["aproxacs"]
+    gem.files.include FileList.new('lib/**/*.rb', "bin/*",
+      "LICENCE", "VERSION", "README.rdoc", "Rakefile")
+
+    gem.add_dependency("activesupport", [">= 2.0.2"])
+    gem.add_dependency("mechanize", [">= 0.9.0"])
+    gem.executables = ["send_text"]
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION.yml')
+    config = YAML.load(File.read('VERSION.yml'))
+    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "sms_client #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+

data/VERSION

@@ -0,0 +1 @@
+0.1.1

data/bin/send_text

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require 'rubygems'
+require 'sms_client'
+
+opts = OptionParser.new do |opts|
+  opts.banner = "Send SMS"
+  opts.define_head "Usage: send_text <text> <to> <from> <client> <id> <password>"
+end
+opts.parse!
+
+if ARGV.size < 6
+  puts opts
+  exit 1
+end
+
+text = ARGV.shift
+to = ARGV.shift
+from = ARGV.shift 
+client = ARGV.shift
+id = ARGV.shift
+password = ARGV.shift
+
+puts "Sending SMS to #{to} from #{from} using #{client}"
+puts "  TEXT => #{text}"
+
+SMS::Client.new(client) do |cli|
+  cli.login(id, password)
+  cli.from = from
+  cli.deliver(to, text)
+end
+

data/lib/sms_client/base.rb

@@ -0,0 +1,55 @@
+require "sms_client/client_methods"
+require "sms_client/client/paran_client"
+require "sms_client/client/lgt_client"
+require "sms_client/client/xpeed_client"
+require "sms_client/client/joyzen_client"
+
+require  "sms_client/client_pool"
+
+module SMS
+  class InvalidClientError < Exception
+  end
+
+  class LoingFailedError < Exception
+  end
+
+  def self.log
+    Client.log
+  end
+  def self.log=(l)
+    Client.log = l
+  end
+  
+  class Client
+    cattr_accessor :log
+    def initialize(name)
+      klass = "#{name}_client".downcase.camelize
+      raise InvalidClientError unless SMS.const_defined?(klass)
+      @client = SMS.const_get(klass).new
+      yield self if block_given?
+    end
+
+    def log=(l)
+      self.class.log = l
+    end
+    def log
+      self.class.log
+    end
+    
+    def method_missing(method, *params, &block)
+      @client.send(method, *params)
+    end
+
+    def to_s
+      @client.to_s
+    end
+    
+    class << self
+      def method_missing(method, *params)
+        Client.new(method)
+      rescue InvalidClientError
+        super
+      end
+    end
+  end
+end

data/lib/sms_client/client/joyzen_client.rb

@@ -0,0 +1,38 @@
+module SMS
+  class JoyzenClient
+    include ClientMethods
+    
+    def login(id, password)
+      @agent.follow_meta_refresh = true
+
+      page = @agent.get("http://www.joyzen.co.kr/member/login_01.html?login_url=http%3A%2F%2Fwww.joyzen.co.kr%2Fmember%2Flogin_01.html")
+      page = page.form_with(:name => "login") do |form|
+        form.member_id = id
+        form.member_pw = password
+      end.submit
+
+      page = @agent.get("http://www.joyzen.co.kr/community/message/pop_message.html")
+      page = @agent.get("http://www.joyzen.co.kr/community/message/pop_message.html")
+      @remains = page.search("tr td font strong").first.content.to_i
+
+      SMS.log.info "[Joyzen] Remains : #{remains} times" if SMS.log
+      available?
+    rescue Exception => e
+      SMS.log.debug e if SMS.log
+      false
+    end
+
+    def deliver(to, msg)
+      return false unless super
+      
+      page = @agent.get("http://www.joyzen.co.kr/community/message/pop_message.html")
+      page.form_with(:name => "smssingle") do |form|
+        form.to_message = msg
+        form.phone = from
+        form.group_name1 = to
+      end.submit
+      
+      true
+    end
+  end
+end

data/lib/sms_client/client/lgt_client.rb

@@ -0,0 +1,48 @@
+module SMS
+  class LgtClient
+    include ClientMethods
+    
+    def login(id, password)
+      @agent.get("http://www.lgtelecom.com/index.jsp") do |page|
+        result = page.form_with(:name => "frm_login") do |form|
+          form.login_id = id
+          form.login_pw = password
+        end.submit
+
+        result = result.form_with(:name => "encForm").submit
+      end
+
+      page = @agent.get("http://www.lgtelecom.com/SmsLoginCmd.lgtservice")
+      page = page.form_with(:name => "smsForm") do |form|
+        form.action = "http://www.lgtelecom.com/jsp/mp/smsLogin.jsp"
+      end.submit
+      page = page.forms.first.submit
+      page = @agent.get("http://cworld.ez-i.co.kr/mylgt2007/web2phone.asp")
+      @remains = page.search(".mysms2_1 .accent").first.content.to_i
+      SMS.log.info "[LG Telecom] Remains : #{remains} times" if SMS.log
+      available?
+    rescue Exception => e
+      SMS.log.debug e if SMS.log
+      false
+    end
+
+    def deliver(to, msg)
+      return false unless super
+
+      page = @agent.get("http://cworld.ez-i.co.kr/mylgt2007/web2phone.asp")
+      page = page.iframes.first.click
+      page = page.form_with(:name =>"phone") do |form|
+        form.message = msg
+        form.aliasphone = from
+        form.asRphone = to
+        form.multiRphone = to
+        form.sendcheck = "Y"
+        form.price = "20"
+        form.phonecount = "0"
+        form.namezmoney = "0"
+      end.submit
+
+      true
+    end
+  end
+end

data/lib/sms_client/client/paran_client.rb

@@ -0,0 +1,40 @@
+module SMS
+  class ParanClient
+    include ClientMethods
+    
+    def login(id, password)
+      id, domain = id.split("@")
+      page = @agent.get("http://www.paran.com")
+      page = page.form_with(:name => "fmLogin") do |form|
+        form.action = "http://main.paran.com/mainAction.do?method=paranMainLogin"
+        form.wbUserid = id
+        form.wbPasswd = password
+        form.wbDomain = domain        
+      end.click_button
+      page = @agent.get("http://main.paran.com/paran/login_proc.jsp")
+      page = @agent.get("http://mailsms.paran.com/")
+      if page.search("#smsinfo a").first.content =~ /(\d+).*/
+        @remains = $1.to_i
+      end
+      
+      SMS.log.info "[Paran] Remains : #{remains} times" if SMS.log
+      available?
+    rescue Exception => e
+      SMS.log.debug e if SMS.log
+      false
+    end
+
+    def deliver(to, msg)
+      return false unless super
+
+      page = @agent.get("http://mailsms.paran.com/send.html")
+      page = page.form_with(:name => "smsForm") do |form|
+        form.call = to
+        form.phoneNum = from
+        form.msg = msg
+      end.submit
+
+      true
+    end
+  end
+end

data/lib/sms_client/client/xpeed_client.rb

@@ -0,0 +1,47 @@
+module SMS
+  class XpeedClient
+    include ClientMethods
+    
+    def login(id, password)
+      page = @agent.get("http://imory.xpeed.com/member.im?cmd=loginForm")
+      page = page.form_with(:name => "loginForm") do |form|
+        form.mbrId = id
+        form.mbrPasswd = password
+      end.submit
+
+      page = page.forms.first.submit
+      page = @agent.get("http://imory10.xpeed.com/imory/sms/mobile/mobile2.php")
+
+      page.form_with(:name => "phone_form") do |form|
+        @remains = form.remainFreeStr.split(":").last.to_i
+      end
+
+      SMS.log.info "[Xpeed] Remains : #{remains} times" if SMS.log
+      available?
+    rescue Exception => e
+      SMS.log.debug e if SMS.log
+      false
+    end
+
+    def deliver(to, msg)
+      return false unless super
+      
+      page = @agent.get("http://imory10.xpeed.com/imory/sms/mobile/mobile2.php")
+      page.encoding = "EUC-KR"
+      page.form_with(:name => "phone_form") do |form|
+        form.action = "http://imory10.xpeed.com/imory/sms/mobile/msg_send.php"
+        form.msg = msg
+        form.remainFreeStr=""
+        form.msglen = ""
+        form.rCount = "1"
+        form.phone = from
+        form.recv = to
+        form.sendTime = "now"
+        form.resvFlag = "N"
+        form.sendCount = "1"
+      end.submit
+      
+      true
+    end
+  end
+end

data/lib/sms_client/client_methods.rb

@@ -0,0 +1,47 @@
+module SMS
+  module ClientMethods
+    attr_accessor :priority
+    
+    def initialize
+      @agent = WWW::Mechanize.new do |agent|
+        agent.user_agent_alias = 'Windows IE 7'
+      end
+    end
+
+    def remains
+      @remains ||= 0
+    end
+    def available?
+      remains > 0
+    end
+    
+    def from
+      @from ||= "01012345678"
+    end
+    def from=(num)
+      if valid_number? num
+        @from = num
+      end
+    end
+
+    def deliver(to, msg)
+      return false unless available?
+      return false unless valid_number?(to)
+      return false if msg.strip.empty?
+
+      SMS.log.info("Sending SMS to #{to}") if SMS.log
+      SMS.log.info("==> #{msg}") if SMS.log
+      
+      true
+    end
+
+    def to_s
+      "#{self.class} : avaliable=#{available?}, from=#{from}, remains=#{remains}, priority=#{priority}"
+    end
+
+    protected
+    def valid_number?(num)
+      num =~ /^01\d{8,9}$/
+    end
+  end
+end

data/lib/sms_client/client_pool.rb

@@ -0,0 +1,70 @@
+
+module SMS
+
+  class ClientPool
+    # Config is like this
+    # {"paran" => {"id" => "ID", "password" => "PASSWORD", "priority" => 3},
+    #  "lgt" => {"id" => "ID", "password" => "PASSWORD", "priority" => 1}
+    #  ...
+    # }
+    #
+    def initialize(config)
+      add(config)
+    end
+
+    def clients
+      @clients ||= []
+    end
+
+    def size
+      clients.size
+    end
+
+    def add(cli)
+      if cli.is_a? SMS::Client
+        clients << cli
+      else cli.is_a? Hash
+        cli.each do |key, val|
+          val.symbolize_keys!
+          client = SMS::Client.new(key) do |c|
+            c.priority = val[:priority] || 10
+            c.login(val[:id], val[:password])
+          end
+          clients << client if client.available?
+        end
+      end
+
+      sort
+    end
+
+    def remove(cli)
+      clients.delete(cli)
+    end
+
+    def first
+      clients.each do |cli|
+        next unless cli.available?
+        return cli
+      end
+    end
+
+    def from=(num)
+      clients.each do |c|
+        c.from = num
+      end
+    end
+
+    def to_s
+      clients.inject(["#{self.class} : "]) do |ret, cli|
+        ret << "  (#{cli.to_s})"
+      end.join("\n")
+    end
+
+    private
+    def sort
+      clients.sort! do |a, b|
+        a.priority <=> b.priority
+      end
+    end
+  end
+end

data/lib/sms_client.rb

@@ -0,0 +1,6 @@
+%w(rubygems activesupport yaml mechanize).each {|l| require l}
+
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require "sms_client/base"

data/spec/sms_client_spec.rb

@@ -0,0 +1,5 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "SmsClient" do
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+require 'spec'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'sms_client'
+
+Spec::Runner.configure do |config|
+  
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification 
+name: aproxacs-sms_client
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- aproxacs
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-06-17 00:00:00 -07:00
+default_executable: send_text
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.0.2
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: mechanize
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.0
+    version: 
+description: 
+email: aproxacs@gmail.com
+executables: 
+- send_text
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- README.rdoc
+- Rakefile
+- VERSION
+- bin/send_text
+- lib/sms_client.rb
+- lib/sms_client/base.rb
+- lib/sms_client/client/joyzen_client.rb
+- lib/sms_client/client/lgt_client.rb
+- lib/sms_client/client/paran_client.rb
+- lib/sms_client/client/xpeed_client.rb
+- lib/sms_client/client_methods.rb
+- lib/sms_client/client_pool.rb
+- LICENSE
+has_rdoc: false
+homepage: http://github.com/aproxacs/sms_client
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 3
+summary: Free SMS libraray in Korea
+test_files: 
+- spec/sms_client_spec.rb
+- spec/spec_helper.rb