gomig_mail_delivery 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,2 @@
+source "http://rubygems.org"
+gemspec

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/example/example.rb

@@ -0,0 +1,19 @@
+require 'gomig_mail_delivery'
+
+Mail.defaults do
+  delivery_method Mail::GomigMailDelivery::Agent, {
+    :domain                => '<your domain>.<tld>',
+    :login_account         => '<admin_or_user_acount>',
+    :password              => '<passwordD>',
+    :to_account            => '<target_account>',
+    :mail_item_property    => 'IS_DRAFT' # optional. other options: IS_INBOX, IS_SENT
+  }
+end
+
+mail = Mail.deliver do
+  from    'sender@domain.tld'
+  date    Time.now
+  to      'recipient name <recipient@domain.tld>'
+  subject 'I\'m your draft'
+  body    'Ready to send when you are.'
+end

data/gomig_mail_delivery.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+
+
+Gem::Specification.new do |s|
+  s.name        = "gomig_mail_delivery"
+  s.version     = '0.0.1'
+  s.authors     = ["Timo van Prooijen, eWaza"]
+  s.email       = ["timo@ewaza.nl"]
+  s.homepage    = "https://github.com/ewaza/gomig-mail-delivery"
+  s.summary     = %q{
+    Extension for the Mail gem that provides 'migrating' to a google Apps account
+  }
+  s.description = %q{
+    Google Apps migration API mail delivery method is an extension for the Mail gem. It provides a delivery method based on the the Google Apps migration API. This API is only available for organization who uses Google Apps for Business, Education or ISPs. (unfortunately not for Gmail or the free edition)
+
+    Whenever your application needs to automatically generate complex emails, which have to be manually approved before they can get sent out; You can make life easy with this gem in combination with google apps. Instead of delivering the email the email will be stored in a, preconfigured users DRAFTS folder. 
+
+    You could also integrate this gem with a CRM system in order to load templates for further manual completion.
+  }
+  
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "rspec"
+  s.add_runtime_dependency "mail"
+  s.add_runtime_dependency "gdata"
+end

data/lib/gomig_mail_delivery.rb

@@ -0,0 +1,46 @@
+require 'gdata'
+require 'mail'
+
+module Mail
+  module GomigMailDelivery
+    class Agent
+      attr_accessor :settings
+
+      def initialize(settings={})      
+        settings[:url] = "https://apps-apis.google.com/a/feeds/migration/2.0/#{settings[:domain]}/#{settings[:to_account]}/mail"
+        
+        @gdata_client = GData::Client::Apps.new
+        @gdata_client.clientlogin "#{settings[:login_account]}@#{settings[:domain]}", settings[:password]  
+  
+        self.settings = settings
+      end
+
+      def deliver!(mail)
+        migrate_mail mail, settings[:url], settings[:mail_item_property]
+      end
+      
+      private
+      def atom_entry(mail_item_property)
+        <<-EOF
+          <entry xmlns='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
+            <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#mailItem'/>
+            <atom:content xmlns:atom='http://www.w3.org/2005/Atom' type='message/rfc822' />
+            #{mail_item_property ? '<apps:mailItemProperty value=\'' + mail_item_property + '\'/>' : ''}
+          </entry>
+        EOF
+      end
+      
+      def migrate_mail( mail, url, mail_item_property )
+        atom_plus_message_body = GData::HTTP::MimeBody.new(atom_entry(mail_item_property), StringIO.new(mail.to_s), 'message/rfc822' )
+        @gdata_client.headers['Slug'] = 'migrated_mail'
+        @gdata_client.headers['MIME-Version'] = '1.0'
+        @gdata_client.headers['Content-Type'] = atom_plus_message_body.content_type
+        @gdata_client.make_request(:post, url, atom_plus_message_body)
+      end   
+      
+    end
+  end
+end
+
+
+

data/readme.md

