sms_fu 1.1.1

data/CHANGELOG

@@ -0,0 +1,339 @@
+commit 36591f0eea341a46b48719e1aefa9f7b464a1b93
+Author: Brendan G. Lim <brendangl@gmail.com>
+Date:   Mon Aug 23 23:12:36 2010 -0400
+
+    Updating readme
+
+commit f04b37c5fadbe2f4058782280cc622461b901c0d
+Author: Brendan G. Lim <brendangl@gmail.com>
+Date:   Mon Aug 23 23:09:01 2010 -0400
+
+    Reorganizing for gem
+
+commit 97ee600bab782955a917cf70c971499bfb6fe1f2
+Author: Brendan G. Lim <brendangl@gmail.com>
+Date:   Mon Aug 23 18:09:09 2010 -0400
+
+    Updating for gem consumption
+
+commit a59ba52a34e86c17a02ee4d4f4a1b08d9b3dccc1
+Author: Brendan G. Lim <brendangl@gmail.com>
+Date:   Fri Oct 30 15:17:21 2009 -0400
+
+    Updating README and CHANGELOG
+
+commit 569bf6f5c0d3f47cc2f4c49771f4ddcc4f196f52
+Author: Brendan G. Lim <brendangl@gmail.com>
+Date:   Fri Oct 30 15:15:08 2009 -0400
+
+    Updating README and CHANGELOG
+
+commit f93349785ebcc991bec1b463712d7cfef04fb91b
+Author: pboling <peter.boling@peterboling.com>
+Date:   Fri Oct 23 03:00:06 2009 -0400
+
+    default phrase should not force a blank option tag, now it is optional
+
+commit f77d6d076da2785da5c06e569c9891ba4b198c48
+Author: pboling <peter.boling@peterboling.com>
+Date:   Fri Oct 23 02:23:41 2009 -0400
+
+    added SMSFu.carrier_name(key) to lookup carrier names in the YAML
+
+commit aca2e94475da51114771fec3e29cbf2d69fc77b9
+Author: mike castleman <m@mlcastle.net>
+Date:   Thu Oct 22 18:03:44 2009 -0400
+
+    add nextel to default YAML
+
+commit 8ce7858e829bb409febe5da6e47fa7d2a691e3d2
+Author: pboling <peter.boling@peterboling.com>
+Date:   Thu Oct 22 15:37:50 2009 -0400
+
+    improved setting of RAILS_CONFIG_ROOT
+
+commit e010096f2a9c1f5ddecbad998051b210ba47b3dd
+Author: pboling <peter.boling@peterboling.com>
+Date:   Thu Oct 22 14:59:23 2009 -0400
+
+    fixed tests so that they actually run (and all pass)
+
+commit 0411f1f60ae8be13ac4a732a48e44d3153441002
+Merge: d5a7437 17f23b1
+Author: pboling <peter.boling@peterboling.com>
+Date:   Thu Oct 22 13:51:32 2009 -0400
+
+    Added 8 Canadian Carriers
+
+commit d5a74370ef16af4514d3b9d01983ba3f7b1efb41
+Author: pboling <peter.boling@peterboling.com>
+Date:   Thu Oct 22 13:38:16 2009 -0400
+
+    merge mlc/master
+
+commit f31a115d9a0b4b54913c3c9c79d4b0ce605f8448
+Merge: efd3df6 cd5fc17
+Author: pboling <peter.boling@peterboling.com>
+Date:   Thu Oct 22 13:33:51 2009 -0400
+
+    Merge commit 'mlc/master'
+
+commit efd3df69b9e232f40cacc0e0b94115e7a57e0238
+Author: pboling <peter.boling@peterboling.com>
+Date:   Thu Oct 22 13:33:01 2009 -0400
+
+    merge adamalex/master and added .gitignore
+
+commit 78a08891eb6d9b7b3b3ac78f531c5f4df35fce1c
+Merge: 05679c8 a699a9e
+Author: pboling <peter.boling@peterboling.com>
+Date:   Thu Oct 22 13:28:53 2009 -0400
+
+    Merge commit 'adamalex/master'
+
+commit cd5fc1743e976e35cbaeeba2a3fcf2bf1ad3c5fd
+Author: mike castleman <m@mlcastle.net>
+Date:   Tue Sep 29 16:39:45 2009 -0400
+
+    in carrier_select, allow caller to pre-select a carrier
+
+commit 05679c809195764832f62f9739032a7693d54f78
+Author: Brendan G. Lim <brendangl@gmail.com>
+Date:   Tue Aug 4 00:11:50 2009 -0400
+
+    Fixing typo in yml for BlueSkyFrog
+
+commit b0fd12533cc998618d41c27f2ec18334bf62afe2
+Author: Brendan G. Lim <brendangl@gmail.com>
+Date:   Mon Jul 20 19:15:18 2009 -0400
+
+    Regenerated gemspec for version 1.0.0
+
+commit a9f07f6502b70143058219f8966cb7dc8b237d66
+Author: Brendan G. Lim <brendangl@gmail.com>
+Date:   Mon Jul 20 19:15:09 2009 -0400
+
+    Adding in gemspec
+
+commit 74d6e1c9a109d2b576df148a01a34a9548c1ffd6
+Author: Brendan G. Lim <brendangl@gmail.com>
+Date:   Mon Jul 20 19:13:41 2009 -0400
+
+    Version bump to 0.0.0
+
+commit 899050db2a8877fe508738811c121247571aaea2
+Author: Brendan G. Lim <brendangl@gmail.com>
+Date:   Thu Jul 2 11:47:27 2009 -0400
+
+    Adding support for SFR (France)
+
+commit ad7cabcb7eb5ca8001ef187339d382664b1c3e81
+Author: Brendan G. Lim <brendangl@gmail.com>
+Date:   Thu Jul 2 11:40:53 2009 -0400
+
+    Adding Mobistar (Belgium), T-Mobile (Netherlands), and Vodafone (Netherlands) to supporter carrier list
+
+commit a699a9ec3119a717aefdca034b9dacefaab6f57f
+Merge: 03d93f0 15d31df
+Author: Adam Alexander <adamalex@gmail.com>
+Date:   Sun Mar 1 11:49:58 2009 -0500
+
+    Merge commit 'brendanlim/master'
+
+commit 15d31df11aa0d77a688d44955daf9647aad70b2b
+Author: Brent Collier <brentmc79@gmail.com>
+Date:   Sat Feb 28 22:47:53 2009 -0500
+
+    fixin syntax error in helper
+
+commit 1c0903356b8b9ba96acd407e678b84d8fc186c3f
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Sat Feb 28 20:54:46 2009 -0500
+
+    fixing some issues with 2.2
+
+commit 03d93f094b43cd1b66e4ca904b6bb895e2afb087
+Author: Adam Alexander <adamalex@gmail.com>
+Date:   Fri Feb 27 06:07:58 2009 -0500
+
+    Added carrier_select_default to allow for providing default value
+
+commit 7c918f19794ed618b10eb2db5d8dc6e6badadbda
+Author: Adam Alexander <adamalex@gmail.com>
+Date:   Fri Feb 27 06:07:17 2009 -0500
+
+    Modified carrier_collection to return carrier name and key
+
+commit 570b1e244ce64ce318d55e778ec629dc5177f6e8
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Thu Feb 26 17:20:04 2009 -0500
+
+    Message sent out should be in plain text
+
+commit 752126921ea6948c46ac527b9f4b5a67f72a1048
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Tue Feb 24 01:32:35 2009 -0500
+
+    Completely restructing yaml and now showing proper names in select box -- again
+
+commit e06b82db487e937c67a431ad3219a65b187b7827
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Tue Feb 24 01:30:30 2009 -0500
+
+    Completely restructing yaml and now showing proper names in select box
+
+commit f17677ff1d47305d0217f56472a3156277eabda7
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Mon Feb 23 22:53:58 2009 -0500
+
+    Adding in quite a few more mobile carriers to our supported list
+
+commit 1c7c3d79ee9eeae1b0fd55c9f2654633566d308f
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Mon Feb 23 22:44:10 2009 -0500
+
+    Adding in Beeline (UA) to the list of carriers
+
+commit c62df8bf641c3b2e009dd2e64e3585e610778519
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Wed Feb 18 20:26:00 2009 -0500
+
+    ... and I'm updating the changelog once again
+
+commit 8abc7168dd392b083fdfd3a9cb2ce1e7c1d068a0
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Wed Feb 18 20:25:05 2009 -0500
+
+    Some structural changes to SMS Fu
+
+commit 4e5aa349ac9d4c12da5d53de08d1fd3281bcfa0d
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Wed Feb 18 20:12:55 2009 -0500
+
+    Updating CHANGELOG
+
+commit 4c1b777458b90de5d7c01cf7d14ef0be2fdcc4e6
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Wed Feb 18 20:12:33 2009 -0500
+
+    Adding in some view helpers for mobile carrier select boxes and updating README
+
+commit 0d804bdd6e48aa3eae548665c4740b2e2d4e3b86
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Mon Dec 15 14:17:16 2008 -0500
+
+    Adding Etisalat support and adding country designation to mobinil and movistar
+
+commit 0d417e1f30f5b153e9658e5649144630b95c2ec1
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Thu Dec 11 19:09:20 2008 -0500
+
+    Adding Vodafone Egypt, Virgin Mobile Canada, and Mobitel Sri Lanka to supported SMS carriers
+
+commit ec20bd73afe7c26583bcdb7037028161f65cc8a5
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Thu Dec 11 13:31:17 2008 -0500
+
+    Adding a good chunk of carriers into SMS Fu
+
+commit 17f23b116729beaf6dc399d1111f18f0a07b0619
+Author: Michael Edwards <medwards@pilgrim.walledcity.ca>
+Date:   Sat Sep 6 22:00:05 2008 -0600
+
+    added canadian carriers
+
+commit 8d9a829177f6a249206892ccc7a13b8ae5467496
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Thu Jul 31 13:48:30 2008 -0400
+
+    Upating the CHANGELOG
+
+commit 3912b0b91621ba1a827585f3b22c1426fc70c9e4
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Thu Jul 31 13:48:15 2008 -0400
+
+    Adding ability to specify custom from address per mailing
+
+commit 09fc1fa3076082d98b61f7cdf0d10dd5abd30a1a
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Thu Jun 19 02:18:09 2008 -0400
+
+    Updating CHANGELOG
+
+commit f1026d0aca169caf57dd44e57661177bd66e2e37
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Thu Jun 19 02:17:08 2008 -0400
+
+    Updating to be compatibile with Rails 2.1
+
+commit de241d15bfa878f600a462f49b4fd3c92285c3ab
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Sat May 31 10:05:16 2008 -0700
+
+    Merging in changes from gcnovus for fixing warnings and redundant YAML parsing when requiring sms_fu more than once.
+
+commit d23d86216ffc5a6b44db5b354934f40178e9dfc0
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Sat Apr 19 01:23:45 2008 -0500
+
+    Another update to README
+
+commit e8386f3b75f5f4794d5f280025772a34e79542ba
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Sat Apr 19 01:23:17 2008 -0500
+
+    Another update to README
+
+commit d16925d6f60669d492005b419df212d26b3d21bd
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Sat Apr 19 01:17:51 2008 -0500
+
+    Adding in kajeet to carrier list and updated README
+
+commit 9cf4ef9db332418dd167bd942f29ed34d11f20f9
+Author: Jannis Leidel <jannis@leidel.info>
+Date:   Sat Apr 12 13:40:30 2008 +0200
+
+    added some international carriers
+
+commit 364997b52bdb1c7ae8b3382b4742b5fbd52fb20c
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Mon Mar 31 18:23:53 2008 -0400
+
+    Fixed indentation of README and minor tweak
+
+commit 5ecbaaee4d38543a66767b02d5b41ef9e885f2d5
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Mon Mar 31 18:18:40 2008 -0400
+
+    Fixed some of the tests
+
+commit cb0138f5f1f637bcd5065e548b0dac04d413acd8
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Mon Mar 31 17:58:07 2008 -0400
+
+    Quick fix for international numbers
+
+commit fc874c849ed5fb4f7b1e35b3e6b0e1496b95cf4f
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Mon Mar 31 17:45:09 2008 -0400
+
+    Updating README with International carrier information
+
+commit 7813e59c8535f6180852a534fd0bfd7ba6085ace
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Mon Mar 31 17:37:02 2008 -0400
+
+    Adding in international support and externalizing carrier list into sms_fu.yml
+
+commit 5393cc834ce85da8856ed8869e7b5e66b004239f
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Sun Mar 30 19:01:20 2008 -0400
+
+    Made some readme changes
+
+commit aba05f07d765306b5bd5f6c403a318092a437c0b
+Author: Brendan G. Lim <brendan@intridea.com>
+Date:   Sun Mar 30 16:10:05 2008 -0400
+
+    Initial import

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008-2010 Brendan G. Lim (brendan@intridea.com)
+
+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,137 @@
+= SMS Fu (sms_fu)
+
+Want to send an SMS from your Ruby application?  SMS Fu allows you to do just that.  
+It allows you to send a text message in the form of an e-mail to a cell phone on any
+of the many supported carriers.
+
+== Supported Carriers (US & International): 
+
+Alltel, Ameritech, AT&T, Bell Atlantic, BellSouth Mobility, Beeline(UA), BlueSkyFrog, 
+Boost Mobile, BPL Mobile, Cellular South, Claro (Brazil, Nicaragua), Comcast, Du, 
+E-Plus, Etisalat, Fido, kajeet, Mobinil, Mobitel, Movistar, Metro PCS, O2, Orange, 
+Powertel, PSC Wireless, Qwest, Rogers, Southern Link, Sprint, Suncom, 
+T-Mobile (US/UK/Germany), Telefonica, Tracfone, Virgin Mobile, Verizon Wireless, 
+Vodafone (UK, Egypt, Italy, Japan, Spain), and many more ...
+
+== Opt-In Warning for Some International Carriers
+
+Some International carriers require that their users subscribe to an Email to SMS
+feature before they are able to receive SMS messages this way.  If one your users
+mentions that they are not receiving their messages, chances are it is due to this
+limitation.
+
+Some carriers that need this include, Mobitel, Etisalat, T-Mobile (Netherlands), 
+etc.
+
+== Requirements
+
+* SMS Fu requires that 'action_mailer' (>= 3.0.0rc2) and 'pony' (>= 1.0) are installed.  
+
+* If you require SMS Fu on an older version of ActionMailer, make sure to use the older plugin version of SMS Fu at http://github.com/brendanlim/sms-fu/tree/plugin
+
+== Setup Instructions
+
+* Install sms_fu gem
+  
+  sudo gem install sms_fu
+  
+* Add sms_fu.yml to your config folder (Rails only)
+
+  http://github.com/brendanlim/sms-fu/blob/master/templates/sms_fu.yml
+
+* (Optional) Modify sms_fu.yml in your config folder with your reply-to e-mail address.
+
+== Numbers and Carriers
+
+* You have to send in the phone number, without any non-numeric characters.  The
+  phone numbers must be 10 digits in length.  
+* The two required parameters are the phone number and the phone carrier.
+* Here are some of the default carrier values:
+		
+    Alltel Wireless   =>  "alltel"
+    AT&T/Cingular     =>  "at&t"
+    Boost Mobile      =>  "boost"
+    Sprint Wireless   =>  "sprint"
+    T-Mobile US       =>  "t-mobile"
+    T-Mobile UK       =>  "t-mobile-uk"
+    Virgin Mobile     =>  "virgin"
+    Verizon Wireless  =>  "verizon"
+    Vodafone Tokyo    =>  "vodafone-jp-tokyo"
+
+* Check sms_fu.yml for a complete list of supported carriers, including international
+  carriers as well.
+
+== Configuration and Usage
+
+* SMS Fu relies on either ActionMailer or Pony for delivery.  You can now specify 
+  which you'd like to use for delivery.
+
+* You can use your ActionMailer settings by just specifying the :delivery option as 
+  :action_mailer.
+
+* If you would like to use Pony, you can configure it to use :sendmail or :smtp via 
+  Pony.  Set the :delivery option to :pony and then make sure to specify the 
+  :pony_options as well, if necessary.  
+  
+    # ActionMailer delivery
+    sms_fu = SMSFu.configure(:action_mailer)
+
+    # Pony delivery via Sendmail
+    sms_fu = SMSFu.configure(:pony, :pony_options => { :via => :sendmail })
+
+    # Pony delivery via SMTP
+    sms_fu = SMSFu.configure(:pony, :pony_options => { :via => :smtp, 
+        :via_options => {
+          :address              => 'smtp.gmail.com',
+          :port                 => '587',
+          :user_name            => 'username',
+          :password             => 'password',
+          :authentication       => :plain, 
+          :domain               => "localhost.localdomain"
+          :enable_starttls_auto => true,
+      }})
+      
+* You can view more pony 'via_options' at http://github.com/benprew/pony
+      
+* Basic delivery
+
+    sms_fu.deliver("5558675309","at&t","message")
+
+* If you want to set a custom from e-mail per SMS message, you can do so 
+  by doing the following.
+
+    sms_fu.deliver("5558675309","at&t","message", :from => "bob@test.com")
+
+* You can set the maximum length of the SMS message, which is not set by
+  default.  Most phones can only accept 128 characters.  To do this just 
+  specify the limit option.
+
+    sms_fu.deliver("5558675309","at&t","message", :limit => 128)
+
+* You can retrieve just the formatted address to use in your own mailer.
+
+    sms_fu.sms_address("5558675309","at&t") # => "5558675309@txt.att.net"
+
+== View Helpers (Rails)
+
+* Retrieve a collection of all carriers
+
+    <%= carrier_collection %>
+
+* Display a select box with mobile carriers
+
+    <%= carrier_select %>
+    
+* Display a custom select box with mobile carriers
+
+    <%= carrier_select('user[carrier_name]', "Please choose a carrier") %>
+
+== Special Thanks
+
+I want to thank the following individuals with their help with adding some patches to SMS Fu:
+
+* Brent Collier (brentmc79)
+* Peter Boling (pboling)
+* Mike (mic)
+
+Copyright (c) 2010 Brendan G. Lim, Intridea, Inc., released under the MIT license

