mailgun_api 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    Y2JmZGQ4YzhkNTNhNmRkNTYxZjI5ZjE2MTczM2IzNjY1N2M2Mzg5Yw==
+  data.tar.gz: !binary |-
+    NDIzYjc1M2MyZWY4MjRmYjFhYjZkMDJjMTA3M2RiMDFmNTI3NjRhMg==
+SHA512:
+  metadata.gz: !binary |-
+    OTM3NDU4YWViYTZjYWU4MTJjNTY4NWExZGM1NjEzMDhlZWU5OTIwNWQwMDMx
+    Yzk2Y2E3MWNmZGFlNjRjZmQyMzMzM2Y0MjM4MTFjZjQzOTFkNjdhMDk4Mjc2
+    MjJhMzY1YzEzNWQ0NjI3Mzk5NmQ2MTBhNzU3ZTQzMDc1ZDA5MGY=
+  data.tar.gz: !binary |-
+    NjU0YzNjMTVmNjAyYTYyZmI0ZGIxNWZmOGNiNGQ3ZGRkYWRkZTY4MzY3Njc1
+    NmJlNDI3NzMzODQ3MmU0YjNkMDIwN2U2NDcxMWExOWUyOTYwOWFjMTIwZjc1
+    MWM0YmRmYjkzOTQ3Mjc5OWY3OTBhNzg2ZWQ2MTdhNzE2NzEyNzU=

data/lib/mailgun/list.rb

@@ -0,0 +1,130 @@
+require 'pry'
+
+module Gun
+
+  # Mailing List functionality
+  # Refer http://documentation.mailgun.net/api-mailinglists.html for optional parameters
+
+
+  class List
+    attr_accessor :properties
+
+    # Used internally
+    def initialize(mailgun)
+      @mailgun = mailgun
+    end
+
+    # List all mailing lists
+    def list(options={})
+      @mailgun.response = Mailgun.fire(:get, list_url, options)["items"] || []
+    end
+
+    # List a single mailing list by a given address
+    def find(list_name)
+      @mailgun.response = Mailgun.fire(:get, list_url(list_name))
+      @properties = @mailgun.response["list"]
+    end
+
+    # Create a mailing list with a given address
+    def create(list_name, options={})
+      params = {:address => list_name}
+      @mailgun.response = Mailgun.fire(:post, list_url, params.merge(options))
+    end
+
+    # Update a mailing list with a given address
+    # with an optional new address, name or description
+    def update(params={})
+      return unless !params.empty?
+      @mailgun.response = Mailgun.fire(:put, list_url(self.address), params)
+    end   
+
+    # Deletes a mailing list with a given address
+    def delete
+      @mailgun.response = Mailgun.fire(:delete, list_url(self.address))
+    end
+
+
+    def members
+      @mailgun.response = Mailgun.fire(:get, list_url(self.address) + "/members")["items"] || []
+    end
+
+
+    def stats
+      @mailgun.response = Mailgun.fire(:get, list_url(self.address) + "/stats")
+    end
+
+
+    def add_member(params={})
+
+      if params.class == String
+        add_member_by_hash(params)
+      end
+
+      if params.class == Hash
+        add_member_by_hash(params)
+      end
+
+      if params.class == Array
+        add_members(params)
+      end
+
+
+    end
+
+
+    def update_member(address, params={})
+      return unless !params.empty?
+      @mailgun.response = Mailgun.fire(:put, list_url(self.address) + "/members/#{address}", params)
+    end
+
+
+    def find_member(address)
+      @mailgun.response = Mailgun.fire(:get, list_url(self.address) + "/members/#{address}")
+    end
+
+
+    def remove_member(address)
+      @mailgun.response = Mailgun.fire(:delete, list_url(self.address) + "/members/#{address}")
+    end
+
+
+    def method_missing(name, *args)
+
+      if properties.has_key?(name.to_s)
+        @properties[name.to_s]
+      end
+    end
+
+
+
+
+    private
+
+    def add_member_by_name(params)
+      address = params
+      params = {}
+      params[:address] = address
+      @mailgun.response = Mailgun.fire(:post, list_url(self.address) + "/members", params)
+    end
+
+    def add_member_by_hash(params)
+      @mailgun.response = Mailgun.fire(:post, list_url(self.address) + "/members", params)
+    end
+
+
+    def add_members(members)
+      params = {}
+      params['members'] = members.to_json
+      @mailgun.response = Mailgun.fire(:post, list_url(self.address) + "/members.json", params)
+    end
+
+
+
+
+    # Helper method to generate the proper url for Mailgun mailbox API calls
+    def list_url(address=nil)
+      "#{@mailgun.api_url}/lists#{'/' + address if address}"
+    end
+    
+  end
+end

data/lib/mailgun_api.rb

@@ -0,0 +1,50 @@
+require "rest-client"
+require "json"
+require "mailgun/list"
+
+class Mailgun
+
+  attr_accessor :host, :protocol, :api_version, :test_mode, :api_key, :domain, :response
+
+  def initialize(params={})
+    @host         = params.fetch(:host, "api.mailgun.net")
+    @protocol     = params.fetch(:protocol, "https")
+    @api_version  = params.fetch(:api_version, "v2")
+    @test_mode    = params.fetch(:test_mode, false)
+    @api_key      = params.fetch(:api_key) { raise ArgumentError.new(":api_key is a required argument to initialize Mailgun") if api_key.nil?}
+    @domain       = params.fetch(:domain, nil)
+  end
+
+  def find_list(list_name)
+    list = Gun::List.new(self)
+    list.find("#{list_name}@#{domain}")
+    list
+  end
+
+  def lists
+    Gun::List.new(self).list
+  end
+
+  def create_list(list_name, options={})
+    Gun::List.new(self).create("#{list_name}@#{domain}", options)
+  end
+
+
+  # Returns the api url used in all Mailgun API calls
+  def api_url
+    "#{protocol}://api:#{api_key}@#{host}/#{api_version}"
+  end
+    
+
+  def self.fire(method, url, parameters={})
+
+    parameters = {:params => parameters} if method == :get    
+
+    # puts method
+    # puts url
+    # puts parameters
+
+    return JSON(RestClient.send(method, url, parameters))
+  end
+
+end

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: mailgun_api
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Michael Irey
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-11-14 00:00:00.000000000 Z
+dependencies: []
+description: A library for interfacing with the Mailgun API
+email: michael.irey@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/mailgun_api.rb
+- lib/mailgun/list.rb
+homepage: http://rubygems.org/gems/mailgun_api
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.9
+signing_key: 
+specification_version: 4
+summary: Library for the Mailgun API
+test_files: []