gmail 0.5.0 → 0.6.0

data/Rakefile

@@ -1,46 +1,46 @@
-#!/usr/bin/env rake
-
-begin
-  require 'bundler/setup'
-rescue LoadError
-  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
-end
-
-begin
-  require 'rdoc/task'
-rescue LoadError
-  require 'rdoc/rdoc'
-  require 'rake/rdoctask'
-  RDoc::Task = Rake::RDocTask
-end
-
-RDoc::Task.new(:rdoc) do |rdoc|
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title = "Gmail for Ruby #{Gmail::VERSION}"
-  rdoc.rdoc_files.include('README*')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-end
-
-Bundler::GemHelper.install_tasks
-
-begin
-  require 'rspec/core/rake_task'
-  RSpec::Core::RakeTask.new(:spec)
-rescue LoadError
-  task :spec do
-    abort 'Run `gem install rspec` to install RSpec'
-  end
-end
-
-task :default => :spec
-
-$LOAD_PATH.unshift(File.dirname(__FILE__))
-require 'spec/support/obfuscation'
-desc 'Obfuscates account.yml file.'
-task :obfuscate do
-  Spec::Obfuscation.encrypt_file(File.join(File.dirname(__FILE__), 'spec', 'account.yml'))
-end
-
-task :deobfuscate do
-  puts Spec::Obfuscation.decrypt_file(File.join(File.dirname(__FILE__), 'spec', 'account.yml.obfus'))
-end
+#!/usr/bin/env rake
+
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+begin
+  require 'rdoc/task'
+rescue LoadError
+  require 'rdoc/rdoc'
+  require 'rake/rdoctask'
+  RDoc::Task = Rake::RDocTask
+end
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "Gmail for Ruby #{Gmail::VERSION}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+Bundler::GemHelper.install_tasks
+
+begin
+  require 'rspec/core/rake_task'
+  RSpec::Core::RakeTask.new(:spec)
+rescue LoadError
+  task :spec do
+    abort 'Run `gem install rspec` to install RSpec'
+  end
+end
+
+task :default => :spec
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'spec/support/obfuscation'
+desc 'Obfuscates account.yml file.'
+task :obfuscate do
+  Spec::Obfuscation.encrypt_file(File.join(File.dirname(__FILE__), 'spec', 'account.yml'))
+end
+
+task :deobfuscate do
+  puts Spec::Obfuscation.decrypt_file(File.join(File.dirname(__FILE__), 'spec', 'account.yml.obfus'))
+end

data/gmail.gemspec

@@ -1,34 +1,34 @@
-# -*- encoding: utf-8 -*-
-
-$:.push File.expand_path('../lib', __FILE__)
-require 'gmail/version'
-
-Gem::Specification.new do |s|
-  s.name = "gmail"
-  s.summary = "A Rubyesque interface to Gmail, with all the tools you will need."
-  s.description = "A Rubyesque interface to Gmail, with all the tools you will need.
-  Search, read and send multipart emails; archive, mark as read/unread,
-  delete emails; and manage labels.
-  "
-  s.version = Gmail::VERSION
-  s.platform = Gem::Platform::RUBY
-  s.authors = ["Chris Kowalik"]
-  s.email = ["chris@nu7hat.ch"]
-  s.homepage = "http://github.com/gmailgem/gmail"
-  s.licenses = ["MIT"]
-
-  # runtime dependencies
-  s.add_dependency "mail", ">= 2.2.1"
-  s.add_dependency "gmail_xoauth", ">= 0.3.0"
-
-  # development dependencies
-  s.add_development_dependency "rake"
-  s.add_development_dependency "rspec", ">= 3.1"
-  s.add_development_dependency "rubocop"
-  s.add_development_dependency "gem-release"
-
-  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"]
-end
+# -*- encoding: utf-8 -*-
+
+$:.push File.expand_path('../lib', __FILE__)
+require 'gmail/version'
+
+Gem::Specification.new do |s|
+  s.name = "gmail"
+  s.summary = "A Rubyesque interface to Gmail, with all the tools you will need."
+  s.description = "A Rubyesque interface to Gmail, with all the tools you will need.
+  Search, read and send multipart emails; archive, mark as read/unread,
+  delete emails; and manage labels.
+  "
+  s.version = Gmail::VERSION
+  s.platform = Gem::Platform::RUBY
+  s.authors = ["Chris Kowalik"]
+  s.email = ["chris@nu7hat.ch"]
+  s.homepage = "http://github.com/gmailgem/gmail"
+  s.licenses = ["MIT"]
+
+  # runtime dependencies
+  s.add_dependency "mail", ">= 2.2.1"
+  s.add_dependency "gmail_xoauth", ">= 0.3.0"
+
+  # development dependencies
+  s.add_development_dependency "rake"
+  s.add_development_dependency "rspec", ">= 3.1"
+  s.add_development_dependency "rubocop"
+  s.add_development_dependency "gem-release"
+
+  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"]
+end