@@ -0,0 +1,119 @@
+Google Apps migration API mail delivery
+=======================================
+for Mail Gem
+------------
+By Timo van Prooijen
+- v0.0.1
+
+
+This gem is extracted, with permission, from a project I'm doing for one of my clients.
+
+Introduction
+------------
+
+'Google Apps migration API mail delivery method' is an extension for the Mail gem. It provides a delivery method based on the the Google Apps migration API. This API is only available for organization who uses Google Apps for Business, Education or ISPs. (unfortunately not for Gmail or the free edition)
+
+Whenever your application needs to automatically generate *complex* emails, which have to be manually approved before they can get sent out; You can make life easy with this gem in combination with google apps. Instead of delivering the email the email will be stored in a, preconfigured users *DRAFTS* folder. You could also integrate this gem with a CRM system in order to load templates for further manual completion.
+
+Since this gem uses the Google Apps *migration* API; It is also possible to place messages in the users *SENT* or *INBOX* folder. However a proper use-case hasn't crossed my mind yet. (except for practical jokes)
+
+Authentication is either done with the credentials of the domain administrator or the user into who's mailbox you are going to migrate.When authenticating as an user, an administrator has to enable the API for that user first. This can be done in the Google Apps control panel for your domain.
+
+perhaps needless to say: Keep your codebase on a safe place when it contains any plain-text google apps account credentials!
+
+A possible future extension would be the use of *oAuth* for client authentication. (Useful if the user of your application is also the owner of the account you're *migrating* into )
+
+
+Example
+-----
+
+Gemfile:
+
+    source "http://rubygems.org"
+    gem 'gomig_mail_delivery'
+
+
+edit example.rb with your domain credentials:
+    
+```ruby
+require 'gomig_mail_delivery'
+
+Mail.defaults do
+  delivery_method Mail::GomigMailDelivery::Agent, {
+    :domain                => '<your domain>.<tld>',
+    :login_account         => '<admin_or_user_acount>',
+    :password              => '<passwordD>',
+    :to_account            => '<target_account>',
+    :mail_item_property    => 'IS_DRAFT' # optional. other options: IS_INBOX, IS_SENT
+  }
+end
+
+mail = Mail.deliver do
+  from    'sender@domain.tld'
+  date    Time.now
+  to      'recipient name <recipient@domain.tld>'
+  subject 'I\'m your draft'
+  body    'Ready to send when you are.'
+end
+````
+
+Ready to run
+
+`bundle install`
+
+`bundle exec ruby examble.rb`
+
+Its nice to try an email with html and inline attachments as well.
+
+
+Contributing
+------------
+All welcome. Please, Fork, extend, raise issues, Give feedback. (Its my first gem)..
+
+
+Future plans
+------------
+- OAuth integration.  
+
+
+See Also
+--------
+- [link Mail gem](https://github.com/mikel/mail)
+- [link API specs](https://developers.google.com/google-apps/email-migration/)
+
+
+Thanks To
+---------
+- [link mail-single_file_delivery](https://github.com/lsiden/mail-single_file_delivery (Partially used as a template ) (Partially used as a template )
+- [link gdata library](http://code.google.com/p/gdata-ruby-util/ (Dependency used for communication with the Google Apps API)
+
+Support
+-------
+Via GitHub. For inquiries about integration work contact me on timo@ewaza.nl
+
+
+License
+-------
+
+(The MIT License)
+
+Copyright (c) 2009, 2010, 2011, 2012
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/spec/gomig_mail_delivery_spec.rb

@@ -0,0 +1,43 @@
+# encoding: utf-8
+
+require 'gdata'
+require 'mail'
+require 'gomig_mail_delivery'
+
+
+describe Mail::GomigMailDelivery::Agent do
+
+  before(:each) do    
+    @google_mock = double('google_mock')
+    @google_mock.stub(:clientlogin)
+    
+    GData::Client::Apps.stub(:new){@google_mock}
+
+    Mail.defaults do
+      delivery_method :smtp, { :address              => "localhost",
+                               :port                 => 25,
+                               :domain               => 'localhost.localdomain',
+                               :user_name            => nil,
+                               :password             => nil,
+                               :authentication       => nil,
+                               :enable_starttls_auto => true  }
+    end
+  end
+  
+  it "should respond to #settings() and #settings=()" do
+    subject.should respond_to :settings
+    subject.should respond_to :settings=
+  end
+
+  it "should respond to #deliver!()" do
+    subject.should respond_to :deliver!
+  end
+  
+  describe "general usage" do
+    
+    it "should send an email to the google api" do
+      pending
+    end
+    
+  end
+end

metadata

@@ -0,0 +1,116 @@
+--- !ruby/object:Gem::Specification 
+name: gomig_mail_delivery
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Timo van Prooijen, eWaza
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-04-05 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: mail
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: gdata
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+description: "\n    Google Apps migration API mail delivery method is an extension for the Mail gem. It provides a delivery method based on the the Google Apps migration API. This API is only available for organization who uses Google Apps for Business, Education or ISPs. (unfortunately not for Gmail or the free edition)\n\n    Whenever your application needs to automatically generate complex emails, which have to be manually approved before they can get sent out; You can make life easy with this gem in combination with google apps. Instead of delivering the email the email will be stored in a, preconfigured users DRAFTS folder. \n\n    You could also integrate this gem with a CRM system in order to load templates for further manual completion.\n  "
+email: 
+- timo@ewaza.nl
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Rakefile
+- example/example.rb
+- gomig_mail_delivery.gemspec
+- lib/gomig_mail_delivery.rb
+- readme.md
+- spec/gomig_mail_delivery_spec.rb
+has_rdoc: true
+homepage: https://github.com/ewaza/gomig-mail-delivery
+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.5.2
+signing_key: 
+specification_version: 3
+summary: Extension for the Mail gem that provides 'migrating' to a google Apps account
+test_files: 
+- spec/gomig_mail_delivery_spec.rb