nileshtrivedi-gupshup 0.1.1 → 0.1.3

data/README.rdoc

@@ -14,22 +14,36 @@ http://enterprise.smsgupshup.com/doc/GatewayAPIDoc.doc
 
 == FEATURES:
 
+* V 0.1.2 Bulk file upload implemented. Only CSV format supported for now.
 * V 0.1.0 send_vcard and send_unicode_message implemented. Error checking.
 * V 0.0.5 send_text_message and send_flash_message are implemented
 * V 0.0.1 send_message is implemented.
 
 == USAGE:
 
+  # "target_phone_number" should be a 12 digit Indian mobile number starting with "919" (either integer or string)
+
   gup = Gupshup::Enterprise.new('your_gupshup_login','password')
+
+  #send a normal text message
   gup.send_text_message('sms message text',target_phone_number)
+
+  #flash messages appear on mobile's screen immediately but may not be saved on some handsets
   gup.send_flash_message('sms message text',target_phone_number)
+
+  #send a contact in VCARD format
+  vcard = "BEGIN:VCARD\r\nVERSION:1.2\r\nN:ICICI\r\nTEL:18002098888\r\nEND:VCARD"
   gup.send_vcard(vcard,target_phone_number)
-  gup.send_unicode_message(unicode_message_in_utf8_encoding,target_phone_number)
 
- target_phone_number should be a 12 digit India mobile number starting with "919"
+  #send a non-english message with a hex-encoded UTF-8 string
+  gup.send_unicode_message("\xE0\xA4\x97\xE0\xA4\xAA\xE0\xA4\xB6\xE0\xA4\xAA",target_phone_number) # will send "gupshup" in Devnagari script
+
+  #Upload a CSV file for bulk messages
+  gup.bulk_file_upload(file_path)
+
 == REQUIREMENTS:
 
-* uri, cgi, http
+* httpclient
 
 == INSTALL:
 

data/lib/gupshup.rb

@@ -4,9 +4,10 @@ $:.unshift(File.dirname(__FILE__)) unless
 require 'net/http'
 require 'uri'
 require 'cgi'
+require 'httpclient'
 
 module Gupshup
-  VERSION = '0.1.0'
+  VERSION = '0.1.2'
   class Enterprise
     def initialize(login,password)
       @api_url = 'http://enterprise.smsgupshup.com/GatewayAPI/rest'
@@ -66,5 +67,17 @@ module Gupshup
     def send_unicode_message(msg,number,opts = {})
       send_message(msg,number,:UNICODE_TEXT,opts)
     end
+
+    def bulk_file_upload(file_path,file_type = 'csv',mime_type = 'text/csv', opts = {})
+      msg_params = {}
+      msg_params[:method] = 'xlsUpload'
+      msg_params[:filetype] = file_type.to_s
+      file = File.new(file_path,"r")
+      def file.mime_type; "text/csv"; end
+      msg_params[:xlsFile] = file
+      resp = HTTPClient.post(@api_url,msg_params.merge(@api_params).merge(opts))
+      file.close
+      puts resp.body.content
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: nileshtrivedi-gupshup
 version: !ruby/object:Gem::Version 
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors: 
 - Nilesh Trivedi
@@ -9,18 +9,18 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-08-17 00:00:00 -07:00
+date: 2009-09-05 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  name: hoe
-  type: :development
+  name: httpclient
+  type: :runtime
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 2.3.3
+        version: 2.1.5.2
     version: 
 description: Ruby wrapper for SMSGupShup API
 email: 
@@ -47,7 +47,6 @@ files:
 - test/test_helper.rb
 has_rdoc: false
 homepage: http://github.com/nileshtrivedi/gupshup
-licenses: 
 post_install_message: PostInstall.txt
 rdoc_options: 
 - --main
@@ -69,7 +68,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: gupshup
-rubygems_version: 1.3.5
+rubygems_version: 1.2.0
 signing_key: 
 specification_version: 3
 summary: Ruby wrapper for SMSGupShup API