mandrill-api 1.0.2

data/lib/mandrill.rb

@@ -0,0 +1,107 @@
+require 'rubygems'
+require 'excon'
+require 'json'
+
+require 'mandrill/errors'
+require 'mandrill/api'
+
+module Mandrill
+    class API
+
+        attr_accessor :host, :path, :apikey, :debug, :session
+
+        def initialize(apikey=nil, debug=false)
+            @host = 'https://mandrillapp.com'
+            @path = '/api/1.0/'
+
+            @session = Excon.new @host
+            @debug = debug
+
+            if not apikey
+                if ENV['MANDRILL_APIKEY']
+                    apikey = ENV['MANDRILL_APIKEY']
+                else
+                    apikey = read_configs
+                end
+            end
+
+            raise Error, 'You must provide a Mandrill API key' if not apikey
+            @apikey = apikey
+        end
+
+        def call(url, params={})
+            params[:key] = @apikey
+            params = JSON.generate(params)
+            r = @session.post(:path => "#{@path}#{url}.json", :headers => {'Content-Type' => 'application/json'}, :body => params)
+            
+            cast_error(r.body) if r.status != 200
+            return JSON.parse(r.body)
+        end
+
+        def read_configs()
+            [File.expand_path('~/.mandrill.key'), '/etc/mandrill.key'].delete_if{ |p| not File.exist? p}.each do |path|
+                f = File.new path
+                apikey = f.read.strip
+                f.close
+                return apikey if apikey != ''
+            end
+
+            return nil
+        end
+
+        def cast_error(body)
+
+            error_map = {
+                'ValidationError' => ValidationError,
+                'Invalid_Key' => InvalidKeyError,
+                'Unknown_Template' => UnknownTemplateError,
+                'Invalid_Tag_Name' => InvalidTagNameError,
+                'Invalid_Reject' => InvalidRejectError,
+                'Unknown_Sender' => UnknownSenderError,
+                'Unknown_Url' => UnknownUrlError,
+                'Invalid_Template' => InvalidTemplateError,
+                'Unknown_Webhook' => UnknownWebhookError
+            }
+
+            begin
+                error_info = JSON.parse(body)
+                if error_info['status'] != 'error' or not error_info['name']:
+                    raise Error, "We received an unexpected error: #{body}"
+                end
+                if error_map[error_info['name']]
+                    raise error_map[error_info['name']], error_info['message']
+                else
+                    raise Error, error_info['message']
+                end
+            rescue JSON::ParserError
+                raise Error, "We received an unexpected error: #{body}"
+            end
+        end
+
+        def templates()
+            Templates.new self
+        end
+        def users()
+            Users.new self
+        end
+        def rejects()
+            Rejects.new self
+        end
+        def tags()
+            Tags.new self
+        end
+        def messages()
+            Messages.new self
+        end
+        def urls()
+            Urls.new self
+        end
+        def webhooks()
+            Webhooks.new self
+        end
+        def senders()
+            Senders.new self
+        end
+    end
+end
+

data/lib/mandrill/api.rb