data/lib/gmail.rb

@@ -1,78 +1,78 @@
-require 'net/imap'
-require 'net/smtp'
-require 'mail'
-require 'date'
-require 'time'
-
-if RUBY_VERSION < "1.8.7"
-  require "smtp_tls"
-end
-
-class Object
-  def to_imap_date
-    date = respond_to?(:utc) ? utc.to_s : to_s
-    Date.parse(date).strftime("%d-%B-%Y")
-  end
-end
-
-module Gmail
-  autoload :Version, "gmail/version"
-  autoload :Client,  "gmail/client"
-  autoload :Labels,  "gmail/labels"
-  autoload :Mailbox, "gmail/mailbox"
-  autoload :Message, "gmail/message"
-
-  class << self
-    # Creates new Gmail connection using given authorization options.
-    #
-    # ==== Examples
-    #
-    #   Gmail.new(:plain, "foo@gmail.com", "password")
-    #   Gmail.new(:xoauth, "foo@gmail.com",
-    #     :consumer_key => "",
-    #     :consumer_secret => "",
-    #     :token => "",
-    #     :secret => "")
-    #
-    # To use plain authentication mehod you can also call:
-    #
-    #   Gmail.new("foo@gmail.com", "password")
-    #
-    # You can also use block-style call:
-    #
-    #   Gmail.new("foo@gmail.com", "password") do |client|
-    #     # ...
-    #   end
-    #
-
-    def new(*args, &block)
-      args.unshift(:plain) unless args.first.is_a?(Symbol)
-      client = Gmail::Client.new(*args)
-      client.connect
-      client.login
-
-      if block_given?
-        yield client
-        client.logout
-      end
-
-      client
-    end
-    alias_method :connect, :new
-
-    def new!(*args, &block)
-      args.unshift(:plain) unless args.first.is_a?(Symbol)
-      client = Gmail::Client.new(*args)
-      client.connect!
-      client.login!
-
-      if block_given?
-        yield client
-        client.logout
-      end
-
-      client
-    end
-    alias_method :connect!, :new!
-  end # << self
-end # Gmail
+require 'net/imap'
+require 'net/smtp'
+require 'mail'
+require 'date'
+require 'time'
+
+if RUBY_VERSION < "1.8.7"
+  require "smtp_tls"
+end
+
+class Object
+  def to_imap_date
+    date = respond_to?(:utc) ? utc.to_s : to_s
+    Date.parse(date).strftime("%d-%B-%Y")
+  end
+end
+
+module Gmail
+  autoload :Version, "gmail/version"
+  autoload :Client,  "gmail/client"
+  autoload :Labels,  "gmail/labels"
+  autoload :Mailbox, "gmail/mailbox"
+  autoload :Message, "gmail/message"
+
+  class << self
+    # Creates new Gmail connection using given authorization options.
+    #
+    # ==== Examples
+    #
+    #   Gmail.new(:plain, "foo@gmail.com", "password")
+    #   Gmail.new(:xoauth, "foo@gmail.com",
+    #     :consumer_key => "",
+    #     :consumer_secret => "",
+    #     :token => "",
+    #     :secret => "")
+    #
+    # To use plain authentication mehod you can also call:
+    #
+    #   Gmail.new("foo@gmail.com", "password")
+    #
+    # You can also use block-style call:
+    #
+    #   Gmail.new("foo@gmail.com", "password") do |client|
+    #     # ...
+    #   end
+    #
+
+    def new(*args, &block)
+      args.unshift(:plain) unless args.first.is_a?(Symbol)
+      client = Gmail::Client.new(*args)
+      client.connect
+      client.login
+
+      if block_given?
+        yield client
+        client.logout
+      end
+
+      client
+    end
+    alias_method :connect, :new
+
+    def new!(*args, &block)
+      args.unshift(:plain) unless args.first.is_a?(Symbol)
+      client = Gmail::Client.new(*args)
+      client.connect!
+      client.login!
+
+      if block_given?
+        yield client
+        client.logout
+      end
+
+      client
+    end
+    alias_method :connect!, :new!
+  end # << self
+end # Gmail