data/Rakefile

@@ -0,0 +1,23 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the sms_fu plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the sms_fu plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'SmsFu'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+

data/install.rb

@@ -0,0 +1,4 @@
+require 'ftools'
+require 'fileutils'
+puts IO.read(File.join(File.dirname(__FILE__), 'README.rdoc'))
+File.copy(File.dirname(__FILE__)+'/templates/sms_fu.yml', File.dirname(__FILE__)+'/../../../config')

data/lib/sms_fu.rb

@@ -0,0 +1,7 @@
+require 'action_mailer'
+require 'pony'
+require 'yaml'
+
+require 'sms_fu/sms_fu'
+require 'sms_fu/sms_fu_helper'
+require 'sms_fu/sms_notifier'

data/lib/sms_fu/sms_fu.rb

@@ -0,0 +1,112 @@
+module SMSFu
+  class Client
+    DELIVERY_METHODS = [:action_mailer, :pony]
+    attr_accessor :delivery, :pony_config
+
+    # Sets up a new SMSFu::Client.  Allows for use of ActionMailer or
+    # Pony for e-mail delivery.  Pony requires :pony_config to be 
+    # defined to work properly.
+    # 
+    # * ActionMailer 3
+    #   sms_fu = SMSFu::Client.configure(:delivery => :action_mailer)
+    #
+    # * Pony 1.0
+    #   sms_fu = SMSFu::Client.configure(:delivery => :pony, 
+    #      :pony_config => { :via => :sendmail })
+    #
+    def self.configure(opts = {})
+      new(opts)
+    end
+
+    def initialize(opts = {})
+      self.delivery     = opts[:delivery].to_sym
+      self.pony_config  = opts[:pony_config]
+      raise SMSFuException.new("Pony configuration required") if @delivery == :pony && @pony_config.nil?
+    end
+
+    def delivery=(new_delivery)
+      if DELIVERY_METHODS.include?(new_delivery.to_sym)
+        @delivery = new_delivery
+      else
+        raise SMSFuException.new("Delivery options can only be: '#{DELIVERY_METHODS.join(", ")}'")
+      end
+    end
+
+    # Delivers the SMS message in the form of an e-mail
+    #   sms_fu.deliver("1234567890","at&t","hello world")
+    def deliver(number, carrier, message, options = {})
+      raise SMSFuException.new("Can't deliver blank message to #{format_number(number)}") if message.nil? || message.empty?
+
+      limit   = options[:limit] || message.length
+      from    = options[:from] || SMSFu.from_address
+      message = message[0..limit-1]
+      email   = SMSFu.sms_address(number,carrier)
+
+      if @delivery == :pony
+        Pony.mail({:to => email, :body => message, :from => from}.merge!(@pony_config))
+      else
+        SMSNotifier.send_sms(email, message, from).deliver
+      end
+    end
+  end
+  
+  class << self
+    def config_yaml
+      @@config_yaml ||= YAML::load(File.open("#{template_directory}/sms_fu.yml"))
+    end
+  
+    # Returns back a list of all carriers
+    #   SMSFu.carriers
+    def carriers
+      config_yaml['carriers'] 
+    end
+  
+    def from_address
+      config_yaml['config']['from_address']
+    end
+
+    def carrier_name(key)
+      carrier(key)['name']
+    end
+  
+    def carrier_email(key)
+      carrier(key.downcase)['value']
+    end
+    
+    def carrier(key)
+      raise SMSFuException.new("Carrier (#{key}) is not supported") unless SMSFu.carriers.has_key?(key.downcase)
+      carriers[key]
+    end
+
+    # Returns back a properly formatted SMS e-mail address
+    #   SMSFu.sms_address("1234567890","at&t")
+    def sms_address(number,carrier)
+      raise SMSFuException.new("Missing number or carrier") if number.nil? || carrier.nil?
+      format_number(number) + carrier_email(carrier.downcase)
+    end
+
+    protected
+
+    def format_number(number)
+      stripped = number.gsub("-","").strip
+      formatted = (stripped.length == 11 && stripped[0,1] == "1") ? stripped[1..stripped.length] : stripped
+      raise SMSFuException.new("Number (#{number}) is not formatted correctly") unless valid_number?(formatted)
+      formatted
+    end
+
+    def valid_number?(number)
+      number.length >= 10 && number[/^.\d+$/]
+    end  
+
+    def template_directory
+      directory = defined?(Rails) ? "#{RAILS_ROOT}/config" : "#{File.dirname(__FILE__)}/../../templates"
+      if (defined?(Rails) && Rails.env == 'test') || (defined?(RAILS_ENV) && RAILS_ENV == 'test)')
+        "#{File.dirname(__FILE__)}/../../templates"
+      else
+        directory
+      end
+    end
+  end
+end
+
+class SMSFuException < StandardError; end

