macmailer 0.0.1

data/bin/macmailer

@@ -0,0 +1,43 @@
+#!/usr/bin/env ruby
+require "trollop"
+require "macmailer"
+
+opts = Trollop::options do
+	recipient_note = "either as just an address, or an address followed by a name. Can be declared multple times."
+	opt :subject, "Subject line.", :short => "-s", :type => :string
+	opt :body, "Body.", :short => "-b", :type => :string
+	opt :to, "Specify a To: recepient, #{recipient_note}", :multi => true, :type => :strings
+	opt :cc, "Specify a CC: recepient, #{recipient_note}", :multi => true, :type => :strings
+	opt :bcc, "Specify a BCC: recepient, #{recipient_note}", :multi => true, :type => :strings
+	opt :send, "Automatically send the email. If not specified, script only creates the email."
+	opt :show, "Bring Mail.app to the front of your screen. Otherwise, remains in background."
+	opt :thanks, "Write Jeremy a note. (Note: Does *not* auto-send message. Overrides all other options.)"
+end
+
+# Send thanks and exit if "--thanks" flag is provided
+if opts[:thanks]
+	MacMailer::Message.new({
+		:subject => "re. MacMailer",
+		:body => "Thanks! It's freaking awesome.",
+		:recipients => [
+			:address => "jsvine@gmail.com",
+			:name => "Jeremy Singer-Vine"
+		]
+	}).create.show
+	exit
+end
+	
+# Otherwise, create and/or send the message
+recipient_types = [ :to, :cc, :bcc ]
+def opt_to_recipients (multi, type)
+	multi.map {|m| { :address => m.shift, :name => m.join(" "), :type => type } }
+end
+
+message = MacMailer::Message.new({
+	:subject => opts[:subject],
+	:body => opts[:body],
+	:recipients => recipient_types.map do |sym|
+		opt_to_recipients(opts[sym], sym)
+	end.flatten(1)
+}).method(opts[:send] ? :send : :create).call
+message.show if opts[:show]

data/lib/macmailer.rb

@@ -0,0 +1,67 @@
+#!/usr/bin/env ruby
+# The MacMailer module lets you create, and send, emails 
+# through OSX's Mail.app program. At its core, MacMailer 
+# just writes and executes a temporary AppleScript script.
+module MacMailer
+	# Message is the main MacMailer class.
+	class Message
+		# Creates a MacMailer::Message instance. `props` can be left blank
+		# for a blank message, but you'll probably want to pass along some
+		# details. Valid keys for `props` include:
+		#
+		# 	:subject => String
+		# 	:body => String
+		# 	:recipients => Array (of hashes)
+		#
+		# Each hash in :recipients supports the following keys:
+		#
+		# 	:address => String
+		# 	:name => String
+		# 	:type => :to, :cc, or :bcc
+		def initialize (props={})
+			@props = props
+		end
+
+		# Creates an email, based on `@props`, using AppleScript. 
+		# Does not send the email unless the optional `send` parameter 
+		# is set to `true`.
+		def create (send=false)
+			script = <<-SCRIPT
+			tell application "Mail"
+				set msg to make new outgoing message with properties {subject:#{(@props[:subject] || "").dump}, content:#{(@props[:body] || "").dump}, visible:true}
+				tell msg
+					#{(@props[:recipients] || []).map {|x| _make_recipient(x[:address], x[:name], x[:type]) }.join("\n") }
+					#{send ? "send" : ""}
+				end tell
+			end tell
+			SCRIPT
+			@shell_response = `/usr/bin/osascript > /dev/null <<MACMAILERSCRIPT
+				#{script}
+			\nMACMAILERSCRIPT`
+			self
+		end
+
+		# Convenience method to create *and* send the message.
+		def send
+			self.create(send=true)
+		end
+
+		# Brings Mail.app to the front, using AppleScript.
+		def show
+			`/usr/bin/osascript > /dev/null <<MACMAILERSCRIPT
+				tell application "Mail"
+					activate
+				end tell
+			\nMACMAILERSCRIPT`
+			self
+		end
+
+		# Helper method to write the AppleScript command to add
+		# a new recipient to a message.
+		private
+		def _make_recipient (address, name, type)
+			"make new #{(type || :to).to_s} recipient with properties " + 
+			"{name:#{(name || address || "").dump}, address:#{(address || "").dump}}"
+		end
+	end
+end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: macmailer
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Jeremy Singer-Vine
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: trollop
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby binding and command-line interface for Apple's Mail.app
+email: jsvine@gmail.com
+executables:
+- macmailer
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/macmailer.rb
+- bin/macmailer
+homepage: https://github.com/jsvine/macmailer
+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.8.24
+signing_key: 
+specification_version: 3
+summary: Ruby x Mail.app
+test_files: []