data/lib/gmail/client.rb

@@ -1,34 +1,34 @@
-module Gmail
-  module Client
-    # Raised when connection with Gmail IMAP service couldn't be established.
-    class ConnectionError < SocketError; end
-    # Raised when given username or password are invalid.
-    class AuthorizationError < Net::IMAP::NoResponseError; end
-    # Raised when delivered email is invalid.
-    class DeliveryError < ArgumentError; end
-    # Raised when given client is not registered
-    class UnknownClient < ArgumentError; end
-
-    def self.clients
-      @clients ||= {}
-    end
-
-    def self.register(name, klass)
-      clients[name] = klass
-    end
-
-    def self.new(name, *args)
-      if client = clients[name]
-        client.new(*args)
-      else
-        raise UnknownClient, "No such client: #{name}"
-      end
-    end
-
-    require 'gmail/imap_extensions'
-    require 'gmail/client/base'
-    require 'gmail/client/plain'
-    require 'gmail/client/xoauth'
-    require 'gmail/client/xoauth2'
-  end # Client
-end # Gmail
+module Gmail
+  module Client
+    # Raised when connection with Gmail IMAP service couldn't be established.
+    class ConnectionError < SocketError; end
+    # Raised when given username or password are invalid.
+    class AuthorizationError < Net::IMAP::NoResponseError; end
+    # Raised when delivered email is invalid.
+    class DeliveryError < ArgumentError; end
+    # Raised when given client is not registered
+    class UnknownClient < ArgumentError; end
+
+    def self.clients
+      @clients ||= {}
+    end
+
+    def self.register(name, klass)
+      clients[name] = klass
+    end
+
+    def self.new(name, *args)
+      if client = clients[name]
+        client.new(*args)
+      else
+        raise UnknownClient, "No such client: #{name}"
+      end
+    end
+
+    require 'gmail/imap_extensions'
+    require 'gmail/client/base'
+    require 'gmail/client/plain'
+    require 'gmail/client/xoauth'
+    require 'gmail/client/xoauth2'
+  end # Client
+end # Gmail

data/lib/gmail/client/base.rb

