sms 0.1

data/README.md

@@ -0,0 +1,45 @@
+# sms
+
+Send text messages with [Twilio](http://www.twilio.com/). Easily.
+
+## Installation
+
+	gem install sms
+
+Or put `gem 'sms'` in your `Gemfile`.
+
+
+## Usage
+
+Set the following ENV variables:
+
+* `TWILIO_ID`: Your Twilio API id token.
+* `TWILIO_SECRET`: Your Twilio API secret token.
+* `TWILIO_PHONE`: One of your Twilio phone numbers.
+
+Then, send some SMS messages:
+
+    SMS.text :message => "Hello!", :to => "15558675309"
+
+Calling `SMS.text` returns true if the message was sent, or false if it wasn’t.
+
+
+## Testing
+To run the test suite, put a YAML file with the following keys at `~/.twilio`:
+
+* `sid`: Your Twilio API ID token.
+* `secret`: Your Twilio API secret token.
+* `from`: Twilio phone number to send test message from.
+* `to`: Phone number to send test message to.
+
+This is a bit of a hack. Unfortunately, Twilio doesn’t offer testing credentials.
+
+
+## Credits
+* This is a heavily–modified fork of [sms-rb](https://github.com/nakajima/sms-rb).
+
+
+## TODO
+* Consolidate YAML/ENV/options – should be able to set all from any method.
+* Support loading config directly from arbitrary YAML files.
+

data/lib/sms.rb

@@ -0,0 +1,35 @@
+require 'uri'
+require 'net/https'
+
+module SMS
+  attr_accessor :sid, :secret, :from
+  
+  def self.text(options={})
+    @sid = ENV.delete('TWILIO_ID') if ENV.key?('TWILIO_ID')
+    @secret = ENV.delete('TWILIO_SECRET') if ENV.key?('TWILIO_SECRET')
+    @from = ENV.delete('TWILIO_PHONE') if ENV.key?('TWILIO_PHONE')
+	@from = options[:from] if options.key?(:from)
+	return false if @from.nil? or @from == ''
+	return false unless options.key?(:message)
+	return false unless options.key?(:to)
+    
+    url = URI.parse "https://api.twilio.com/2010-04-01/Accounts/#{@sid}/SMS/Messages"
+    http = Net::HTTP.new(url.host, url.port)
+    http.use_ssl = true
+	http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+        
+    request = Net::HTTP::Post.new(url.path)
+	request.basic_auth @sid, @secret
+    request.set_form_data({
+	  'From' => @from,
+	  'To' => options[:to],
+	  'Body' => options[:message],
+	})
+    
+    response = http.start do |http|
+      http.request(request)
+    end
+	response.code[0..0] == '2' # eg, 2xx
+  end
+end
+

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification 
+name: sms
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  version: "0.1"
+platform: ruby
+authors: 
+- Bill Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-08-03 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: 
+email: bill@flpatriot.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.md
+- lib/sms.rb
+has_rdoc: true
+homepage: https://github.com/flpatriot/sms
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Send SMS messages with Twilio.
+test_files: []
+