@@ -0,0 +1,204 @@
+module Mandrill
+
+    class Templates
+        attr_accessor :master
+
+        def initialize(master)
+            @master = master
+        end
+
+        def add(name, code, publish=true)
+            _params = {:name => name, :code => code, :publish => publish}
+            return @master.call 'templates/add', _params
+        end
+        def info(name)
+            _params = {:name => name}
+            return @master.call 'templates/info', _params
+        end
+        def update(name, code, publish=true)
+            _params = {:name => name, :code => code, :publish => publish}
+            return @master.call 'templates/update', _params
+        end
+        def publish(name)
+            _params = {:name => name}
+            return @master.call 'templates/publish', _params
+        end
+        def delete(name)
+            _params = {:name => name}
+            return @master.call 'templates/delete', _params
+        end
+        def list()
+            _params = {}
+            return @master.call 'templates/list', _params
+        end
+        def time_series(name)
+            _params = {:name => name}
+            return @master.call 'templates/time-series', _params
+        end
+        def render(template_name, template_content, merge_vars=nil)
+            _params = {:template_name => template_name, :template_content => template_content, :merge_vars => merge_vars}
+            return @master.call 'templates/render', _params
+        end
+    end
+    class Users
+        attr_accessor :master
+
+        def initialize(master)
+            @master = master
+        end
+
+        def info()
+            _params = {}
+            return @master.call 'users/info', _params
+        end
+        def ping()
+            _params = {}
+            return @master.call 'users/ping2', _params
+        end
+        def senders()
+            _params = {}
+            return @master.call 'users/senders', _params
+        end
+    end
+    class Rejects
+        attr_accessor :master
+
+        def initialize(master)
+            @master = master
+        end
+
+        def list(email=nil)
+            _params = {:email => email}
+            return @master.call 'rejects/list', _params
+        end
+        def delete(email)
+            _params = {:email => email}
+            return @master.call 'rejects/delete', _params
+        end
+    end
+    class Tags
+        attr_accessor :master
+
+        def initialize(master)
+            @master = master
+        end
+
+        def list()
+            _params = {}
+            return @master.call 'tags/list', _params
+        end
+        def info(tag)
+            _params = {:tag => tag}
+            return @master.call 'tags/info', _params
+        end
+        def time_series(tag)
+            _params = {:tag => tag}
+            return @master.call 'tags/time-series', _params
+        end
+        def all_time_series()
+            _params = {}
+            return @master.call 'tags/all-time-series', _params
+        end
+    end
+    class Messages
+        attr_accessor :master
+
+        def initialize(master)
+            @master = master
+        end
+
+        def send(message)
+            _params = {:message => message}
+            return @master.call 'messages/send', _params
+        end
+        def send_template(template_name, template_content, message)
+            _params = {:template_name => template_name, :template_content => template_content, :message => message}
+            return @master.call 'messages/send-template', _params
+        end
+        def search(query='*', date_from=nil, date_to=nil, tags=nil, senders=nil, limit=100)
+            _params = {:query => query, :date_from => date_from, :date_to => date_to, :tags => tags, :senders => senders, :limit => limit}
+            return @master.call 'messages/search', _params
+        end
+        def parse(raw_message)
+            _params = {:raw_message => raw_message}
+            return @master.call 'messages/parse', _params
+        end
+        def send_raw(raw_message, from_email=nil, from_name=nil, to=nil)
+            _params = {:raw_message => raw_message, :from_email => from_email, :from_name => from_name, :to => to}
+            return @master.call 'messages/send-raw', _params
+        end
+    end
+    class Urls
+        attr_accessor :master
+
+        def initialize(master)
+            @master = master
+        end
+
+        def list()
+            _params = {}
+            return @master.call 'urls/list', _params
+        end
+        def search(q)
+            _params = {:q => q}
+            return @master.call 'urls/search', _params
+        end
+        def time_series(url)
+            _params = {:url => url}
+            return @master.call 'urls/time-series', _params
+        end
+    end
+    class Webhooks
+        attr_accessor :master
+
+        def initialize(master)
+            @master = master
+        end
+
+        def list()
+            _params = {}
+            return @master.call 'webhooks/list', _params
+        end
+        def add(url, events=[])
+            _params = {:url => url, :events => events}
+            return @master.call 'webhooks/add', _params
+        end
+        def info(id)
+            _params = {:id => id}
+            return @master.call 'webhooks/info', _params
+        end
+        def update(id, url, events=[])
+            _params = {:id => id, :url => url, :events => events}
+            return @master.call 'webhooks/update', _params
+        end
+        def delete(id)
+            _params = {:id => id}
+            return @master.call 'webhooks/delete', _params
+        end
+    end
+    class Senders
+        attr_accessor :master
+
+        def initialize(master)
+            @master = master
+        end
+
+        def list()
+            _params = {}
+            return @master.call 'senders/list', _params
+        end
+        def domains()
+            _params = {}
+            return @master.call 'senders/domains', _params
+        end
+        def info(address)
+            _params = {:address => address}
+            return @master.call 'senders/info', _params
+        end
+        def time_series(address)
+            _params = {:address => address}
+            return @master.call 'senders/time-series', _params
+        end
+    end
+end
+

data/lib/mandrill/errors.rb

@@ -0,0 +1,23 @@
+module Mandrill
+    class Error < Exception
+    end
+    class ValidationError < Error
+    end
+    class InvalidKeyError < Error
+    end
+    class UnknownTemplateError < Error
+    end
+    class InvalidTagNameError < Error
+    end
+    class InvalidRejectError < Error
+    end
+    class UnknownSenderError < Error
+    end
+    class UnknownUrlError < Error
+    end
+    class InvalidTemplateError < Error
+    end
+    class UnknownWebhookError < Error
+    end
+end
+

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification 
+name: mandrill-api
+version: !ruby/object:Gem::Version 
+  hash: 19
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 2
+  version: 1.0.2
+platform: ruby
+authors: 
+- Mandrill Devs
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-07-31 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 1
+        - 7
+        - 4
+        version: 1.7.4
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: excon
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 43
+        segments: 
+        - 0
+        - 15
+        - 4
+        version: 0.15.4
+  type: :runtime
+  version_requirements: *id002
+description: A Ruby API library for the Mandrill email as a service platform.
+email: community@mandrill.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/mandrill.rb
+- lib/mandrill/api.rb
+- lib/mandrill/errors.rb
+homepage: https://bitbucket.org/mailchimp/mandrill-api-ruby/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+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.8.24
+signing_key: 
+specification_version: 3
+summary: A Ruby API library for the Mandrill email as a service platform.
+test_files: []
+