@@ -1,229 +1,229 @@
-require 'thread'
-
-module Gmail
-  module Client
-    class Base
-      # Gmail IMAP defaults
-      GMAIL_IMAP_HOST = 'imap.gmail.com'
-      GMAIL_IMAP_PORT = 993
-
-      # Gmail SMTP defaults
-      GMAIL_SMTP_HOST = "smtp.gmail.com"
-      GMAIL_SMTP_PORT = 587
-
-      attr_reader :username
-      attr_reader :options
-
-      def initialize(username, options = {})
-        defaults       = {}
-        @username      = fill_username(username)
-        @options       = defaults.merge(options)
-        @mailbox_mutex = Mutex.new
-      end
-
-      # Connect to gmail service.
-      def connect(raise_errors = false)
-        @imap = Net::IMAP.new(GMAIL_IMAP_HOST, GMAIL_IMAP_PORT, true, nil, false)
-        Gmail::ImapExtensions.patch_net_imap_response_parser
-        @imap
-      rescue SocketError
-        raise_errors and raise ConnectionError, "Couldn't establish connection with Gmail IMAP service"
-      end
-
-      # This version of connect will raise error on failure...
-      def connect!
-        connect(true)
-      end
-
-      # Return current connection. Log in automaticaly to specified account if
-      # it is necessary.
-      def connection
-        login and at_exit { logout } unless logged_in?
-        @imap
-      end
-      alias :conn :connection
-
-      # Login to specified account.
-      def login(*args)
-        raise NotImplementedError, "The `#{self.class.name}#login` method is not implemented."
-      end
-      alias :sign_in :login
-
-      # This version of login will raise error on failure...
-      def login!
-        login(true)
-      end
-      alias :sign_in! :login!
-
-      # Returns +true+ when you are logged in to specified account.
-      def logged_in?
-        !!@logged_in
-      end
-      alias :signed_in? :logged_in?
-
-      # Logout from Gmail service.
-      def logout
-        @imap && logged_in? and @imap.logout
-      ensure
-        @logged_in = false
-      end
-      alias :sign_out :logout
-
-      # Disconnect from Gmail service.
-      def disconnect
-        @imap && @imap.disconnect
-      end
-
-      # Return labels object, which helps you with managing your Gmail labels.
-      # See <tt>Gmail::Labels</tt> for details.
-      def labels
-        @labels ||= Labels.new(conn)
-      end
-
-      # Compose new e-mail.
-      #
-      # ==== Examples
-      #
-      #   mail = gmail.compose
-      #   mail.from "test@gmail.org"
-      #   mail.to "friend@gmail.com"
-      #
-      # ... or block style:
-      #
-      #   mail = gmail.compose do
-      #     from "test@gmail.org"
-      #     to "friend@gmail.com"
-      #     subject "Hello!"
-      #     body "Hello my friend! long time..."
-      #   end
-      #
-      # Now you can deliver your mail:
-      #
-      #   gmail.deliver(mail)
-      def compose(mail = nil, &block)
-        if block_given?
-          mail = Mail.new(&block)
-        elsif !mail
-          mail = Mail.new
-        end
-
-        mail.delivery_method(*smtp_settings)
-        mail.from = username unless mail.from
-        mail
-      end
-      alias :message :compose
-
-      # Compose (optionaly) and send given email.
-      #
-      # ==== Examples
-      #
-      #   gmail.deliver do
-      #     to "friend@gmail.com"
-      #     subject "Hello friend!"
-      #     body "Hi! How are you?"
-      #   end
-      #
-      # ... or with already created message:
-      #
-      #   mail = Mail.new { ... }
-      #   gmail.deliver(mail)
-      #
-      #   mail = gmail.compose { ... }
-      #   gmail.deliver(mail)
-      def deliver(mail = nil, raise_errors = false, &block)
-        mail = compose(mail, &block) if block_given?
-        mail.deliver!
-      rescue Object => ex
-        raise_errors and raise DeliveryError, "Couldn't deliver email: #{ex.to_s}"
-      end
-
-      # This version of deliver will raise error on failure...
-      def deliver!(mail = nil, &block)
-        deliver(mail, true, &block)
-      end
-
-      # Do something with given mailbox or within it context.
-      #
-      # ==== Examples
-      #
-      #   mailbox = gmail.mailbox("INBOX")
-      #   mailbox.emails(:all)
-      #   mailbox.count(:unread, :before => Time.now-(20*24*3600))
-      #
-      # ... or block style:
-      #
-      #   gmail.label("Work") do |mailbox|
-      #     mailbox.emails(:unread)
-      #     mailbox.count(:all)
-      #     ...
-      #   end
-      def mailbox(name, &block)
-        @mailbox_mutex.synchronize do
-          name = labels.localize(name)
-          mailbox = (mailboxes[name] ||= Mailbox.new(self, name))
-          switch_to_mailbox(mailbox) if @current_mailbox != mailbox
-
-          if block_given?
-            mailbox_stack << @current_mailbox
-            result = block.arity == 1 ? block.call(mailbox) : block.call
-            mailbox_stack.pop
-            switch_to_mailbox(mailbox_stack.last)
-            return result
-          end
-
-          return mailbox
-        end
-      end
-      alias :in_mailbox :mailbox
-      alias :in_label :mailbox
-      alias :label :mailbox
-
-      # Alias for <tt>mailbox("INBOX")</tt>. See <tt>Gmail::Client#mailbox</tt>
-      # for details.
-      def inbox
-        mailbox("INBOX")
-      end
-
-      def mailboxes
-        @mailboxes ||= {}
-      end
-
-      def inspect
-        "#<Gmail::Client#{'0x%04x' % (object_id << 1)} (#{username}) #{'dis' if !logged_in?}connected>"
-      end
-
-      def fill_username(username)
-        username =~ /@/ ? username : "#{username}@gmail.com"
-      end
-
-      def mail_domain
-        username.split('@').last
-      end
-
-      private
-
-      def switch_to_mailbox(mailbox)
-        if mailbox
-          conn.select(mailbox.encoded_name)
-        end
-        @current_mailbox = mailbox
-      end
-
-      def mailbox_stack
-        @mailbox_stack ||= []
-      end
-
-      def smtp_settings
-        [:smtp, {
-          :address => GMAIL_SMTP_HOST,
-          :port => GMAIL_SMTP_PORT,
-          :domain => mail_domain,
-          :user_name => username,
-          :password => password,
-          :authentication => 'plain',
-          :enable_starttls_auto => true
-        }]
-      end
-    end # Base
-  end # Client
-end # Gmail
+require 'thread'
+
+module Gmail
+  module Client
+    class Base
+      # Gmail IMAP defaults
+      GMAIL_IMAP_HOST = 'imap.gmail.com'
+      GMAIL_IMAP_PORT = 993
+
+      # Gmail SMTP defaults
+      GMAIL_SMTP_HOST = "smtp.gmail.com"
+      GMAIL_SMTP_PORT = 587
+
+      attr_reader :username
+      attr_reader :options
+
+      def initialize(username, options = {})
+        defaults       = {}
+        @username      = fill_username(username)
+        @options       = defaults.merge(options)
+        @mailbox_mutex = Mutex.new
+      end
+
+      # Connect to gmail service.
+      def connect(raise_errors = false)
+        @imap = Net::IMAP.new(GMAIL_IMAP_HOST, GMAIL_IMAP_PORT, true, nil, false)
+        Gmail::ImapExtensions.patch_net_imap_response_parser
+        @imap
+      rescue SocketError
+        raise_errors and raise ConnectionError, "Couldn't establish connection with Gmail IMAP service"
+      end
+
+      # This version of connect will raise error on failure...
+      def connect!
+        connect(true)
+      end
+
+      # Return current connection. Log in automaticaly to specified account if
+      # it is necessary.
+      def connection
+        login and at_exit { logout } unless logged_in?
+        @imap
+      end
+      alias :conn :connection
+
+      # Login to specified account.
+      def login(*args)
+        raise NotImplementedError, "The `#{self.class.name}#login` method is not implemented."
+      end
+      alias :sign_in :login
+
+      # This version of login will raise error on failure...
+      def login!
+        login(true)
+      end
+      alias :sign_in! :login!
+
+      # Returns +true+ when you are logged in to specified account.
+      def logged_in?
+        !!@logged_in
+      end
+      alias :signed_in? :logged_in?
+
+      # Logout from Gmail service.
+      def logout
+        @imap && logged_in? and @imap.logout
+      ensure
+        @logged_in = false
+      end
+      alias :sign_out :logout
+
+      # Disconnect from Gmail service.
+      def disconnect
+        @imap && @imap.disconnect
+      end
+
+      # Return labels object, which helps you with managing your Gmail labels.
+      # See <tt>Gmail::Labels</tt> for details.
+      def labels
+        @labels ||= Labels.new(conn)
+      end
+
+      # Compose new e-mail.
+      #
+      # ==== Examples
+      #
+      #   mail = gmail.compose
+      #   mail.from "test@gmail.org"
+      #   mail.to "friend@gmail.com"
+      #
+      # ... or block style:
+      #
+      #   mail = gmail.compose do
+      #     from "test@gmail.org"
+      #     to "friend@gmail.com"
+      #     subject "Hello!"
+      #     body "Hello my friend! long time..."
+      #   end
+      #
+      # Now you can deliver your mail:
+      #
+      #   gmail.deliver(mail)
+      def compose(mail = nil, &block)
+        if block_given?
+          mail = Mail.new(&block)
+        elsif !mail
+          mail = Mail.new
+        end
+
+        mail.delivery_method(*smtp_settings)
+        mail.from = username unless mail.from
+        mail
+      end
+      alias :message :compose
+
+      # Compose (optionaly) and send given email.
+      #
+      # ==== Examples
+      #
+      #   gmail.deliver do
+      #     to "friend@gmail.com"
+      #     subject "Hello friend!"
+      #     body "Hi! How are you?"
+      #   end
+      #
+      # ... or with already created message:
+      #
+      #   mail = Mail.new { ... }
+      #   gmail.deliver(mail)
+      #
+      #   mail = gmail.compose { ... }
+      #   gmail.deliver(mail)
+      def deliver(mail = nil, raise_errors = false, &block)
+        mail = compose(mail, &block)
+        mail.deliver!
+      rescue Object => ex
+        raise_errors and raise DeliveryError, "Couldn't deliver email: #{ex.to_s}"
+      end
+
+      # This version of deliver will raise error on failure...
+      def deliver!(mail = nil, &block)
+        deliver(mail, true, &block)
+      end
+
+      # Do something with given mailbox or within it context.
+      #
+      # ==== Examples
+      #
+      #   mailbox = gmail.mailbox("INBOX")
+      #   mailbox.emails(:all)
+      #   mailbox.count(:unread, :before => Time.now-(20*24*3600))
+      #
+      # ... or block style:
+      #
+      #   gmail.label("Work") do |mailbox|
+      #     mailbox.emails(:unread)
+      #     mailbox.count(:all)
+      #     ...
+      #   end
+      def mailbox(name, &block)
+        @mailbox_mutex.synchronize do
+          name = labels.localize(name)
+          mailbox = (mailboxes[name] ||= Mailbox.new(self, name))
+          switch_to_mailbox(mailbox) if @current_mailbox != mailbox
+
+          if block_given?
+            mailbox_stack << @current_mailbox
+            result = block.arity == 1 ? block.call(mailbox) : block.call
+            mailbox_stack.pop
+            switch_to_mailbox(mailbox_stack.last)
+            return result
+          end
+
+          return mailbox
+        end
+      end
+      alias :in_mailbox :mailbox
+      alias :in_label :mailbox
+      alias :label :mailbox
+
+      # Alias for <tt>mailbox("INBOX")</tt>. See <tt>Gmail::Client#mailbox</tt>
+      # for details.
+      def inbox
+        mailbox("INBOX")
+      end
+
+      def mailboxes
+        @mailboxes ||= {}
+      end
+
+      def inspect
+        "#<Gmail::Client#{'0x%04x' % (object_id << 1)} (#{username}) #{'dis' if !logged_in?}connected>"
+      end
+
+      def fill_username(username)
+        username =~ /@/ ? username : "#{username}@gmail.com"
+      end
+
+      def mail_domain
+        username.split('@').last
+      end
+
+      private
+
+      def switch_to_mailbox(mailbox)
+        if mailbox
+          conn.select(mailbox.encoded_name)
+        end
+        @current_mailbox = mailbox
+      end
+
+      def mailbox_stack
+        @mailbox_stack ||= []
+      end
+
+      def smtp_settings
+        [:smtp, {
+          :address => GMAIL_SMTP_HOST,
+          :port => GMAIL_SMTP_PORT,
+          :domain => mail_domain,
+          :user_name => username,
+          :password => password,
+          :authentication => 'plain',
+          :enable_starttls_auto => true
+        }]
+      end
+    end # Base
+  end # Client
+end # Gmail