tuktuk 0.5.4 → 0.6.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2537bbe4a21520034c1c224b03c8a1969d5ab5bc
+  data.tar.gz: b3c980a8467cfdecd7dd5c077c2466f89fec3669
+SHA512:
+  metadata.gz: e926584a25e528c86808aa8ad6b70c4c5ae39a9bd38e902c39eecbb4e36e3c276471a7c022180fc17bb53001ab98e5696f54ef64e22d1af48a0ae1d34241e8fa
+  data.tar.gz: 47914f0eeb2bb7c9b5a6b117f9366cae4f5b0024f7d2c7772581be83aa36ec1ef98ce22177149c3cfe63f48adb87f096cab80dd47a80a443905927e64b2a9438

data/README.md

@@ -39,6 +39,8 @@ else
 end
 ```
 
+You can also call `Tuktuk.deliver!` (with a trailing `!`), in which case it will automatically raise an exception if the response was either a HardBounce or SoftBounce. This is useful when running in the background via Resque or Sidekiq, because it makes you aware of which emails are not getting through, and you can requeue those jobs to have them redelivered.
+
 Delivering multiple
 -------------------
 
@@ -85,7 +87,7 @@ message = { ... }
 response, email = Tuktuk.deliver(message)
 ```
 
-For DKIM to work, you need to set up some TXT records in your domain's DNS. You can use [this tool](http://www.socketlabs.com/domainkey-dkim-generation-wizard/) to generate the key. You should also create [SPF records](http://www.spfwizard.net/) if you haven't.
+For DKIM to work, you need to set up some TXT records in your domain's DNS. You can use [this tool](http://www.socketlabs.com/domainkey-dkim-generation-wizard/) to generate the key. You should also create [SPF records](http://www.spfwizard.net/) if you haven't. Then use [this tool](https://www.mail-tester.com/spf-dkim-check) to verify that they're both correctly in place.
 
 All available options, with their defaults:
 

data/bin/tuktuk

@@ -0,0 +1,61 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/tuktuk'
+require 'optparse'
+
+def missing_keys?(opts)
+  [:body, :from, :subject, :to] - opts.keys
+end
+
+options = {}
+
+OptionParser.new do |opts|
+  opts.banner = "Usage: tuktuk [options]"
+
+  opts.on("-f", "--from your@email.com", String, "From email") do |val|
+    options[:from] = val
+  end
+
+  opts.on("-t", "--to email1,email2", Array, "List of destination emails") do |list|
+    options[:to] = list
+  end
+
+  opts.on("-s","--subject 'This is a test.'", String, "Email subject") do |subject|
+    options[:subject] = subject
+  end
+
+  opts.on("-b", "--body 'Hello there.'", String, "Email body") do |body|
+    options[:body] = body
+  end
+
+  opts.on_tail("-h", "--help", "Show this message") do
+    puts opts
+    exit
+  end
+
+  opts.on_tail("-v", "--version", "Show version") do
+    puts Tuktuk::VERSION
+    exit
+  end
+
+end.parse!
+
+if list = missing_keys?(options) and list.any?
+  puts "Missing option(s): #{list.join(', ')}"
+  puts "Run with -h or --help for all options."
+  exit
+end
+
+Tuktuk.options = {
+  :max_workers => 0,
+  :log_to => STDOUT
+}
+
+response, email = Tuktuk.deliver(options)
+
+if response.is_a?(Tuktuk::Bounce)
+  puts 'Email bounced. Type: ' + response.class.name # => HardBounce or SoftBounce
+  puts response.message
+else
+  puts 'Email delivered!'
+end

data/lib/tuktuk/tuktuk.rb

@@ -5,8 +5,8 @@ require 'work_queue'
 
 module Tuktuk; end
 
-%w(package cache dns bounce).each { |lib| require "tuktuk/#{lib}" }
-require 'tuktuk/version' unless defined?(Tuktuk::VERSION)
+%w(package cache dns bounce).each { |lib| require_relative "./#{lib}" }
+require_relative './version' unless defined?(Tuktuk::VERSION)
 
 DEFAULTS = {
   :helo_domain  => nil,
@@ -38,7 +38,11 @@ module Tuktuk
     def deliver!(mail)
       @logger = Rails.logger if defined?(Rails) and !config[:log_to]
       resp, email = deliver(mail)
-      raise resp if resp.is_a?(Exception)
+      if resp.is_a?(Exception)
+        raise resp
+      else
+        return resp, email
+      end
     end
 
     def deliver_many(messages, opts = {})
@@ -112,6 +116,8 @@ module Tuktuk
       mail.destinations.each do |to|
 
         domain = get_domain(to)
+        raise "Empty domain: #{domain}" if domain.blank?
+
         unless servers = smtp_servers_for_domain(domain)
           return HardBounce.new("588 No MX records for domain #{domain}")
         end

data/lib/tuktuk/version.rb

@@ -1,7 +1,7 @@
 module Tuktuk
   MAJOR = 0
-  MINOR = 5
-  PATCH = 4
+  MINOR = 6
+  PATCH = 0
 
   VERSION = [MAJOR, MINOR, PATCH].join('.')
 end

data/lib/tuktuk.rb

@@ -1 +1 @@
-require 'tuktuk/tuktuk'
+require File.expand_path(File.dirname(__FILE__)) + '/tuktuk/tuktuk'

metadata

@@ -1,105 +1,98 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: tuktuk
-version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 0
-  - 5
-  - 4
-  version: 0.5.4
+version: !ruby/object:Gem::Version
+  version: 0.6.0
 platform: ruby
-authors: 
-- "Tom\xC3\xA1s Pollak"
+authors:
+- Tomás Pollak
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2015-04-08 00:00:00 -07:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2015-08-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: bundler
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 1
-        - 0
-        - 0
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
         version: 1.0.0
   type: :development
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: net-dns
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    requirements: 
-    - - "="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 6
-        - 1
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: net-dns
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
         version: 0.6.1
   type: :runtime
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  name: mail
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
-    requirements: 
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.6.1
+- !ruby/object:Gem::Dependency
+  name: mail
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 2
-        - 3
-        version: "2.3"
+      - !ruby/object:Gem::Version
+        version: '2.3'
   type: :runtime
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
-  name: dkim
   prerelease: false
-  requirement: &id004 !ruby/object:Gem::Requirement 
-    requirements: 
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 0
-        - 2
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: dkim
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
         version: 0.0.2
   type: :runtime
-  version_requirements: *id004
-- !ruby/object:Gem::Dependency 
-  name: work_queue
   prerelease: false
-  requirement: &id005 !ruby/object:Gem::Requirement 
-    requirements: 
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 2
-        - 5
-        - 0
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+- !ruby/object:Gem::Dependency
+  name: work_queue
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
         version: 2.5.0
   type: :runtime
-  version_requirements: *id005
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.5.0
 description: Easy way of sending DKIM-signed emails from Ruby, no dependencies needed.
-email: 
+email:
 - tomas@forkhq.com
-executables: []
-
+executables:
+- tuktuk
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - .gitignore
 - Gemfile
 - README.md
 - Rakefile
+- bin/tuktuk
 - lib/tuktuk.rb
 - lib/tuktuk/bounce.rb
 - lib/tuktuk/cache.rb
@@ -110,37 +103,27 @@ files:
 - lib/tuktuk/version.rb
 - spec/deliver_spec.rb
 - tuktuk.gemspec
-has_rdoc: true
 homepage: https://github.com/tomas/tuktuk
 licenses: []
-
+metadata: {}
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+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: 
-      - 1
-      - 3
-      - 6
+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: 1.3.6
 requirements: []
-
 rubyforge_project: tuktuk
-rubygems_version: 1.3.6
+rubygems_version: 2.0.2
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: SMTP client for Ruby with DKIM support.
 test_files: []
-