gatling_gun 0.0.1

data/gatling_gun.gemspec

@@ -0,0 +1,30 @@
+DIR     = File.dirname(__FILE__)
+LIB     = File.join(DIR, *%w[lib gatling_gun.rb])
+VERSION = open(LIB) { |lib|
+  lib.each { |line|
+    if v = line[/^\s*VERSION\s*=\s*(['"])(\d\.\d\.\d)\1/, 2]
+      break v
+    end
+  }
+}
+
+SPEC = Gem::Specification.new do |s|
+  s.name        = "gatling_gun"
+  s.version     = VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["James Edward Gray II"]
+  s.email       = ["james@graysoftinc.com"]
+  s.homepage    = "https://github.com/okrb/gatling_gun"
+  s.summary     = "A Ruby library wrapping SendGrid's Newsletter API."
+  s.description = <<-END_DESCRIPTION.gsub(/\s+/, " ").strip
+  A library for working with SendGrid's Newsletter API.  The code is intended
+  for managing and sending newletters.
+  END_DESCRIPTION
+
+  s.required_ruby_version     = ">= 1.9.2"
+  s.required_rubygems_version = ">= 1.3.7"
+
+  s.files         = `git ls-files`.split("\n")
+  # s.test_files    = `git ls-files -- test/*.rb`.split("\n")
+  s.require_paths = %w[lib]
+end

data/lib/gatling_gun.rb

@@ -0,0 +1,195 @@
+require "json"
+require "net/https"
+require "openssl"
+require "time"
+require "uri"
+
+require "gatling_gun/api_call"
+require "gatling_gun/response"
+
+class GatlingGun
+  VERSION = "0.0.1"
+  
+  def initialize(api_user, api_key)
+    @api_user = api_user
+    @api_key  = api_key
+  end
+  
+  ###################
+  ### Newsletters ###
+  ###################
+  
+  def add_newsletter(newsletter, details)
+    fail ArgumentError, "details must be a Hash" unless details.is_a? Hash
+    %w[identity subject].each do |field|
+      unless details[field.to_sym] or details[field]
+        fail ArgumentError, "#{field} is a required detail"
+      end
+    end
+    unless details[:text] or details["text"] or
+           details[:html] or details["html"]
+      fail ArgumentError, "either text or html must be provided as a detail"
+    end
+    make_api_call("add", details.merge(name: newsletter))
+  end
+
+  def edit_newsletter(newsletter, details)
+    fail ArgumentError, "details must be a Hash"  unless details.is_a? Hash
+    fail ArgumentError, "details cannot be empty" if     details.empty?
+    make_api_call("edit", details.merge(name: newsletter))
+  end
+
+  def get_newsletter(newsletter)
+    make_api_call("edit", name: newsletter)
+  end
+
+  def list_newsletters(newsletter = nil)
+    parameters        = { }
+    parameters[:name] = newsletter if newsletter
+    make_api_call("list", parameters)
+  end
+  
+  def delete_newsletter(newsletter)
+    make_api_call("delete", name: newsletter)
+  end
+  
+  #############
+  ### Lists ###
+  #############
+  
+  def add_list(list, details = { })
+    fail ArgumentError, "details must be a Hash" unless details.is_a? Hash
+    make_api_call("lists/add", details.merge(list: list))
+  end
+  
+  def edit_list(list, details = { })
+    fail ArgumentError, "details must be a Hash"  unless details.is_a? Hash
+    fail ArgumentError, "details cannot be empty" if     details.empty?
+    make_api_call("lists/edit", details.merge(list: list))
+  end
+  
+  def get_list(list = nil)
+    parameters        = { }
+    parameters[:list] = list if list
+    make_api_call("lists/get", parameters)
+  end
+  alias_method :list_lists, :get_list
+  
+  def delete_list(list)
+    make_api_call("lists/delete", list: list)
+  end
+  
+  ##############
+  ### Emails ###
+  ##############
+  
+  def add_email(list, data)
+    json_data = case data
+                when Hash  then data.to_json
+                when Array then data.map(&:to_json)
+                else            fail ArgumentError,
+                                     "details must be a Hash or Array"
+                end
+    make_api_call("lists/email/add", list: list, data: json_data)
+  end
+  alias_method :add_emails, :add_email
+  
+  def get_email(list, emails = nil)
+    parameters         = {list: list}
+    parameters[:email] = emails if emails
+    make_api_call("lists/email/get", parameters)
+  end
+  alias_method :get_emails,  :get_email
+  alias_method :list_emails, :get_email
+  
+  def delete_email(list, emails)
+    make_api_call("lists/email/delete", list: list, email: emails)
+  end
+  alias_method :delete_emails, :delete_email
+  
+  ################
+  ### Identity ###
+  ################
+  
+  def add_identity(identity, details)
+    fail ArgumentError, "details must be a Hash" unless details.is_a? Hash
+    %w[name email address city state zip country].each do |field|
+      unless details[field.to_sym] or details[field]
+        fail ArgumentError, "#{field} is a required detail"
+      end
+    end
+    make_api_call("identity/add", details.merge(identity: identity))
+  end
+  
+  def edit_identity(identity, details)
+    fail ArgumentError, "details must be a Hash"  unless details.is_a? Hash
+    fail ArgumentError, "details cannot be empty" if     details.empty?
+    make_api_call("identity/edit", details.merge(identity: identity))
+  end
+  
+  def get_identity(identity)
+    make_api_call("identity/get", identity: identity)
+  end
+  
+  def list_identities(identity = nil)
+    parameters            = { }
+    parameters[:identity] = identity if identity
+    make_api_call("identity/list", parameters)
+  end
+  
+  def delete_identity(identity)
+    make_api_call("identity/delete", identity: identity)
+  end
+  
+  ##################
+  ### Recipients ###
+  ##################
+  
+  def add_recipient(newsletter, list)
+    make_api_call("recipients/add", name: newsletter, list: list)
+  end
+  alias_method :add_recipients, :add_recipient
+
+  def get_recipient(newsletter)
+    make_api_call("recipients/get", name: newsletter)
+  end
+  alias_method :get_recipients,  :get_recipient
+  alias_method :list_recipients, :get_recipient
+  
+  def delete_recipient(newsletter, list)
+    make_api_call("recipients/delete", name: newsletter, list: list)
+  end
+  alias_method :delete_recipients, :delete_recipient
+  
+  #################
+  ### Schedules ###
+  #################
+  
+  def add_schedule(newsletter, details = { })
+    parameters      = {after: details[:after]}
+    parameters[:at] = details[:at].iso8601.sub("T", " ") \
+      if details[:at].respond_to? :iso8601
+    if not details[:after].nil? and ( not details[:after].is_a?(Integer) or 
+                                      details[:after] < 1 )
+      fail ArgumentError, "after must be a positive integer"
+    end
+    make_api_call("schedule/add", parameters.merge(name: newsletter))
+  end
+  
+  def get_schedule(newsletter)
+    make_api_call("schedule/get", name: newsletter)
+  end
+  
+  def delete_schedule(newsletter)
+    make_api_call("schedule/delete", name: newsletter)
+  end
+  
+  #######
+  private
+  #######
+  
+  def make_api_call(action, parameters = { })
+    ApiCall.new( action, parameters.merge( api_user: @api_user,
+                                           api_key:  @api_key ) ).response
+  end
+end

data/lib/gatling_gun/api_call.rb

@@ -0,0 +1,25 @@
+class GatlingGun
+  class ApiCall
+    BASE_URL = "https://sendgrid.com/api/newsletter"
+    CA_PATH  = File.join(File.dirname(__FILE__), *%w[.. .. data ca-bundle.crt])
+    
+    def initialize(action, parameters)
+      @action     = action
+      @parameters = parameters
+    end
+    
+    def response
+      url               = URI.parse("#{BASE_URL}/#{@action}.json")
+      http              = Net::HTTP.new(url.host, url.port)
+      http.use_ssl      = true
+      http.ca_file      = CA_PATH
+      http.verify_mode  = OpenSSL::SSL::VERIFY_PEER
+      http.verify_depth = 5
+      post              = Net::HTTP::Post.new(url.path)
+      post.set_form_data(@parameters)
+      Response.new(http.start { |session| session.request(post) })
+    rescue => error
+      Response.new("error" => error.message)
+    end
+  end
+end

data/lib/gatling_gun/response.rb

@@ -0,0 +1,59 @@
+class GatlingGun
+  class Response
+    include Enumerable
+    
+    def initialize(response)
+      if response.is_a? Hash
+        @success            = false
+        @http_response_code = nil
+        @data               = response
+      else
+        @success            = response.is_a? Net::HTTPSuccess
+        @http_response_code = response.code
+        @data               = parse(response.body)
+      end
+    end
+    
+    attr_reader :http_response_code
+    
+    def success?
+      @success
+    end
+    
+    def error?
+      not success?
+    end
+    
+    def error_messages
+      Array(self[:errors]) + Array(self[:error])
+    end
+    
+    def [](field)
+      case @data
+      when Hash
+        @data[field.to_s]
+      when Array
+        @data[field]
+      else
+        nil
+      end
+    end
+    
+    def each(&iterator)
+      if @data.is_a? Enumerable
+        @data.each(&iterator)
+      end
+    end
+    
+    #######
+    private
+    #######
+    
+    def parse(body)
+      JSON.parse(body)
+    rescue JSON::JSONError => error
+      @success = false
+      @data    = {"error" => error.message}
+    end
+  end
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: gatling_gun
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- James Edward Gray II
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-09-18 00:00:00.000000000Z
+dependencies: []
+description: A library for working with SendGrid's Newsletter API. The code is intended
+  for managing and sending newletters.
+email:
+- james@graysoftinc.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rvmrc
+- README.markdown
+- Rakefile
+- data/ca-bundle.crt
+- gatling_gun.gemspec
+- lib/gatling_gun.rb
+- lib/gatling_gun/api_call.rb
+- lib/gatling_gun/response.rb
+homepage: https://github.com/okrb/gatling_gun
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.7
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.7.2
+signing_key: 
+specification_version: 3
+summary: A Ruby library wrapping SendGrid's Newsletter API.
+test_files: []