mail_room 0.0.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+log

data/.ruby-version

@@ -0,0 +1 @@
+1.9.3-p362

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in mail_room.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Tony Pitale
+
+MIT License
+
+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/README.md

@@ -0,0 +1,51 @@
+# mail_room #
+
+mail_room is a configuration based process that will idle on IMAP connections and POST to a delivery URL whenever a new message is received on the configured mailbox and folder.
+
+## Installation ##
+
+Add this line to your application's Gemfile:
+
+    gem 'mail_room'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install mail_room
+
+## Usage ##
+
+    bin/mail_room -f /path/to/config.yml -d
+
+## Configuration ##
+
+    ---
+      :mailboxes:
+        -
+          :email: "user1@gmail.com"
+          :password: "password"
+          :name: "inbox"
+          :delivery_url: "http://localhost:3000/inbox"
+          :delivery_token: "abcdefg"
+        -
+          :email: "user2@gmail.com"
+          :password: "password"
+          :name: "inbox"
+          :delivery_url: "http://localhost:3000/inbox"
+          :delivery_token: "abcdefg"
+
+## Dependencies ##
+
+* celluloid
+
+## Contributing ##
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+6. If accepted, ask for commit rights

data/Rakefile

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

data/bin/mail_room

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby -Ilib
+
+require 'mail_room'
+
+MailRoom::CLI.new(ARGV).run

data/lib/mail_room/cli.rb

@@ -0,0 +1,130 @@
+module MailRoom
+  class CLI
+    attr_accessor :configuration
+
+    def initialize(args)
+      options = {}
+
+      OptionParser.new do |parser|
+        parser.banner = [
+          "Usage: #{@name} [-c config_file]\n",
+          "       #{@name} --help\n"
+        ].compact.join
+
+        parser.on('-c', '--config FILE') do |path|
+          options[:config_path] = path
+        end
+
+        parser.on("-d", "--daemon", "Daemonize mode") do |v|
+          options[:daemonize] = v
+        end
+
+        parser.on("-l", "--log FILE") do |path|
+          options[:log_path] = path
+        end
+
+        parser.on("-p", "--pid FILE") do |path|
+          options[:pid_path] = path
+        end
+
+        parser.on_tail("-?", "--help", "Display this usage information.") do
+          puts "#{parser}\n"
+          exit
+        end
+      end.parse!(args)
+
+      self.configuration = Configuration.new(options)
+    end
+
+    def run
+      if configuration.daemonize?
+        daemonize
+      else
+        start
+      end
+    end
+
+    def running?
+      @running
+    end
+
+    def daemonize
+      exit if fork
+      Process.setsid
+      exit if fork
+      store_pid(Process.pid)
+      File.umask 0000
+      redirect_output!
+
+      start
+
+      clean_pid
+    end
+
+    def start
+      @running = true
+
+      @coordinator ||= Coordinator.new(configuration.mailboxes)
+      @coordinator.run
+
+      Signal.trap(:INT) do
+        stop
+      end
+
+      Signal.trap(:TERM) do
+        exit
+      end
+
+      while(running?) do; sleep 1; end
+    end
+
+    def stop
+      return unless @coordinator
+
+      @coordinator.quit
+
+      @running = false
+    end
+
+    def store_pid(pid)
+      pid_path = configuration.pid_path
+
+      puts pid_path
+
+      FileUtils.mkdir_p(File.dirname(pid_path))
+      File.open(pid_path, 'w'){|f| f.write("#{pid}\n")}
+    end
+
+    def clean_pid
+      pid_path = configuration.pid_path
+
+      begin
+        FileUtils.rm pid_path if File.exists?(pid_path)
+      rescue => e
+      end
+    end
+
+
+    def redirect_output!
+      if log_path = configuration.log_path
+        # if the log directory doesn't exist, create it
+        FileUtils.mkdir_p File.dirname(log_path), :mode => 0755
+        # touch the log file to create it
+        FileUtils.touch log_path
+        # Set permissions on the log file
+        File.chmod(0644, log_path)
+        # Reopen $stdout (NOT +STDOUT+) to start writing to the log file
+        $stdout.reopen(log_path, 'a')
+        # Redirect $stderr to $stdout
+        $stderr.reopen $stdout
+        $stdout.sync = true
+      else # redirect to /dev/null
+        # We're not bothering to sync if we're dumping to /dev/null
+        # because /dev/null doesn't care about buffered output
+        $stdin.reopen '/dev/null'
+        $stdout.reopen '/dev/null', 'a'
+        $stderr.reopen $stdout
+      end
+    end
+  end
+end

data/lib/mail_room/configuration.rb

@@ -0,0 +1,24 @@
+module MailRoom
+  class Configuration
+    attr_accessor :mailboxes, :daemonize, :log_path, :pid_path
+
+    def initialize(options={})
+      config_file = YAML.load_file(options[:config_path]) if options.has_key?(:config_path)
+
+      self.mailboxes = []
+      load_mailboxes(config_file[:mailboxes])
+
+      self.daemonize = options.fetch(:daemonize, false)
+      self.log_path = options.fetch(:log_path, nil)
+      self.pid_path = options.fetch(:pid_path, "/var/run/mail_room.pid")
+    end
+
+    def load_mailboxes(mailboxes_config)
+      mailboxes_config.each do |attributes|
+        self.mailboxes << Mailbox.new(attributes)
+      end
+    end
+
+    alias :daemonize? :daemonize
+  end
+end

data/lib/mail_room/coordinator.rb