data/lib/sms_fu/sms_fu_helper.rb

@@ -0,0 +1,19 @@
+module SMSFuHelper  
+  # Returns a collection of carriers to be used in your own select tag
+  #   e.g., <%= f.select :mobile_carrier, carrier_collection %>
+  def carrier_collection
+    SMSFu.carriers.sort.collect{ |carrier| [carrier[1]["name"], carrier[0]] }
+  end
+  
+  # Returns a formatted select box filled with carriers
+  #   e.g., <%= carrier_select %>
+  # - name => name of the method in which you want to store the carrier name
+  # - phrase => default selected blank option in select box 
+  # - selected => carrier to pre-select
+  # - include_blank => Do you want the blank option tag (in ADDITION to the value-less 'phrase' option above)?
+  def carrier_select(name = :mobile_carrier, phrase = "Select a Carrier", selected = nil, include_blank = true)
+    options = phrase.nil? ? carrier_collection : include_blank ? [phrase,nil] + carrier_collection : [phrase] + carrier_collection
+    select_tag name, options_for_select(options, selected || phrase)
+  end
+
+end

data/lib/sms_fu/sms_notifier.rb

@@ -0,0 +1,8 @@
+class SMSNotifier < ActionMailer::Base
+  def send_sms(recipient, message, sender_email)
+    mail(:to => recipient, :from => sender_email, :subject => '') do |format|
+      format.text { render :text => message }
+      format.html { render :text => message }
+    end
+  end  
+end

