nexmo 0.1.0

data/README.txt

@@ -0,0 +1,42 @@
+A simple wrapper for the Nexmo API (http://nexmo.com/).
+
+Install via rubygems:
+
+  gem install nexmo
+
+Either require it, or add it to your Rails Gemfile:
+
+  require 'nexmo'
+
+  gem 'nexmo'
+
+Construct a client with your Nexmo API credentials:
+
+  nexmo = Nexmo::Client.new('...KEY...', '...SECRET...')
+
+The underlying HTTP object is easily accessible. For example, you may want
+to adjust the SSL verification when testing locally:
+
+  nexmo.http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+Use the send_message method to send an SMS, passing the API parameters
+as a hash:
+
+  response = nexmo.send_message({
+    from: 'RUBY',
+    to: '...NUMBER...',
+    text: 'Hello world'
+  })
+
+If the response is successful you can access the message id, and if it's
+a failure you can either check the error message or choose to raise the
+error as an exception:
+
+  if response.success?
+    # store response.message_id
+  elsif response.failure?
+    # check response.error.message
+    # raise response.error
+  end
+
+Chunky bacon.

data/lib/nexmo.rb

@@ -0,0 +1,68 @@
+require 'net/http'
+require 'json'
+require 'cgi'
+
+module Nexmo
+  class Client
+    def initialize(key, secret)
+      @key, @secret = key, secret
+
+      @http = Net::HTTP.new('rest.nexmo.com', 443)
+
+      @http.use_ssl = true
+    end
+
+    attr_accessor :key, :secret, :http
+
+    def send_message(data)
+      response = post('/sms/json', data.merge(username: @key, password: @secret))
+
+      object = JSON.parse(response.body)['messages'].first
+
+      status = object['status'].to_i
+
+      if status == 0
+        Success.new(object['message-id'])
+      else
+        Failure.new(Error.new(object['error-text']))
+      end
+    end
+
+    private
+
+    def post(path, data)
+      @http.post(path, urlencode(data), {'Content-Type' => 'application/x-www-form-urlencoded'})
+    end
+
+    def urlencode(data)
+      data.map { |k, v| "#{urlescape(k)}=#{urlescape(v)}" }.join('&')
+    end
+
+    def urlescape(value)
+      CGI.escape(value.to_s)
+    end
+  end
+
+  class Success < Struct.new(:message_id)
+    def success?
+      true
+    end
+
+    def failure?
+      false
+    end
+  end
+
+  class Failure < Struct.new(:error)
+    def success?
+      false
+    end
+
+    def failure?
+      true
+    end
+  end
+
+  class Error < StandardError
+  end
+end

data/nexmo.gemspec

@@ -0,0 +1,13 @@
+Gem::Specification.new do |s|
+  s.name = 'nexmo'
+  s.version = '0.1.0'
+  s.platform = Gem::Platform::RUBY
+  s.authors = ['Tim Craft']
+  s.email = ['mail@timcraft.com']
+  s.homepage = 'http://github.com/timcraft/nexmo'
+  s.description = 'A simple wrapper for the Nexmo API'
+  s.summary = 'See description'
+  s.files = Dir.glob('{lib,test}/**/*') + %w(README.txt nexmo.gemspec)
+  s.add_dependency('json', ['~> 1.5.1'])
+  s.require_path = 'lib'
+end

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification
+name: nexmo
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Tim Craft
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-08-24 00:00:00.000000000 +01:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: &2853850 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.5.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *2853850
+description: A simple wrapper for the Nexmo API
+email:
+- mail@timcraft.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/nexmo.rb
+- README.txt
+- nexmo.gemspec
+has_rdoc: true
+homepage: http://github.com/timcraft/nexmo
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: See description
+test_files: []