@@ -0,0 +1,19 @@
+module MailRoom
+  class Coordinator
+    attr_accessor :handlers
+
+    def initialize(mailboxes)
+      self.handlers = []
+
+      mailboxes.each {|mb| self.handlers << MessageHandler.new(mb)}
+    end
+
+    def run
+      handlers.each(&:run!)
+    end
+
+    def quit
+      handlers.each(&:quit!)
+    end
+  end
+end

data/lib/mail_room/mailbox.rb

@@ -0,0 +1,9 @@
+module MailRoom
+  Mailbox = Struct.new(:email, :password, :name, :delivery_url, :delivery_token)
+
+  class Mailbox
+    def initialize(attributes={})
+      super(*attributes.values_at(*members))
+    end
+  end
+end

data/lib/mail_room/message_handler.rb

@@ -0,0 +1,125 @@
+module MailRoom
+  class MessageHandler
+    include Celluloid
+
+    def initialize(mailbox)
+      @mailbox = mailbox
+      @imap = Net::IMAP.new('imap.gmail.com', :port => 993, :ssl => true)
+
+      @running = false
+      @logged_in = false
+      @idling = false
+    end
+
+    def running?
+      @running
+    end
+
+    def logged_in?
+      @logged_in
+    end
+
+    def idling?
+      @idling
+    end
+
+    def run
+      setup
+
+      @running = true
+
+      @idling_thread = Thread.start do
+        while(running?) do
+          idle
+          fetch_new_messages
+        end
+      end
+    end
+
+    def setup
+      log_in
+      examine_mailbox
+    end
+
+    def log_in
+      @imap.login(@mailbox.email, @mailbox.password)
+      # @imap.authenticate('XOAUTH2', @mailbox["email"], @mailbox["token"])
+      @logged_in = true
+    end
+
+    def examine_mailbox
+      return unless logged_in?
+
+      @imap.select(@mailbox.name)
+    end
+
+    def fetch_new_messages
+      return if idling? || !running?
+
+      new_messages.each do |msg|
+        puts msg.attr['RFC822']
+        # post_message(msg)
+      end
+    end
+
+    def new_messages
+      messages_for_ids(new_message_ids)
+    end
+
+    # def label_message_with(id, lbl)
+    #   in_current_fiber do |f|
+    #     @imap.store(id, "+X-GM-LABELS", [lbl]).errback {f.resume}.callback {f.resume}
+    #   end
+    # end
+
+    def new_message_ids
+      @imap.search('UNSEEN')
+    end
+
+    def messages_for_ids(ids)
+      return [] if ids.empty?
+
+      @imap.fetch(ids, "RFC822")
+    end
+
+    def post_message(msg)
+      # connection = Faraday.new
+      # connection.token_auth @mailbox["delivery_token"]
+
+      # connection.post do |request|
+      #   request.url @mailbox["delivery_url"]
+      #   request.options[:timeout] = 3
+      #   request.headers['Content-Type'] = 'application/json'
+      #   request.body = msg
+      # end
+    end
+
+    def idle
+      return unless logged_in?
+
+      @idling = true
+
+      @imap.idle do |response|
+        if response.respond_to?(:name) && response.name == 'EXISTS'
+          @imap.idle_done
+        end
+      end
+
+      @idling = false
+    end
+
+    def stop_idling
+      return unless idling?
+
+      @imap.idle_done
+      @idling_thread.join
+      @idling = false
+    end
+
+    def quit
+      @running = false
+      puts "Quitting"
+      stop_idling
+    end
+  end
+end

data/lib/mail_room/version.rb

@@ -0,0 +1,3 @@
+module MailRoom
+  VERSION = "0.0.1"
+end

data/lib/mail_room.rb

@@ -0,0 +1,15 @@
+require 'celluloid'
+require 'net/imap'
+require 'fileutils'
+require 'optparse'
+require 'yaml'
+
+module MailRoom
+end
+
+require "mail_room/version"
+require "mail_room/configuration"
+require "mail_room/mailbox"
+require "mail_room/message_handler"
+require "mail_room/coordinator"
+require "mail_room/cli"

data/mail_room.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'mail_room/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "mail_room"
+  gem.version       = MailRoom::VERSION
+  gem.authors       = ["Tony Pitale"]
+  gem.email         = ["tpitale@gmail.com"]
+  gem.description   = %q{mail_room will proxy email (gmail) from IMAP to a callback URL}
+  gem.summary       = %q{mail_room will proxy email (gmail) from IMAP to a callback URL}
+  gem.homepage      = "http://github.com/tpitale/mail_room"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency 'celluloid'
+end

metadata

@@ -0,0 +1,77 @@
+--- !ruby/object:Gem::Specification
+name: mail_room
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Tony Pitale
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-01-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: celluloid
+  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: mail_room will proxy email (gmail) from IMAP to a callback URL
+email:
+- tpitale@gmail.com
+executables:
+- mail_room
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .ruby-version
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/mail_room
+- lib/mail_room.rb
+- lib/mail_room/cli.rb
+- lib/mail_room/configuration.rb
+- lib/mail_room/coordinator.rb
+- lib/mail_room/mailbox.rb
+- lib/mail_room/message_handler.rb
+- lib/mail_room/version.rb
+- mail_room.gemspec
+homepage: http://github.com/tpitale/mail_room
+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.23
+signing_key: 
+specification_version: 3
+summary: mail_room will proxy email (gmail) from IMAP to a callback URL
+test_files: []