data/sms_fu.gemspec

@@ -0,0 +1,55 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{sms_fu}
+  s.version = "1.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Brendan G. Lim"]
+  s.date = %q{2010-08-23}
+  s.description = %q{SMS Fu allows you to send text messages to a mobile recipient for free.  It leverages ActionMailer or Pony for delivery of text messages through e-mail.}
+  s.email = %q{brendangl@gmail.com}
+  s.extra_rdoc_files = [
+    "README.rdoc"
+  ]
+  s.files = [
+    "CHANGELOG",
+     "MIT-LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "install.rb",
+     "lib/sms_fu.rb",
+     "lib/sms_fu/sms_fu.rb",
+     "lib/sms_fu/sms_fu_helper.rb",
+     "lib/sms_fu/sms_notifier.rb",
+     "sms_fu.gemspec",
+     "tasks/sms_fu_tasks.rake",
+     "templates/sms_fu.yml",
+     "test/sms_fu_test.rb"
+  ]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/brendanlim/sms-fu}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{sms_fu allows you to send free text messages to a mobile recipient.}
+  s.test_files = [
+    "test/sms_fu_test.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<action_mailer>, [">= 3.0.0.rc2"])
+      s.add_development_dependency(%q<pony>, [">= 1.0"])
+    else
+      s.add_dependency(%q<action_mailer>, [">= 3.0.0.rc2"])
+      s.add_dependency(%q<pony>, [">= 1.0"])
+    end
+  else
+    s.add_dependency(%q<action_mailer>, [">= 3.0.0.rc2"])
+    s.add_dependency(%q<pony>, [">= 1.0"])
+  end
+end

data/templates/sms_fu.yml

@@ -0,0 +1,233 @@
+config:
+  from_address: noreply@domain.com
+  
+carriers:
+  alltel:
+    name: Alltel
+    value: @message.alltel.com
+  ameritech:
+    name: Ameritech
+    value: @paging.acswireless.com
+  at&t: 
+    name: AT&T
+    value: @txt.att.net
+  bell-atlantic: 
+    name: Bell Atlantic
+    value: @message.bam.com
+  bellsouthmobility:
+    name: Bellsouth Mobility
+    value: @blsdcs.net
+  blueskyfrog: 
+    name: BlueSkyFrog
+    value: @blueskyfrog.com
+  boost: 
+    name: Boost Mobile
+    value: @myboostmobile.com
+  cellularsouth: 
+    name: Cellular South
+    value: @csouth1.com
+  comcast: 
+    name: Comcast PCS
+    value: @comcastpcs.textmsg.com
+  cricket: 
+    name: Cricket
+    value: @sms.mycricket.com
+  kajeet: 
+    name: kajeet
+    value: @mobile.kajeet.net
+  metropcs: 
+    name: Metro PCS
+    value: @mymetropcs.com
+  nextel:
+    name: Nextel
+    value: @messaging.nextel.com
+  powertel: 
+    name: Powertel
+    value: @ptel.net
+  pscwireless: 
+    name: PSC Wireless
+    value: @sms.pscel.com
+  qwest: 
+    name: Qwest
+    value: @qwestmp.com
+  southernlink: 
+    name: Southern Link
+    value: @page.southernlinc.com
+  sprint: 
+    name: Sprint PCS
+    value: @messaging.sprintpcs.com
+  suncom: 
+    name: Suncom
+    value: @tms.suncom.com
+  t-mobile: 
+    name: T-Mobile
+    value: @tmomail.net
+  tracfone: 
+    name: Tracfone
+    value: @mmst5.tracfone.com
+  telus-mobility: 
+    name: Telus Mobility
+    value: @msg.telus.com
+  virgin: 
+    name: Virgin Mobile
+    value: @vmobl.net
+  verizon: 
+    name: Verizon Wireless
+    value: @vtext.com
+  # International Carriers
+  aliant-canada:
+    name: Aliant (Canada)
+    value: @chat.wirefree.ca
+  beeline-ua: 
+    name: Beeline
+    value: @sms.beeline.ua
+  bellmobility-canada:
+    name: Bell Mobility (Canada)
+    value: @txt.bell.ca
+  bpl-mobile: 
+    name: BPL Mobile
+    value: @bplmobile.com
+  claro-brazil:
+    name: Claro (Brazil)
+    value: @clarotorpedo.com.br
+  claro-nicaragua: 
+    name: Claro (Nicaragua)
+    value: @ideasclaro-ca.com
+  du-arab-emirates: 
+    name: Du (UAE)
+    value: @email2sms.ae
+  e-plus-germany: 
+    name: E-Plus (Germany)
+    value: @smsmail.eplus.de
+  etisalat-arab-emirates: 
+    name: Etisalat (UAE)
+    value: @email2sms.ae
+  fido-canada: 
+    name: Fido
+    value: @fido.ca
+  manitobatelecom-canada:
+    name: Manitoba Telecom (Canada)
+    value: @text.mtsmobility.com
+  mobinil-egypt:
+    name: Mobinil
+    value: @mobinil.net
+  mobistar-belgium: 
+    name: Mobistar (Belgium)
+    value: @mobistar.be
+  mobitel: 
+    name: Mobitel
+    value: @sms.mobitel.lk
+  movistar-spain: 
+    name: Movistar (Spain)
+    value: @correo.movistar.net
+  northerntel-canada:
+    name: NorthernTel (Canada)
+    value: @txt.northerntelmobility.com
+  o2-germany: 
+    name: o2 (Germany)
+    value: @o2online.de
+  o2-uk: 
+    name: o2 (UK)
+    value: @mmail.co.uk
+  orange-mumbai: 
+    name: Orange (Mumbai)
+    value: @orangemail.co.in
+  orange-netherlands: 
+    name: Orange (Netherlands)
+    value: @sms.orange.nl
+  orange-uk: 
+    name: Orange (UK)
+    value: @orange.net
+  rogers-wireless: 
+    name: Rogers Wireless
+    value: @pcs.rogers.com
+  rogers-canada:
+    name: Rogers (Canada)
+    value: @pcs.rogers.ca
+  sasktel-canada:
+    name: SaskTel (canada)
+    value: @sms.sasktel.ca
+  sfr-france: 
+    name: SFR (France)
+    value: @sfr.fr
+  t-mobile-austria: 
+    name: T-Mobile (Austria)
+    value: @sms.t-mobile.at
+  t-mobile-germany: 
+    name: T-Mobile (Germany)
+    value: @t-d1-sms.de
+  t-mobile-germany: 
+    name: T-Mobile (Netherlands)
+    value: @gin.nl
+  t-mobile-uk: 
+    name: T-Mobile (UK)
+    value: @t-mobile.uk.net
+  telebec-canada:
+    name: Telebec (Canada)
+    value: @txt.telebecmobilite.com
+  telefonica-spain: 
+    name: Telefonica (Spain)
+    value: @movistar.net
+  telus-canada:
+    name: Telus (Canada)
+    value: @msg.telus.com
+  virgin-canada:
+    name: Virgin (Canada)
+    value: @vmobile.ca 
+  vodafone-germany: 
+    name: Vodafone (Germany)
+    value: @vodafone-sms.de
+  vodafone-egypt: 
+    name: Vodafone (Egypt)
+    value: @vodafone.com.eg
+  vodafone-uk: 
+    name: Vodafone (UK)
+    value: @sms.vodafone.net
+  vodafone-italy: 
+    name: Vodafone (Italy)
+    value: @sms.vodafone.it
+  vodafone-jp-chuugoku: 
+    name: Vodafone (Japan - Chuugoku)
+    value: @n.vodafone.ne.jp
+  vodafone-jp-hokkaido: 
+    name: Vodafone (Japan - Hokkaido)
+    value: @d.vodafone.ne.jp
+  vodafone-jp-hokuriko: 
+    name: Vodafone (Japan - Hokuriko)
+    value: @r.vodafone.ne.jp
+  vodafone-jp-kansai: 
+    name: Vodafone (Japan - Kansai)
+    value: @k.vodafone.ne.jp
+  vodafone-jp-osaka: 
+    name: Vodafone (Japan - Osaka)
+    value: @k.vodafone.ne.jp
+  vodafone-jp-kanto: 
+    name: Vodafone (Japan - Kanto)
+    value: @k.vodafone.ne.jp
+  vodafone-jp-koushin: 
+    name: Vodafone (Japan - Koushin)
+    value: @k.vodafone.ne.jp
+  vodafone-jp-tokyo: 
+    name: Vodafone (Japan - Tokyo)
+    value: @k.vodafone.ne.jp
+  vodafone-jp-kyuushu: 
+    name: Vodafone (Japan - Kyuushu)
+    value: @q.vodafone.ne.jp
+  vodafone-jp-okinawa: 
+    name: Vodafone (Japan - Okinawa)
+    value: @q.vodafone.ne.jp
+  vodafone-jp-shikoku: 
+    name: Vodafone (Japan - Shikoku)
+    value: @s.vodafone.ne.jp
+  vodafone-jp-touhoku: 
+    name: Vodafone (Japan - Touhoku)
+    value: @h.vodafone.ne.jp
+  vodafone-jp-niigata: 
+    name: Vodafone (Japan - Niigata)
+    value: @h.vodafone.ne.jp
+  vodafone-jp-toukai: 
+    name: Vodafone (Japan - Toukai)
+    value: @h.vodafone.ne.jp
+  vodafone-spain: 
+    name: Vodafone (Japan - Spain)
+    value: @vodafone.es

data/test/sms_fu_test.rb

@@ -0,0 +1,22 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+class SmsFuTest < Test::Unit::TestCase
+  include SMSFu
+  
+  def test_validity_of_number
+    assert_raise(SMSFuException) { deliver_sms("456789011","AT&T","Message") }
+    assert_equal("5555555555@txt.att.net", get_sms_address("1-555-555-5555","AT&T"))
+  end
+
+  def test_international_number
+    assert_equal("+445555555555@txt.att.net", get_sms_address("+44-555-555-5555","AT&T"))
+  end
+  
+  def test_handling_of_blank_message
+    assert_raise(SMSFuException) { deliver_sms("1234567890","AT&T","") }
+  end
+
+  def test_get_sms_address
+    assert_equal("1234567890@txt.att.net", get_sms_address("1234567890","AT&T"))
+  end
+end

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification 
+name: sms_fu
+version: !ruby/object:Gem::Version 
+  hash: 17
+  prerelease: false
+  segments: 
+  - 1
+  - 1
+  - 1
+  version: 1.1.1
+platform: ruby
+authors: 
+- Brendan G. Lim
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-08-23 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: action_mailer
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 977940607
+        segments: 
+        - 3
+        - 0
+        - 0
+        - rc2
+        version: 3.0.0.rc2
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: pony
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 1
+        - 0
+        version: "1.0"
+  type: :development
+  version_requirements: *id002
+description: SMS Fu allows you to send text messages to a mobile recipient for free.  It leverages ActionMailer or Pony for delivery of text messages through e-mail.
+email: brendangl@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- CHANGELOG
+- MIT-LICENSE
+- README.rdoc
+- Rakefile
+- install.rb
+- lib/sms_fu.rb
+- lib/sms_fu/sms_fu.rb
+- lib/sms_fu/sms_fu_helper.rb
+- lib/sms_fu/sms_notifier.rb
+- sms_fu.gemspec
+- tasks/sms_fu_tasks.rake
+- templates/sms_fu.yml
+- test/sms_fu_test.rb
+has_rdoc: true
+homepage: http://github.com/brendanlim/sms-fu
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: sms_fu allows you to send free text messages to a mobile recipient.
+test_files: 
+- test/sms_fu_test.rb